RCF-043 — Agent Routing Playbook 建立(Sub-Agent 並行化決策指南)
類型:SKILL
日期:2026-05-16
觸發條件:條件 4 — 新增 .claude/skills/agent-routing-playbook.md SKILL 文件(新增 SKILL)
相關文件:
.claude/skills/agent-routing-playbook.md(新建).claude/skills/週報.md(修改:新增並行化評估提示).claude/skills/系統驗證.md(修改:新增並行化評估提示)CLAUDE.md(修改:SKILL 表新增agent路由行)dev/tasks.md(修改:Router 入口原則任務 ⏸ → [ ] P3)
問題背景
Sub-Agent 並行化機制存在於 Claude Code Agent tool 原生架構,但從未被啟用——不是因為任務量不夠,而是因為沒有 Playbook:
- Claude 不知道「什麼情況可以 spawn」(WHEN 規則缺失)
- Claude 不知道「什麼情況不能 spawn」(WHEN NOT 規則缺失)
- Claude 不知道「怎麼寫 sub-agent prompt」(HOW 規則缺失)
- Sub-agent 失敗時,沒有降級機制(失敗處理缺失)
Tim 觀察到這個根因:「我認為不是因為還沒有多重任務發生,我們應該把這個架構起來,然後讓我或是你在執行任務的時候,可以更好的運用執行。」
當前高成本情境:
- 「給我週報」:10 系統逐一讀取(循序,浪費時間)
- 「系統驗證」:9 個 HTTP 確認(互不依賴,可並行)
- 「全系統盤點」:16 部門讀取(互不依賴,可並行)
考慮過的方案
| 方案 | 描述 | 優點 | 缺點 | 採用? |
|---|---|---|---|---|
| 方案 A | 獨立建立 agent-routing-playbook.md SKILL 文件(含 WHEN/WHEN NOT/HOW/失敗降級/Tim 觸發指南) |
規則集中管理、Claude 執行前可查閱、Tim 可說「用 agent 做」手動觸發 | 需要 Tim 主動查閱或在相關 SKILL 中埋入指引 | ✅ 採用(作為方案 C 核心) |
| 方案 B | 在現有高價值 SKILL(週報/系統驗證)中嵌入並行化評估提示 | 執行相關 SKILL 時自動觸發評估,無需 Tim 記憶新觸發詞 | 分散維護、規則更新需同步多個文件 | ✅ 採用(作為方案 C 補充) |
| 方案 C(最終採用) | 方案 A + 方案 B 結合:獨立 playbook(規則集中)+ 相關 SKILL 埋入提示(執行時自動評估) | 兩全:規則有單一真實來源 + 執行路徑自動觸發 | Overhead 實測數字尚未確認(首次 POC 後更新) | ✅ 採用 |
最終決策
採用方案 C(Option A + Option B 組合):
新建
agent-routing-playbook.md:包含 WHEN 三條件、WHEN NOT 規則、Tim 觸發指南、HOW 寫 prompt 四項必填、Prompt 範例(週報 Batch A)、失敗降級機制、現有高價值 SKILL 並行化方案表(週報/系統驗證/全系統盤點)修改
週報.md和系統驗證.md:各在文件開頭附近嵌入「並行化評估」提示,引導 Claude 在執行前查閱 playbook 評估是否適合 spawn更新
CLAUDE.mdSKILL 表:新增agent路由⏳ 行,Tim 可說「用 agent 做 [任務]」觸發
排除方案 C-level 平行架構(CPO/COO/CTO)的原因:N1/N2/N3 三個採用前提條件(穩定多任務流量 / POC 驗證 overhead / 建立 decision trace 機制)均未達,Playbook 是輕量版 Router,先啟用再評估是否需要全面 C-level 架構。
重要技術邊界說明:
- 「Sub-agent 唯讀」是 本總部的設計規則,不是 Agent tool 的技術約束
- Agent tool 技術上可執行寫入操作,但本總部明確規定:寫入類任務一律由父 session 執行,sub-agent 僅負責讀取與資料回傳
影響範圍
| 影響類型 | 具體項目 |
|---|---|
| 新增文件 | .claude/skills/agent-routing-playbook.md |
| 修改文件 | .claude/skills/週報.md(新增並行化評估提示 3 行) |
| 修改文件 | .claude/skills/系統驗證.md(新增並行化評估提示 3 行) |
| 修改文件 | CLAUDE.md SKILL 表(新增 agent路由 ⏳ 行) |
| 修改文件 | dev/tasks.md(Router 入口原則 L165:⏸ 暫緩 → [ ] P3 持續優化) |
| 影響的 SKILL | 給我週報、系統驗證(新增查閱 playbook 步驟) |
| 未觸發部門同步 | 本次無 HARD STOP 修改,不需同步部門 CLAUDE.md |
驗證方式
下次執行「給我週報」或「系統驗證」時:
- Claude 應在執行前查閱
agent-routing-playbook.md評估並行化可行性 - 若 WHEN 三條件成立(≥ 3 個獨立讀取任務 / > 5 次工具呼叫且全為讀取 / 結果可獨立合成),Claude 應主動建議或執行 sub-agent spawn
POC 驗證目標(首次 spawn 後):
- 記錄實際節省的工具呼叫輪數 vs spawn overhead
- 更新 playbook 的「高價值並行化 SKILL」表格,將 POC 狀態從 ⏳ 更新為實測結果
- 判斷 N1 是否達成(週報並行化節省 > spawn overhead 成本)
Tim 可說的觸發詞:
用 agent 做 [任務]:明確指示 Claude 評估並 spawn sub-agent給我週報/系統驗證+ Claude 自動評估