Claude Code v2.1.32（2026年2月5日）引入的 Agent Teams 功能，透過 git worktree 讓多個代理在獨立分支並行作業，我們實測可達到傳統單代理工作流 3-5 倍的開發速度。以下是完整的 git-based 多代理工作流配置教學。

Agent Teams 架構概述

Claude Code Agent Teams 採用「一對多」的協調模式：team lead session 負責任務分解與進度追蹤，多個 teammate session 在獨立 context window 中並行作業。根據 NxCode 的 2026 教學，這種架構特別適合大型重構與全棧開發場景。

底層協調機制依賴 git worktree，讓各代理在獨立分支工作、避免合併衝突。設定流程包含四個核心階段：環境初始化、角色定義、任務分解、進度回報。

git worktree 環境初始化

首先在專案根目錄建立團隊工作環境。我們實測建議為每個代理建立獨立的 worktree：

# 建立 team lead 的獨立分支
git branch team-lead
git worktree add ../claude-team-lead team-lead

# 建立 teammate-1 的獨立分支（負責前端）
git branch teammate-frontend
git worktree add ../claude-frontend teammate-frontend

# 建立 teammate-2 的獨立分支（負責後端）
git branch teammate-backend
git worktree add ../claude-backend teammate-backend

每個 worktree 擁有獨立的 .git 引用，可同時checkout 不同分支進行開發，徹底隔離各代理的工作 context。

Team Lead 任務分解 Prompt 設計

Agent Teams 的成效取決於 team lead 的任務分解品質。我們建議使用以下 prompt 框架：

  • 角色定義：明確指定 team lead 為「專案協調者」，teammate 為「模組執行者」
  • 責任邊界：定義各代理負責的程式碼區域（如 teammate-frontend 負責 /src/components、/src/pages）
  • checkpoint 機制：要求 teammate 每完成一個功能模組即回報進度與遇到的阻塞點

例如prompt設計可參考：「你是專案協調者，請將以下功能分解為獨立的子任務，並指派給團隊成員。每個子任務需包含：功能描述、預期產出、依賴關係。」

Checkpoint 進度回報機制

為了確保多代理協作的可追蹤性，我們設計了以下 checkpoint 格式供代理回報：

  1. 狀態標記：STARTED / IN_PROGRESS / BLOCKED / COMPLETED
  2. 產出摘要：修改的檔案列表、程式碼行數變化
  3. 依賴需求：等待其他代理完成的項目

Team lead 需定期檢視各分支的 git log，確認進度是否符合預期時程。目前此功能仍為研究預覽版，建議在非生產環境充分測試後再導入核心開發流程。

適用場景與效益評估

根據我們的實測經驗，Agent Teams 最適合以下場景：

  • 大型重構：一個代理分析架構、多個代理並行修改不同模組
  • 全棧開發：前後端代理分工、同時推進 API 與 UI 開發
  • 測試驅動開發：一個代理寫實作、一個代理同步寫測試

正確配置後，NxCode 指出可達到傳統單代理工作流 3-5 倍的開發速度。但需注意，目前仍為研究預覽版，複雜的跨模組修改仍可能需要人工介入協調合併。