docs(adr): 更新 ADR-006/009/015 狀態

ADR-015: 標記為「已實作」 (Phase 16 R1 完成)
ADR-009: 標記為「已實作」 (Phase 9.1-9.5 全部完成)
ADR-006: 新增智能路由整合章節 (Phase 13.3)

首席架構師 ADR 審計 P0/P1 完成

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
OG T
2026-03-26 10:45:29 +08:00
parent 648e100e3c
commit 8a163609bf
3 changed files with 116 additions and 11 deletions

View File

@@ -286,11 +286,84 @@ AI 用量監控面板應顯示:
---
---
## 智能路由整合 (Phase 13.3 - 2026-03-26)
> 參考: [ADR-016 智能路由](ADR-016-smart-routing.md)
Phase 13.3 引入**智能路由**機制,動態選擇最適合的模型:
### 路由決策流程
```
User Request
┌─────────────┐
│ Intent │ 分類意圖 (ALERT/QUERY/CODE_REVIEW/...)
│ Classifier │
└─────────────┘
┌─────────────┐
│ Complexity │ 評估複雜度 (1-5)
│ Scorer │
└─────────────┘
┌─────────────┐
│ AIRouter │ Intent + Complexity → Model Selection
└─────────────┘
├── Low (1-2) → Ollama llama3.2:3b
├── Medium (3) → Ollama qwen2.5:7b-instruct
└── High (4-5) → Gemini / Claude
```
### 意圖覆寫規則
| 意圖 | 強制模型 | 原因 |
|------|---------|------|
| CODE_REVIEW | qwen2.5:7b | 需要程式碼理解能力 |
| ALERT_TRIAGE (複雜) | Cloud | 多服務關聯分析 |
| QUERY | llama3.2:3b | 簡單查詢不需大模型 |
### 與原有 Fallback 整合
```
AIRouter 選擇模型
┌─────────────┐
│ Primary │ (依路由決策選擇)
│ Model │
└─────────────┘
│ 失敗
┌─────────────┐
│ Fallback │ ADR-006 原有順序
│ Chain │ Ollama → Gemini → Claude → Static
└─────────────┘
```
### 實作位置
```
apps/api/src/services/
├── intent_classifier.py # IntentClassifier
├── complexity_scorer.py # ComplexityScorer
└── ai_router.py # AIRouter
```
---
## 變更記錄
| 日期 | 版本 | 變更 | 作者 |
|------|------|------|------|
| 2026-03-20 | v1.0 | 初版建立 | CTO |
| 2026-03-26 | v1.1 | 新增智能路由整合章節 (Phase 13.3) | 首席架構師 |
---

View File

@@ -1,9 +1,10 @@
# ADR-009: OpenClaw Agent Teams 架構
**狀態**: 提議中 → 研究完成
**狀態**: **已實作**
**日期**: 2026-03-23
**實作完成**: 2026-03-24 (Phase 9.1-9.5 全部完成)
**決策者**: 統帥 + AI 架構師
**Phase**: 9.1-9.2 (SDK 研究 + 架構設計)
**Phase**: 9.1-9.5 (SDK 研究 → 完整實作)
## 背景
@@ -511,18 +512,32 @@ class OpenClawRouter:
return severity in ["P3", "P4"] and len(affected) <= 1
```
## 實作計劃 (更新版)
## 實作驗收 (2026-03-24)
| Phase | 內容 | 狀態 | 預估 |
| Phase | 內容 | 狀態 | 實際 |
|-------|------|------|------|
| 9.1 | ADR 審核 + SDK 研究 | ✅ 完成 | 0.5 天 |
| 9.2 | SDK 整合 + POC | 🔜 下一步 | 1 天 |
| 9.3 | 3 專家 Agent 實作 | | 2 天 |
| 9.4 | ConsensusEngine + leWOOOgo 整合 | | 1.5 天 |
| 9.5 | API 端點 + UI 呈現 | | 1.5 天 |
| 9.6 | 測試 + 文檔 + ADR-006 整合 | | 1 天 |
| 9.2 | SDK 整合 + POC | ✅ 完成 | 1 天 |
| 9.3 | 3 專家 Agent 實作 | ✅ 完成 | 1.5 天 |
| 9.4 | ConsensusEngine + leWOOOgo 整合 | ✅ 完成 | 1 天 |
| 9.5 | API 端點 + UI 呈現 | ✅ 完成 | 1 天 |
**總計: 7.5 天** (原估 10 天,因 SDK 簡化減少)
**總計: 5 天** (比預估提前完成)
### 實作檔案
```
apps/api/src/agents/
├── __init__.py
├── security_agent.py # SecurityAgent
├── blast_radius_agent.py # BlastRadiusAgent
├── action_planner_agent.py # ActionPlannerAgent
└── coordinator.py # OpenClawCoordinator
apps/api/src/services/
├── consensus_engine.py # ConsensusEngine
└── openclaw_team.py # OpenClawTeam 整合
```
### Phase 9.2 POC 驗證項目

View File

@@ -2,8 +2,9 @@
| 欄位 | 值 |
|------|-----|
| **狀態** | 已批准 |
| **狀態** | **已實作** |
| **決策日期** | 2026-03-26 |
| **實作完成** | 2026-03-26 (Phase 16 R1) |
| **決策者** | 統帥 + 首席架構師 |
| **觸發原因** | Code Review 發現嚴重模組化違規 |
@@ -132,6 +133,22 @@ async def call_tool(self, server_name: str, tool_name: str, parameters: dict):
---
## 實作驗收 (2026-03-26)
| 項目 | 狀態 |
|------|------|
| interfaces.py | ✅ 已建立 MCPToolProvider ABC |
| registry.py | ✅ 已建立 ProviderRegistry |
| k8s_provider.py | ✅ 已實作 |
| signoz_provider.py | ✅ 已實作 |
| database_provider.py | ✅ 已實作 |
| mcp_bridge.py 重構 | ✅ 透過 DI 注入 |
| 測試驗證 | ✅ 28/28 通過 |
**驗收人**: 首席架構師 (Phase 16 R1.3 審查)
---
## 相關文件
- [feedback_modular_architecture.md](../../memory/feedback_modular_architecture.md)