佈建系列 · 05 AI Agent 團隊
讓 Claude Code 從「一個全能助理」變成「一支分工的 AI 團隊」：架構師出計畫、後端寫碼、審查員挑錯、驗證員跑起來。企業版的關鍵是把團隊檔案化、提交進 repo，全公司用同一套——角色、權限、成本都統一。
Claude Code 有兩種多代理做法。企業要的是檔案化、可共享、可控成本的那種——subagents。
| Subagents（建議） | Agent Teams | |
|---|---|---|
| 狀態 | ✅ 穩定正式功能 | ⚠️ 實驗，預設關閉 |
| 定義方式 | .claude/agents/*.md（可進 git） | 執行時口語生成，存 session |
| 協作 | 各自做、結果回報主代理 | 隊友互相對話、共用任務清單 |
| 成本 | 低（摘要回來） | 高（每隊友獨立 context） |
| 企業共享 | ✅ 提交 repo / managed 強制 | ❌ 一 session 一團、不可跨 session |
一個 subagent 就是一個 Markdown 檔：YAML frontmatter 設定，下面的內文就是它的系統提示。Claude 靠description 自動判斷何時把任務交給它。
---
name: reviewer
description: 寫完功能後找他過一遍。專找正確性 bug、多租戶/RLS 隔離漏洞、安全問題與容錯缺口。只審查、不寫實作碼。
tools: Read, Grep, Glob, Bash
model: sonnet
---
你是除錯與程式碼審查員。檢視這次的 diff，專找：
- correctness bug 與沒處理的邊界情況
- RLS / 多租戶隔離漏洞、權限繞過
- 輸入驗證與容錯缺口
只挑錯與給建議，不要直接改實作碼。回報時每一項附上 file:line。Read, Grep, Glob, Bash，碰不到 Write/Edit，從根本上不會亂改碼。opus / sonnet / haiku / inherit——把便宜的雜務丟 haiku、難的架構交 opus，直接控成本。這是一套實戰用的開發團隊分工：每個角色一個 .claude/agents/*.md，模型與工具依職責配置——危險的事交給只讀的角色，貴的模型只用在最需要的地方。
| 角色 | 模型 | 工具 | 職責 |
|---|---|---|---|
| architect | opus | Read, Grep, Glob, Bash | 拆需求、出可執行計畫，不寫碼 |
| backend-builder | sonnet | Read, Write, Edit, Bash | 把計畫變成可跑的程式碼 |
| db-dev | sonnet | Read, Write, Edit, Bash | schema、RLS、查詢優化 |
| integration | sonnet | Read, Write, Edit, Bash | webhook、第三方 API、自動化串接 |
| reviewer | sonnet | Read, Grep, Glob, Bash | 挑 bug、安全與隔離漏洞，只審不改 |
| verifier | sonnet | Read, Grep, Glob, Bash | 實際跑起來、驗證行為符合預期 |
寫的角色給寫的工具、查的角色只給讀（reviewer/verifier 不給 Write/Edit，杜絕亂改）；模型按難度配（架構用 opus、雜務用 haiku）。這就是「權限最小化＋成本最佳化」的團隊。
當任務適合平行探索＋互相挑戰（多角度審查、競爭假設除錯）時，可開實驗性的 Agent Teams：隊友各自獨立、彼此對話、共用任務清單。預設關閉，要先開環境變數。
// ~/.claude/settings.json — Agent Teams 是實驗功能，預設關閉
{
"env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" }
}# 開啟後，用自然語言請主代理開隊友（適合平行研究/審查）
請開三個隊友平行審查 PR #142：一個看安全、一個看效能、一個看測試覆蓋，
各自審完互相挑戰彼此的發現，最後彙整給我。把工具變成戰力
Readie 幫台灣中小企業把 AI 從「裝好了」帶到「天天在用、人人一致」——不換系統、不買新軟體，從你們每天已經在用的工具與一台 Mac Mini 開始。
Readie AI 導入顧問 · 創辦人 Marco Liu · 19 年產業經驗