메뉴
本 repo 自持 agent 定義目錄索引（complexity-triage / doc-reviewer / doc-updater / tdd-guide），供 design、update 等 skill 的 general-purpose subagent 呼叫時引用定義與檢查清單；本身非直接可呼叫的 skill，不會出現在指令清單中。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
萬用助手 — 自動分析情境、盤點可用資源、智慧路由至最佳 agent/skill 組合，一鍵完成複雜工作流。
開發設計 — 自動盤點可用資源，透過 Plan agent 建立完整實作計畫，輸出至 plans/active/<slug>.md 供使用者確認後才進入實作。
更新知識庫 — 依序執行文件更新、審查、context 整理、pattern 提取，將本次 session 的變更沉澱為文件與知識。
貼上 Notion URL，自動抓取頁面需求內容，串接 /design 建立實作計畫。
產生跨 context 接手 prompt — 萃取本次對話的目標、進度、決策、未完成項目，輸出可直接貼到新 session 或 /compact 之後使用的自包含 prompt。
依 plan.md 的 Dependencies DAG 推進實作 — Python 狀態機決定下一步（非 LLM 判斷），自動串接 TaskCreate/TaskUpdate。觸發：使用者要求依 plan 推進、要求 task tracking 對齊 DAG、或抱怨 LLM 跳步漏步。
| name | agents |
| description | 本 repo 自持 agent 定義目錄索引（complexity-triage / doc-reviewer / doc-updater / tdd-guide），供 design、update 等 skill 的 general-purpose subagent 呼叫時引用定義與檢查清單；本身非直接可呼叫的 skill，不會出現在指令清單中。 |
| user-invocable | false |
本目錄存放本 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）一律只留一句指標過來，不重複內容。
呼叫方在派 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）。
一律經 general-purpose + 明確 prompt 引用定義檔內容執行，不直呼定義檔的 name 當 subagent_type：
Agent(subagent_type="general-purpose", model="sonnet") # model 取自定義檔 frontmatter（doc-reviewer/doc-updater/tdd-guide=sonnet、complexity-triage=haiku）
prompt 需包含：「依 agents/.md 的定義與檢查清單執行 <任務>」+ 呼叫方傳入的 context。例如審查計畫時：「依 agents/doc-reviewer.md 的定義與檢查清單執行審查」+ Step 3 產出的完整計畫內容。
撞名禁令：禁止 Agent(subagent_type="tdd-guide")、Agent(subagent_type="doc-updater") 這類直呼。 環境中存在同名的 ECC 遺留 agent type（tdd-guide、doc-updater 皆為 ECC plugin 曾註冊過的 agent 名稱），直呼會靜默載入舊的 ECC 定義而非本目錄的定義，且不會有任何錯誤或警告提示——這是本目錄從 ECC 解耦後最容易被繞過的一點，呼叫方必須明確走 general-purpose + 定義引用，不可貪圖簡潔改用 subagent_type=<name>。
subagent 回報完成後，呼叫方（主模型）對照定義檔的「輸出格式」章節逐項核對回報是否符合契約（例：doc-reviewer 的回報是否為逐項 PASS/FAIL 表格，而非摘要式印象分）。
git diff 逐條比對其宣稱的每一項變更——這類 agent 有編造修改記錄的前科，見 agents/doc-updater.md 的紅旗章節呼叫方引用 agents/*.md 時，實際路徑依執行環境而異：
repo checkout： agents/<name>.md
skills CLI 安裝環境： ~/.agents/skills/agents/<name>.md
找不到對應檔案時視為「agents/ 目錄不存在（安裝不完整）」：從 https://github.com/ashe-li/agent-skills 的 agents/<name>.md 取得，或請使用者重跑 npx skills update；/design Step 4a 等呼叫方文件內的 fallback 一律指回這一段，不各自重複。