多代理架構深度比較

kiro-team
vs
Claude Code Agent Teams

從 Hub-and-Spoke 到 Peer-to-Peer,兩大 AI 多代理框架的架構哲學、能力邊界與實戰選擇

Part 1

kiro-team

Hub-and-Spoke 架構 — Team Lead 作為中央協調者的多代理系統

架構設計:Hub-and-Spoke

Team Lead 中央協調者 Builder 建構者 Validator 驗證者 Documenter 文件撰寫 Sub-agent 可擴充 所有溝通必須經過 Team Lead

Hub-and-Spoke 模型 — 所有 sub-agent 只能透過 Team Lead 進行溝通

4 種角色 — 最小權限原則

👑

Team Lead

中央協調者
read subagent todo
🔨

Builder

建構者
read write shell

Validator

驗證者
read shell (readonly)
📝

Documenter

文件撰寫者
read write

三階段工作流程

Phase 1

📋 Plan

Team Lead 分析任務、拆分子任務、建立 todo list、分配給各 sub-agent

Phase 2

⚙️ Execute

Sub-agents 在 git worktree 隔離環境中並行執行(最多 4 個並行)

Phase 3

✨ Complete

Team Lead 合併結果、驗證輸出、整合 worktree 變更回主分支

.kiro/
├── agents/
│   ├── team-lead.md
│   ├── builder.md
│   ├── validator.md
│   └── documenter.md
├── prompts/
│   ├── plan.md
│   ├── execute.md
│   └── complete.md
└── scripts/
    ├── create-worktree.sh
    └── merge-worktree.sh

Sub-agents 無法使用以下工具:

todo grep glob web_search thinking

優缺點分析

優勢

  • 零依賴,純設定檔
  • 最小權限原則設計
  • Git worktree 隔離環境
  • 最多 4 個 sub-agent 並行

劣勢

  • Sub-agents 無法使用 grep/glob
  • 沒有共享任務看板
  • 早期階段(僅 4 commits)
  • 僅支援 Kiro CLI 平台
Part 2

Claude Code Agent Teams

真正的 Peer-to-Peer 協作 — TeammateTool 驅動的對等式多代理架構

Agent A 對等節點 Agent B 對等節點 Agent C 對等節點 Agent D 對等節點 Task Board 共享任務 所有 Agent 對等溝通 + 共享任務看板

Peer-to-Peer 模型 — 每個 Agent 都能直接溝通,共享 Task Board

發現故事

2025 年 12 月

被社群發現

有人用 strings 命令讀取 Claude Code 的二進位檔,發現了隱藏的 TeammateTool 功能

strings claude-code-binary | grep -i "teammate"
2026 年 1 月

社群補丁

社群開始修補、實驗,並分享使用心得與 workaround

2026 年 2 月

官方發布

隨 Opus 4.6 正式發布,成為 Anthropic 官方支援的功能

啟用方式

CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

切換隊友快捷鍵:Shift + ↓

13 種操作

團隊管理
1
spawnTeam

建立團隊

2
discoverTeams

探索團隊

3
disbandTeam

解散團隊

成員管理
4
requestJoin

請求加入

5
approveJoin

批准加入

6
rejectJoin

拒絕加入

7
leaveTeam

離開團隊

通訊
8
broadcastMessage

廣播訊息

9
sendMessage

點對點訊息

10
readMessages

讀取訊息

任務管理
11
updateTask

更新任務

12
claimTask

認領任務

13
共享 Task Board

所有 Agent 可讀寫

已知限制

不支援巢狀隊友

Teammate 無法再生成 Teammate

Session 恢復問題

中斷後可能無法完美恢復狀態

高 Token 消耗

多 Agent 通訊大幅增加 token 用量

實驗性質

功能持續演進中,API 可能變動

Part 3

比較分析

並排比較兩大多代理架構的核心差異

維度 kiro-team Agent Teams
平台Kiro CLI onlyClaude Code only
安裝複製資料夾一個環境變數
通訊模式僅透過 Team LeadPeer-to-Peer
共享任務看板僅 Team Lead所有 Agent
並行能力最多 4 個原生支援
Git Worktree內建腳本手動設定
官方支援社群 (MIT)Anthropic 官方
依賴零依賴零依賴(內建)
穩定度早期 (4 commits)實驗中,趨穩
🌐

kiro-team

Hub-and-Spoke 多代理框架

架構:Team Lead 作為中央控制器,所有 sub-agent 只能透過 Team Lead 溝通。這確保了清晰的指揮鏈和可預測的行為模式。

權限模型:嚴格的最小權限原則。Builder 能讀寫和使用 shell,Validator 只能讀取和 readonly shell,Documenter 只能讀寫。

隔離:每個 sub-agent 在獨立的 git worktree 中工作,完成後由 Team Lead 合併回主分支。

適合場景:Kiro CLI 使用者、需要嚴格權限控制的專案、偏好中央化管理的團隊。

🤝

Claude Code Agent Teams

Peer-to-Peer 協作框架

架構:真正的對等協作,沒有中央控制器。每個 Agent 都能直接與任何其他 Agent 溝通,透過共享的 Task Board 協調工作。

操作豐富度:13 種操作涵蓋團隊管理、成員管理、通訊和任務管理,提供完整的協作工具鏈。

整合度:作為 Claude Code 的內建功能,啟用只需一個環境變數。支援 Shift+↓ 快捷切換隊友。

適合場景:Claude Code 使用者、需要 Agent 間直接協作的複雜任務、偏好去中心化管理的工作流。

選擇指南

根據你的情境選擇最適合的多代理方案

1

使用 Kiro CLI + 需要快速多代理?

kiro-team
2

使用 Claude Code + 需要 Agent 間協調?

Agent Teams
3

使用 Claude Code + 任務獨立不需溝通?

Subagent
4

多平台 CLI(Kiro + Claude + Gemini)?

AWS CLI Orchestrator
5

需要完整客製化?

CrewAI / LangGraph

Subagent vs Agent Teams

理解兩種截然不同的協作模式

🧑‍🎓

Subagent

像派出一個實習生

單向溝通:派出去、回報結果
無法與其他 Agent 溝通
適合獨立、明確的子任務
低 token 消耗

「去把這份報告整理好,做完回來給我。」

👥

Agent Teams

像組成一個專案團隊

雙向溝通:對等協作
共享 Task Board,即時同步
適合需要協調的複雜任務
較高 token 消耗

「我們一起處理這個專案,隨時討論進度。」