團隊智能體協調 是做什麼的?
當智能體以團隊而非單一助手的方式管理時,使用此技能。目標是讓團隊協調變得可靠:清晰的工作項目、明確的所有權、智能體看板狀態、分支隔離、控制面板可視化以及合併閘門。
啟動時機
- 任務跨越多個智能體、工具、擴充套件、分支或工作樹。
- 使用者提及團隊協調、智能體看板、小隊、指揮者、控制面板、管理者、桌面應用程式、Zellij、tmux、Hermes、Devin、Codex、Claude Code 或多智能體工作。
- 專案需要在人員與智能體之間共享工作流程狀態。
- 現有的智能體分流產生輸出,但無法產出可合併的成品。
運作模式
將每個智能體視為具有狹義合約的團隊成員:
- 負責人:對工作項目負責的人員或智能體。
- 範圍:檔案、分支、工具表面以及禁止區域。
- 狀態:待辦、就緒、執行中、審查中、受阻、已合併或已封存。
- 證據:測試、螢幕截圖、日誌、審查筆記或評估報告。
- 合併閘門:允許整合的確切條件。
智能體看板
當工作需要跨階段可視化時,使用智能體看板。
| 欄位 | 意義 | 退出標準 |
|---|---|---|
| 待辦 | 候選工作項目,尚未成形 | 驗收標準已撰寫 |
| 就緒 | 已成形且可指派 | 已指派負責人與分支/工作樹 |
| 執行中 | 智能體正在積極工作 | 交接工件與已變更的檔案存在 |
| 審查中 | 工作已完成但尚未合併 | 測試、差異審查與風險檢查通過 |
| 受阻 | 需要外部輸入或閘門失敗 | 阻塞原因有負責人與下一步行動 |
| 已合併 | 已整合進入主線 | PR 已合併或本地 main 已更新 |
| 已封存 | 不再相關 | 已記錄原因 |
每張卡片應符合此結構:
{
"id": "agent-card-001",
"title": "建立動態工作流程技能",
"owner": "codex",
"state": "running",
"branch": "product/dynamic-workflow-team-orchestration",
"worktree": ".",
"acceptance": [
"技能存在",
"測試涵蓋所需概念",
"內容工件包含影片與文章觀點"
],
"merge_gate": "lint、聚焦測試與目錄檢查通過",
"handoff": "path/to/handoff.md"
}
團隊協調流程
- 形塑看板:將模糊的願景轉化為具有負責人與合併閘門的工作項目。
- 選擇執行模式:單一智能體、動態工作流程模式、dmux/tmux、工作樹分流或外部桌面協調器。
- 指派邊界:每張卡片一個負責人、明確的檔案範圍,且若無整合者則不重疊寫入。
- 執行智能體:每個智能體記錄證據與交接筆記,不僅僅是程式碼。
- 依序審查:先測試,再差異審查,然後安全/風險檢查,最後內容/產品打磨。
- 審慎合併:一位整合者解決衝突,並更新控制面板或狀態工件。
- 提取可重複使用的技能:若卡片模式重複出現,將其提升至
skills/。
控制面板需求
一個實用的團隊協調控制面板應顯示:
- 活躍的工作項目及其智能體看板狀態。
- 負責人、擴充套件、分支、工作樹與最後心跳。
- 交接工件、測試、螢幕截圖與 PR 的連結。
- 按負責人與解除阻塞行動分組的阻塞項目。
- 按閘門(而不是感覺)顯示的合併就緒狀態。
- 應成為共享技能的可重複使用工作流程候選。
在操作者能夠回答以下問題之前,不要增加更多自動化:誰擁有這個、什麼改變了、哪個閘門失敗了、什麼可以安全合併?
動態工作流程相容性
當卡片需要動態工作流程模式時:
- 將任務區域性的擴充套件置於卡片負責人之下。
- 將輸入與輸出儲存在卡片上。
- 在從執行中移至審查中之前,需要進行評估。
- 僅在重複使用後,才將擴充套件提升為共享技能。
需留意的失敗模式
- 智能體混亂:多個智能體同時執行,沒有負責人或合併閘門。
- 看不見的工作:有用的輸出僅存在於聊天記錄中。
- 看板表面功夫:看板存在,但卡片沒有驗收標準。
- 重疊寫入:並行智能體未使用工作樹就編輯相同檔案。
- 無產品工件:流程產出文件,但沒有可執行或可發佈的表面。
輸出標準
每次協調結束時應產出:
- 看板/卡片變更。
- 已合併或待處理的分支。
- 測試與評估證據。
- 帶有負責人與下一步行動的阻塞項目。
- 新的共享技能候選。