Agent skill

decision-tree-helper

決策樹助手工具。快速評估任務複雜度，提供派發建議。Use when: (1) 任務複雜度快速評估, (2) 派發代理人建議, (3) 拆分策略建議, (4) 並行可行性評估

View SKILL.md on GitHub Repository
Stars 1
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/tarrragon/claude/tree/main/skills/decision-tree-helper

SKILL.md

決策樹助手工具

核心功能

快速評估任務，提供派發和拆分建議。引用 /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：派發建議

根據任務類型和複雜度，提供派發建議。詳細派發決策樹見 references/dispatch-decision-tree.md。

派發決策（第零層明確性檢查）

二元判斷順序：

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

注意：決策樹最高優先為「Skill 匹配層」（已註冊 Skill 觸發條件匹配），其次為「第負一層」並行化評估，再進入第零層明確性檢查。完整派發決策樹見 .claude/rules/core/decision-tree.md（v7.0.0，含第八層 Commit-Evaluate-Handoff 循環）。

代理人選擇指南

系統級代理人

代理人 觸發條件 優先級
incident-responder 錯誤/失敗 最高
system-analyst 新功能/架構變更 高
security-reviewer 安全相關 高
system-designer UI 規範需求 中
system-engineer 環境/編譯問題 中

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 測試全過

拆分策略指南

本工具提供快速評估；詳細拆分策略見 references/splitting-strategies.md。

快速決策

  • 按架構層：跨多層時，由底層向上拆分
  • 按功能模組：涉及多模組時，共用模組先完成，獨立可並行
  • 按操作類型：混合重命名/邏輯修改時，機械操作可並行，邏輯需序列

並行派發判斷

快速檢查清單

  • 任務間無檔案重疊
  • 任務間無邏輯依賴
  • 任務在同一架構層級
  • 操作類型為機械性（重命名/格式化）
  • 並行派發後執行 git diff --stat 驗證實際變更

並行適用情境

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

不適用並行情境

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

使用方式

任務評估

通過 /decision-tree-helper assess "{任務描述}" 快速評估：

  1. 任務類型識別
  2. 複雜度評估
  3. 派發建議
  4. 拆分建議（如需要）

派發確認

通過 /decision-tree-helper confirm {代理人} "{任務描述}" 確認派發：

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

並行檢查

通過 /decision-tree-helper check-parallel {Ticket1} {Ticket2} 檢查並行可行性：

  1. 並行安全性
  2. 潛在衝突
  3. 建議執行順序

相關文件

  • 決策樹助手決策記錄格式
  • 拆分策略詳細指南
  • 派發決策樹完整版
  • 認知負擔量化標準
  • 主線程決策樹
  • 任務拆分指南

Last Updated: 2026-03-02 Version: 2.0.0

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

tarrragon/claude

skill-design-guide

Use this skill when creating a new skill, updating an existing skill's YAML frontmatter, or reviewing skill quality. Provides the official Anthropic skill specification, frontmatter rules, description writing best practices, progressive disclosure architecture, and common pitfalls to avoid. Triggers include: creating skills, skill review, frontmatter validation, SKILL.md writing.

1 0
Explore
tarrragon/claude

test-async-guardian

Flutter/Dart 測試異步資源管理守護者。用於：(1) 診斷測試卡住問題，(2) 審查測試程式碼中的異步資源清理，(3) 提供 tearDown 最佳實踐，(4) 掃描潛在的資源洩漏風險。觸發場景：測試卡住、撰寫新測試、Code Review 測試程式碼、執行 flutter test 前自動掃描。

1 0
Explore
tarrragon/claude

agent-team

Agent Teams 協作派發指南。Use when: (1) Agent A 的發現會改變 Agent B 正在進行的工作, (2) 用戶要求使用 team/swarm, (3) 多代理人需即時協商共用介面或 API 契約。涵蓋 team 建立、Ticket-Task 橋接、teammate 入職、生命週期管理。

1 0
Explore
tarrragon/claude

tdd

TDD 全流程指導工具。Use for: (1) 開始新功能的 TDD 流程（Phase 0-4）, (2) 推進到下一個 TDD 階段, (3) Phase 1 SOLID 原則驅動功能拆分分析, (4) 查看當前 TDD 進度和階段狀態, (5) 評估是否需要 Phase 4 重構以及 3b 拆分評估。Use when: 開始新功能開發、進入任何 TDD Phase、需要 SOLID 拆分指導、需要確認當前所在 TDD 階段、需要做 Phase 4 豁免判斷時。

1 0
Explore
tarrragon/claude

branch-worktree-guardian

Branch Worktree Guardian - Git 分支和 Worktree 管理工具。Use for: (1) 新開發需求時建立隔離分支, (2) 使用 worktree 機制避免分支衝突, (3) 驗證當前工作分支正確性, (4) 預防在錯誤分支上開發

1 0
Explore
tarrragon/claude

design-decision-framework

多方案評估決策框架。用於面臨 3+ 技術方案時的結構化評估、架構決策時的系統化分析，防止衝動決策和技術債務累積。Use for: 技術方案選擇、重大架構決策、高風險技術選型

1 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results