majiayu000 決策樹助手工具
核心功能
快速評估任務，提供派發和拆分建議。引用 /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 | {目標} | {代理人} | {順序} |
相關文件
- 認知負擔量化標準
- 主線程決策樹
- 代理人職責矩陣
- 任務拆分指南
Last Updated: 2026-01-28 Version: 1.1.0