# ADR-080: AI 自主化飛輪總綱

> **日期**: 2026-04-15（台北）
> **狀態**: 🔵 草稿（待統帥批准後開工）
> **作者**: Claude Sonnet 4.6（首席架構師）+ 統帥 audit
> **相關**:
> - MASTER 藍圖：`docs/superpowers/specs/2026-04-15-MASTER-ai-autonomous-flywheel-v2.md`
> - 廢棄 v1：`docs/superpowers/plans/2026-04-15-MASTER-ai-autonomous-flywheel.md`
> - ADR-070 AI 自主修復全自動化迴圈（前置背景）
> - ADR-073 飛輪完整稽查（診斷根因）

---

## 背景

### 現況診斷（2026-04-15 深層掃描）

2026-04-15 對整個 AWOOOI AIOps 系統進行深層診斷，確認以下根本性缺陷：

| 指標 | 現況 | 目標 |
|-----|-----|-----|
| MCP 呼叫次數/24h | **0** | > 0 |
| Playbook trust_score | **全 0.3（靜態）** | 動態 EWMA 更新 |
| 學習閉環觸發率 | **0%（fire-and-forget）** | ≥ 99% |
| 告警分類 general 比例 | **41%** | < 10% |
| 修復動作 RESTART 比例 | **68%** | < 40% |
| 自動執行成功次數/24h | **0** | > 0 |

**根本診斷**：代碼地基在 / 流程骨架在 / **AI 智能靈魂不在**。
過去 3 個月所有修復（bypass / 黑名單 / 重啟兜底）都是在骨架上貼膏藥，沒有朝 AI 自主化方向推進。

### 驅動力

統帥反覆強調（不下 5 次）：

> 「我不要任何寫死的規則，要往 AI 化方向走。每次執行結果都必須回寫讓系統更聰明。」

---

## 決策

### 採用 7 Phase 結構性改造，Single Source of Truth MASTER MD

**廢棄**一切「先寫死、先 hardcode、先兜底」的臨時修復思路。

**確立**四大自主化北極星：

| 目標 | 定義 |
|-----|-----|
| **自主學習** | 每次執行回寫 Playbook trust / KM embedding，下次決策更聰明 |
| **自主修復** | AI 透過 MCP 主動抓情報推理動作，不依賴硬編規則 |
| **自主告警** | 分類/嚴重度/聚合/路由全部 AI 動態決策 |
| **自主通知** | 收件人/通道/時機/話術由 AI 根據情境判斷 |

### 7 Phase 實施序列

```
Phase 0 防護欄建立        → Feature Flag 框架 + 基線快照 + HARD_RULES 更新
Phase 1 感官縱深          → PreDecisionInvestigator + EvidenceSnapshot + PostExecutionVerifier
Phase 2 多 Agent 協作      → 5 角色（Diagnostician/Solver/Reviewer/Critic/Coordinator）
Phase 3 學習機制重建       → 3 根因修復 + Evolver + Fine-tune pipeline（最關鍵）
Phase 4 異常偵測源頭升級   → Holt-Winters + Drain3 + Prophet + 主動巡檢
Phase 5 修復抽象化        → Declarative + Blast Radius 四級分控 + GitOps PR
Phase 6 自我治理閉環       → SLO + Trust Drift + KB Rot + 離線回放 + 自我降級
```

### 防失憶四道閘門

為防止跨 session 方向漂移，確立：

1. **閘門 1**：`CLAUDE.md` 強制讀 MASTER（Session 啟動第一步）
2. **閘門 2**：`project_master_aiops_blueprint.md` 跨 session 狀態指針
3. **閘門 3**：MASTER `§0 Session Resume Protocol`（接手 Claude 必讀 7 步驟）
4. **閘門 4**：MASTER `§8 Living Changelog`（只追加，記錄每次變更）

### 架構師評審框架（強制）

| Gate | 觸發點 | 審查項目 |
|------|-------|---------|
| Gate 0 | Phase 0 完成 | Feature Flag 結構 / ADR-080 完整性 |
| Gate 1 | Phase 1 完成 | 感官架構邊界 / Prompt Injection 防護 / EvidenceSnapshot schema |
| Gate 2 | Phase 2 完成 | Agent 接口設計 / 熔斷覆蓋 / Redis Streams 隔離 |
| Gate 3 | Phase 3 完成 | 學習閉環三根因 / EWMA 正確性 / fire-and-forget 已消滅 |
| Gate 4 | Phase 4 完成 | 動態基線準確性 / Drain3 整合 / 靜態 rules 減量驗證 |
| Gate 5 | Phase 5 完成 | Blast Radius 分級正確 / dry-run 強制 / GitOps PR 流程 |
| Gate 6 | Phase 6 完成 | SLO 計算準確 / 自我降級不得反向升級 / KB rot 月清可用 |

---

## 影響

### 新增檔案（跨所有 Phase）

| Phase | 關鍵新增 |
|-------|---------|
| P0 | `core/feature_flags.py`, `jobs/baseline_snapshot.py` |
| P1 | `services/pre_decision_investigator.py`, `services/evidence_snapshot.py`, `services/post_execution_verifier.py`, `services/mcp_tool_registry.py`, `services/sanitization_service.py` |
| P2 | `agents/diagnostician_agent.py`, `agents/solver_agent.py`, `agents/reviewer_agent.py`, `agents/critic_agent.py`, `agents/coordinator_agent.py`, `services/agent_orchestrator.py` |
| P3 | `services/playbook_evolver.py`, `services/finetune_exporter.py`, `jobs/knowledge_decay_job.py`, `jobs/detection_feedback_writer.py` |
| P4 | `services/dynamic_baseline_service.py`, `services/log_anomaly_detector.py`, `services/trend_predictor.py`, `services/proactive_inspector.py` |
| P5 | `services/blast_radius_calculator.py`, `services/declarative_remediation.py`, `services/gitops_pr_service.py`, `services/rollback_manager.py` |
| P6 | `services/ai_slo_calculator.py`, `services/trust_drift_detector.py`, `services/model_rollback_service.py`, `jobs/offline_replay_service.py`, `jobs/kb_rot_cleaner.py` |

### 修改核心檔案

- `services/decision_manager.py` — 廢棄 25 條硬規則；輸入改 EvidenceSnapshot；輸出改 DeclarativeSpec
- `services/approval_execution.py` — 修復 fire-and-forget（~line 471）；接線 PostExecutionVerifier
- `services/learning_service.py` — 填充 matched_playbook_id；三段快照；負向 2x EWMA
- `services/incident_service.py:classify_alert_early()` — 輸入改 EvidenceSnapshot

### DB 新增表

`incident_evidence` / `agent_sessions` / `playbook_trust_history` / `detection_feedback` /
`anomaly_baselines` / `anomaly_detections` / `forecasts` / `playbook_declarative_stats` /
`ai_governance_events` / `model_checkpoints`

---

## 替代方案（已拒絕）

| 方案 | 拒絕理由 |
|-----|---------|
| 繼續修補規則引擎 | 治標不治本；規則永遠趕不上告警多樣性 |
| 只加 LLM 分類 | 沒有 MCP 情報 → LLM 還是只能猜 RESTART |
| 先 hardcode 過渡 | 統帥明確禁止；技術債會鎖死 AI 化路徑 |
| 分多份 MD 分別追蹤 | 碎片化導致失憶；Single Source of Truth 不可妥協 |

---

## 退出條件（Phase 0 完成標準）

- [ ] `apps/api/src/core/feature_flags.py` 已建立，`AIOPS_P1~P6_ENABLED` 全 `False`
- [ ] `apps/api/src/jobs/baseline_snapshot.py` 已建立，可執行一次拍攝基線
- [ ] `docs/HARD_RULES.md` 已更新至 v1.9（加入 Phase 退出條件鐵律）
- [ ] 本 ADR 已 commit
- [ ] 現有測試全通（`pytest apps/api/tests/` 綠燈）

---

## 參考

- MASTER 藍圖 v2：`docs/superpowers/specs/2026-04-15-MASTER-ai-autonomous-flywheel-v2.md`
- 北極星鐵律：`~/.claude/projects/-Users-ogt-awoooi/memory/feedback_ai_autonomous_direction.md`
- 感官縱深（D1）：MASTER §3.1
- 多 Agent（D2）：MASTER §3.2
- 修復抽象（D3）：MASTER §3.3
- 學習深度（D4）：MASTER §3.4
- 異常偵測（D5）：MASTER §3.5
- 自我治理（D6）：MASTER §3.6
