📚職涯停看聽・知識庫← 總部儀表板
📅最後更新:2026/05/15
📑 目錄

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 組合):

  1. 新建 agent-routing-playbook.md:包含 WHEN 三條件、WHEN NOT 規則、Tim 觸發指南、HOW 寫 prompt 四項必填、Prompt 範例(週報 Batch A)、失敗降級機制、現有高價值 SKILL 並行化方案表(週報/系統驗證/全系統盤點)

  2. 修改 週報.md系統驗證.md:各在文件開頭附近嵌入「並行化評估」提示,引導 Claude 在執行前查閱 playbook 評估是否適合 spawn

  3. 更新 CLAUDE.md SKILL 表:新增 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 自動評估
← 返回 決策記錄