生活分享

Claude Code|Agent Teams 的分工、阻塞與成果整合

比較單代理、專責代理與團隊協作成本。Agent Teams 可以讓多個 Claude 工作階段分工,但建立更多角色不一定更快。本篇以待辦篩選為同一個目標,先記錄單代理基準,再分派兩個不重疊的責任,練習處理阻塞、需求變動與最後整合,並把協調時間算進結果。

閱讀時間約 7 分鐘

LINE 分享
Agent Teams 的分工、阻塞與成果整合:文件、螢幕與完成記號的幾何插圖
圖片:Mokaair (© Mokaair)
本篇目錄
  1. 1. 先確認功能與版本
  2. 2. 建立單代理基準
  3. 3. 分配兩個明確責任
  4. 4. 模擬阻塞,而不是讓所有人重做
  5. 5. 整合前檢查實際檔案
  6. 6. 記錄成本與正常結束
  7. 7. 為整合者保留最後決定權與證據
  8. 8. 不支援 Teams 時的替代與完成判準

Agent Teams 可以讓多個 Claude 工作階段分工,但建立更多角色不一定更快。本篇以待辦篩選為同一個目標,先記錄單代理基準,再分派兩個不重疊的責任,練習處理阻塞、需求變動與最後整合,並把協調時間算進結果。

先讀、及。下載第 89 篇材料,使用獨立 starter。需要 Node.js 22、Git 與支援該實驗功能的 Claude CLI;閱讀約 20 分鐘,實作約 75 分鐘。

先確認功能與版本

先確認功能與版本 → 建立單代理基準 → 分配兩個明確責任
先確認功能與版本 → 建立單代理基準 → 分配兩個明確責任 · 圖片:Mokaair (© Mokaair)
閱讀完整文字說明

Agent Teams 的分工、阻塞與成果整合,以流程和文件圖形呈現教學重點。

官方文件查證時,Agent Teams 仍屬實驗功能,預設關閉。文件也說明較新版本已調整團隊建立與結束方式,不應直接照舊教學呼叫已不存在的 TeamCreate 或 TeamDelete。先記錄 claude --version,再依當前官方說明啟用並觀察實際提供的工具。

本篇在新終端機的程序環境啟用實驗旗標,避免永久改動所有專案。組織政策或帳號條件仍可能限制功能;旗標不是繞過管理設定的方式。看不到支援時,先做 Worktree 替代實驗,報告明確寫 Teams 未實測。

PowerShell:只在本次終端機設定 · powershell
$env:CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = '1'
claude
macOS/Linux 終端機:只對這次啟動生效 · bash
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude

啟動後確認實際功能狀態,不以環境變數存在就算團隊已開始。官方文件說明這個模式需要互動式工作階段;claude -p 或 Agent SDK 即使設定相同旗標,仍只建立普通 subagent。較新版本在互動模式使用具名 Agent 啟動隊友,再以訊息與任務清單協調。不要把模型對自己架構的口頭判斷當證據,應核對實際工具事件、隊友回覆及後續訊息是否仍送到同一隊友。

建立單代理基準

先在另一份乾淨 starter,用單一工作階段完成 fixtures/issue.json 的三種篩選需求。記錄開始到驗收結束的總時間、重試、改動檔案與測試結果。不要只量模型產生第一份程式碼的時間,因為整合、修正與瀏覽器操作也屬於完成工作。

基準應使用與團隊實驗相同的需求、材料和成功判準。若單代理只寫資料函式,團隊卻還完成 UI,就不能直接比較總時間。也不要把第一次摸索環境的安裝時間只算到其中一組;測量範圍必須一致並事先說明。

完成後保存基準成果,不把它直接交給團隊當答案。團隊版本使用新解壓縮的同一材料起點,保留相同 fixture 與測試。這樣比較的是工作方式,而不是誰先看過完成版。

分配兩個明確責任

資料角色負責 filter.js 與 tests/filter.test.mjs,定義 all、active、completed 並保留原始資料;畫面角色負責 index.html、app.js、style.css,依約定介面接按鈕與顯示狀態。主工作階段負責界面契約、需求變更與最後驗收。

先把函式名稱、和回傳形狀寫到 task-contract.md,讓畫面角色可以依契約工作。若兩位都需要修改 package.json,指定單一負責者或由主工作階段處理,不讓共用檔成為隱藏的衝突來源。材料的 agents/team-task.md 可作分工表起點。

Claude Code 對話框:支援 Teams 時才執行 · text
請以兩位隊友完成 fixtures/issue.json,先確認功能與工具可用。
資料隊友只改 filter.js 與 tests/filter.test.mjs。
畫面隊友只改 index.html、app.js、style.css,依 task-contract.md 串接。
你負責契約、阻塞協調與最後整合;不新增其他隊友。
任何跨出檔案範圍的需求先回報,不直接修改。
不推送、不建立 PR、不部署。

觀察真實任務分配與角色訊息,確認每個人知道輸入、交付和限制。不要把兩個普通終端機同時執行 Claude 就稱為已驗證 Agent Teams;它們可以是有效替代方案,但機制與證據應分開命名。

模擬阻塞,而不是讓所有人重做

刻意讓畫面角色需要確認未知 mode 的行為:應顯示錯誤還是回到全部。要求它先回報阻塞,保留已完成的部分,不自行改資料契約。主工作階段確認決策後,只通知受影響角色更新,避免整組重新開始。

再模擬一個小需求改動,例如按鈕文字改為「所有待辦」,而資料 mode 仍是 all。畫面角色更新文案,資料角色不必改 enum。這能檢查團隊是否把顯示文字與資料契約混用,也能觀察訊息是否傳到真正需要的人。

紀錄等待原因、收到回覆時間與恢復後的工作。若某位隊友停住,先讀它的最後狀態和缺少資訊,不立刻新增另一位重做相同檔案。角色越多可能讓寫入衝突更難追查,並不自然解決阻塞。

整合前檢查實際檔案

每位角色完成時,回報修改檔案、實際測試命令、未完成項目與可能影響。主工作階段核對 diff,確認沒有超出範圍的改動,也沒有引用只存在於另一個工作目錄的檔案。角色說完成是交接訊號,最終檔案才是整合對象。

若使用 Worktree 隔離,還需要合併分支並處理衝突。若共用同一工作目錄,沒有 Git 合併衝突也不代表沒有互相覆蓋,應檢查最終差異與測試。埠號、暫存檔及外部服務不會因 Git 分支不同就自動隔離。

整合後的專案終端機 · text
node --test tests/model.test.mjs tests/filter.test.mjs
git diff --check
git diff --stat

接著啟動網站,用新增、切換完成、三種篩選與刪除走完主要路徑。資料函式測試通過,但 UI 匯入拼錯仍可能失敗;因此整合驗收要在最終工作目錄進行。不要沿用某位隊友在另一個版本上跑過的測試當最後證明。

記錄成本與正常結束

完成後比較單代理與團隊的總耗時、重試、整合問題和實際可取得的用量。只有可觀察數據才填入,沒有 token 或成本資料時標為未知,不估一個漂亮百分比。小任務可能因協調成本而更慢,這也是有用結果。

請主工作階段確認各隊友已結束或完成交接,再正常退出本次練習。依版本確認工作階段與相關終端機狀態,不手動刪除未知的全域團隊資料。若使用自己建立的 Worktree,只有乾淨且已整合的工作目錄才移除。

比較項目單代理團隊判讀重點
驗收完成總時間實測填入實測填入含整合與修正
重試與失敗全部保留全部保留不只挑最佳結果
檔案衝突實際觀察實際觀察與責任分配連結
用量可取得才填可取得才填未知不當成零

為整合者保留最後決定權與證據

將子任務分配出去之後,整合者仍要確認需求是否完整覆蓋。每位成員完成自己的檔案,不能直接推定整個功能可以運作;接口、資料格式與使用者流程需要在最後組合上重新檢查。讓每位成員回報修改檔案、執行命令及尚未處理的項目,整合時才有可比較的依據。

若兩位成員都需要修改同一個檔案,先重新劃分責任或改成依序處理。平行工作帶來的時間節省,必須扣除溝通和衝突處理時間;小到只有一處修改的任務通常不值得強行拆成。

不支援 Teams 時的替代與完成判準

替代練習可以用兩個 Worktree,由讀者手動傳遞契約和結果,再完成同一整合測試。這能驗證分工與隔離方法,但報告應寫 Worktree 替代流程,Teams 互動仍待測。不要因最終網站能用,就填寫未實際使用的產品功能通過。

交付任務表、單代理基準、阻塞與需求變更紀錄、整合成果和成本觀察。小練習是把本來都改 app.js 的兩個角色重新拆分,說明如何減少重疊,再跑同一案例比較。後續可用整理長期結果,選擇適合任務的工作方式。

覺得這篇整理實用嗎?分享給需要的朋友

LINE 分享

回總目錄

  • 生活分享

    Claude Code|建立第一個 mod:在 Claude Code 行程內數工具呼叫

    寫一個三檔案的 mod,用驗證器與測試確認它掛上的事件。文件把 mod 定義成多了入口檔的 plugin:入口檔叫 hooks module,Claude Code 在事件發生時呼叫裡面的函式,函式可以觀察、改寫或接手事件。

  • 生活分享

    Claude Code|Git Worktree 平行工作

    隔離多個任務的檔案與分支。Git Worktree 讓同一儲存庫擁有多個工作目錄,各自使用分支與檔案。本篇會把待辦篩選與文件整理分開,確認兩個 session 不會直接改到彼此的檔案,再把其中一個成果整合回主分支。你也會知道何時可以安全清理工作目錄。

  • 生活分享

    Claude Code|雙 Worktree 實作與衝突整合

    隔離兩項功能,最後完成整合與回歸。兩個 Claude 工作階段同時編輯專案,最容易出現的問題是互相改到同一份檔案,或各自測試通過、整合後卻失敗。本篇用兩個 Worktree 分別處理篩選預設值與介面文字,故意製造一次小衝突,再完成整合、驗證與清理。你不需要先啟用 Agent Teams。

資料來源

本文依據上方所列參考來源與標示之核對日期整理;票價、時刻、功能規格或服務條款可能變動,出發、預訂或購買前請至相關官方網站確認最新資訊。

生活分享