決策樹助手工具

核心功能

快速評估任務，提供派發和拆分建議。引用 /cognitive-load 的量化標準。

快速評估流程

Step 1：任務識別

## 任務類型識別

| 類型 | 識別關鍵字 | 下一步 |
|------|-----------|--------|
| 錯誤/失敗 | "failed", "error", "bug" | 強制派發 incident-responder |
| 新功能 | "實作", "建立", "新增" | SA 前置審查 |
| 修改 | "修改", "更新", "調整" | 複雜度評估 |
| 查詢 | "查詢", "進度", "狀態" | 直接回應 |

Step 2：複雜度快速評估

回答以下問題（每題 0-2 分）：

| 問題 | 0 分 | 1 分 | 2 分 | |------|------|------|------| | 需要修改幾個檔案？ | 1-2 | 3-4 | 5+ | | 跨越幾個架構層？ | 1 | 2 | 3+ | | 依賴幾個模組？ | 0-1 | 2-3 | 4+ | | 需要追蹤幾個狀態？ | 1-3 | 4-5 | 6+ |

總分解讀：

| 總分 | 複雜度 | 建議 | |------|--------|------| | 0-2 | 低 | 直接派發單一代理人 | | 3-5 | 中 | 謹慎評估，考慮拆分 | | 6-8 | 高 | 必須拆分後再派發 |

Step 3：派發建議

根據任務類型和複雜度，提供派發建議。

派發決策樹（二元結構）

對應主線程決策樹 v3.0.0 的二元化結構

任務進入
    |
    v
包含錯誤關鍵字? ─是→ [強制] incident-responder
    |
    └─否→ 包含不確定性詞彙? ─是→ [確認機制] 向用戶確認
              |
              └─否→ 複雜需求（觸發 3+ 代理人）? ─是→ [確認機制]
                        |
                        └─否→ 是問題? ─是→ 是查詢類? ─是→ 執行查詢命令
                                    |           |
                                    |           └─否→ 派發諮詢代理人
                                    |
                                    └─否→ 是開發命令? ─是→ [驗證 Ticket]
                                              |              └→ TDD 階段派發
                                              |
                                              └─否→ 是除錯命令? ─是→ incident-responder
                                                        |
                                                        └─否→ 其他處理

二元判斷順序（第零層）

| 順序 | 判斷問題 | 是 | 否 | |------|---------|----|----| | 1 | 包含錯誤關鍵字？ | → 事件回應流程 | → 下一判斷 | | 2 | 包含不確定性詞彙？ | → 確認機制 | → 下一判斷 | | 3 | 複雜需求（3+ 代理人）？ | → 確認機制 | → 進入第一層 |

代理人選擇指南

系統級代理人

| 代理人 | 觸發條件 | 優先級 | |--------|---------|--------| | incident-responder | 錯誤/失敗 | 最高 | | clove-security-reviewer | 安全相關 | 高 | | saffron-system-analyst | 新功能/架構變更 | 高 | | star-anise-system-designer | UI 規範需求 | 中 | | sumac-system-engineer | 環境/編譯問題 | 中 | | sassafras-data-administrator | 資料設計需求 | 中 |

TDD 階段代理人

| 階段 | 代理人 | 前置條件 | |------|--------|---------| | Phase 1 | lavender-interface-designer | SA 審查通過 | | Phase 2 | sage-test-architect | Phase 1 完成 | | Phase 3a | pepper-test-implementer | Phase 2 完成 | | Phase 3b | parsley-flutter-developer | Phase 3a 完成 | | Phase 4 | cinnamon-refactor-owl | Phase 3b 測試全過 |

拆分策略指南

按架構層拆分

任務跨越多層
    |
    +-- UI 層修改 --> Ticket A (parsley)
    +-- Controller 層修改 --> Ticket B (parsley)
    +-- Domain 層修改 --> Ticket C (parsley)

執行順序：C --> B --> A（由底層向上）

按功能模組拆分

任務涉及多模組
    |
    +-- 模組 A 修改 --> Ticket A (可並行)
    +-- 模組 B 修改 --> Ticket B (可並行)
    +-- 共用模組修改 --> Ticket C (先執行)

執行順序：C 先完成，A/B 可並行

按操作類型拆分

任務包含多種操作
    |
    +-- 重命名操作 --> Ticket A (可大量並行)
    +-- 格式化操作 --> Ticket B (可大量並行)
    +-- 邏輯修改 --> Ticket C (需謹慎序列)

並行派發判斷

快速檢查清單

[ ] 任務間無檔案重疊
[ ] 任務間無邏輯依賴
[ ] 任務在同一架構層級
[ ] 操作類型為機械性（重命名/格式化）

並行適用情境

| 情境 | 範例 | 並行數量 | |------|------|---------| | 同層重命名 | 所有 Repository 檔案變數重命名 | 無上限 | | 同層格式化 | 所有 Widget 檔案 lint fix | 無上限 | | 獨立模組 | 各獨立 Feature 的相同修改 | 無上限 | | 無依賴測試 | 各模組的獨立單元測試 | 無上限 |

不適用並行情境

| 情境 | 原因 | 處理方式 | |------|------|---------| | TDD 跨階段 | 階段有順序依賴 | 序列執行 | | 跨架構層 | 可能有設計影響 | 序列執行 | | 有共享狀態 | 競爭條件風險 | 序列執行 | | 邏輯依賴 | 結果影響後續 | 按依賴序列 |

使用方式

任務評估

/decision-helper assess "{任務描述}"

輸出：

任務類型
複雜度評估
派發建議
拆分建議（如需要）

派發確認

/decision-helper confirm {代理人} "{任務描述}"

輸出：

派發是否合適
潛在問題
替代建議（如有）

並行檢查

/decision-helper check-parallel {Ticket1} {Ticket2} ...

輸出：

並行安全性
潛在衝突
建議執行順序

決策記錄格式

標準格式

## 決策記錄

### 任務資訊
- **任務描述**: {描述}
- **任務類型**: {類型}

### 複雜度評估
| 指標 | 數值 | 等級 |
|------|------|------|
| 修改檔案數 | {數} | {等級} |
| 架構層級數 | {數} | {等級} |
| 依賴模組數 | {數} | {等級} |
| 狀態追蹤數 | {數} | {等級} |
| **總分** | {分} | **{等級}** |

### 派發決策
- **建議代理人**: {代理人}
- **決策理由**: {理由}

### 拆分建議（如需要）
| 子任務 | 目標 | 代理人 | 順序 |
|--------|------|--------|------|
| 1 | {目標} | {代理人} | {順序} |