agents
Installation
SKILL.md
agents/ — 自持 Agent 定義目錄
本目錄存放本 repo 自持的 agent 定義（一 agent 一檔，ECC 式架構：frontmatter name/description/tools/model + 輸入防禦基線 / 職責 / 流程 / 輸出格式 / 判準或檢查清單 / 紅旗）。不依賴 everything-claude-code (ECC) plugin，供 design/SKILL.md、update/SKILL.md 等呼叫方在啟動 general-purpose subagent 時引用其定義。本文件是這份索引與呼叫慣例的唯一權威版本，其他文件（README、design/SKILL.md、update/SKILL.md）一律只留一句指標過來，不重複內容。
Step 1 — Problem：選定義檔
呼叫方在派 subagent 前，先依任務類型從下表選出對應定義檔：
| 定義檔 | 用途 | 何時用 | 被誰引用 |
|---|---|---|---|
complexity-triage.md |
任務複雜度分診（low/medium/multi-session） | 進入完整規劃儀式前，先粗估影響面決定走快速路徑或完整流程 | /design Step 2a |
doc-reviewer.md |
計畫／文件審查，逐項 PASS/FAIL 找碴 | Plan agent 產出計畫後、或文件更新完成後，需要隔離 context 找碴而非背書 | /design Step 4a、/update Step 2 |
doc-updater.md |
文件同步（README/docs/CODEMAPS），輸出變更 Manifest | 程式碼變更後需同步文件，且需要主模型事後逐條驗證 | /update Step 1 |
tdd-guide.md |
TDD 紅－綠－重構引導，80% 覆蓋率門檻 | 新功能或修 bug 前缺測試覆蓋，需要先寫失敗測試再實作 | /design Step 1 資源盤點列出、Step 3 計畫步驟視需要引用 |
選錯定義檔的常見徵兆：把「審查」誤派成「更新」（doc-reviewer 只讀不寫，doc-updater 才會 Edit 檔案）、把「分診」誤派成「審查」（complexity-triage 只做影響面粗估，不做逐項 PASS/FAIL）。