Multi-Agent Workflow • Handoff • Feedback Loop

Agent Teams。
真正的技術團隊,已腳本化。

AgentsRoom Teams 像真正的工程團隊一樣串聯您的 AI 編碼代理。Fullstack Dev 交付功能,QA Engineer 驗證,PM 簽收。每個角色都已腳本化,工作流程是視覺化的,每次交接都攜帶功能摘要、diff、風險和測試提示。再也不用讓一個代理把所有事情都做得一塌糊塗。

在視覺化畫布上組建你理想中的 AI 開發團隊,就像搭一個 n8n 工作流程。條件連線、反饋迴圈、並行審查分支、機器驗證的品質門、迴圈上限。儲存一次,在每張工單上執行,看你的代理像資深工程師一樣交接接力棒。

AgentsRoom Teams:視覺化多代理工作流程編輯器、Claude Code 代理間的自動交接、Dev to QA 反饋迴圈、基於 MCP 的代理間通訊。

Agent Teams 是 AgentsRoom 對 AI 編碼代理一個殘酷真相的回答:試圖做所有事的單一代理最終把所有事都做得一塌糊塗。同時編碼、測試、審查、部署還要寫規格的 Fullstack 代理在中途會忘掉一半的指令。正確答案,全世界每一個嚴肅的軟體團隊都在用的,是把工作拆分成角色。Developer 寫程式碼。QA Engineer 驗證。Product Manager 簽收。Security Reviewer 審計。每個角色都有自己的上下文、自己的焦點、自己的工具。

這正是 Agent Teams 給 AgentsRoom 帶來的。您在無限畫布(基於 React Flow 建置,與 n8n、Make、Retool 和 Pipedream 同樣的引擎)上放置節點,每個節點是一個執行 Claude、Codex、GitHub Copilot CLI、Cursor 或 AgentsRoom 支援的另外 10 個代理 CLI、並分配給特定角色的代理,您把它們連線起來。在 backlog 中的工單上執行該團隊,或綁定到任何新的代理 spawn。AgentsRoom 編排整個鏈:spawn 第一個代理,等待交接,總結工作,以該總結作為入站上下文 spawn 下一個代理,重複直到團隊到達終止節點。

其他工具試圖用一個超級代理和聰明的提示來完成這件事。我們試過了,超過三步就不工作了。角色漂移,上下文丟失,代理忘了它要驗證什麼。Agent Teams 把代理當作真正的隊友來對待:每個代理都獲得一個乾淨的會話、聚焦的系統提示、結構化的交接 payload,以及一個共享草稿板用於和其他代理對話。這才是您真正想要的 AI 工程團隊工作流程。

AgentsRoom Agent Teams 視覺化工作流程編輯器:Dev、QA、PM、Security 和 DevOps 角色的節點在帶條件邊和反饋迴圈的無限畫布上連線

AgentsRoom Teams 編輯器:為每個角色放置節點、連線、新增條件、儲存團隊、在任何工單上執行。

真正可擴展的多代理編排

畫布上的每個節點都是一個代理。您選擇它的角色(Fullstack、Frontend、Backend、QA、Security、DevOps、PM、Architect、Mobile、Marketing、Git、SEO、Localization,或您已建立的任何自定義角色)、它的模型(Opus、Sonnet、Haiku、GPT-5、o3、Antigravity Pro 等)、它的交接模式(透過 Stop hook 自動,或透過按鈕手動),以及幾行步驟特定指令。就這樣。沒有提示工程儀式,沒有要寫的 YAML 設定檔。

邊連線節點。一條簡單的邊意味著:當第一個代理完成它的步驟時,交接給下一個。一條條件邊攜帶一個標誌檢查,例如 qaPassed equals true。QA 代理在它的交接 payload 中設定該標誌,runner 選擇匹配的邊。這就是您建置反饋迴圈的方式:QA 完成,qaPassed equals false,邊將工單連同測試提示和風險一起送回 Dev。Dev 修復後再次交接。迴圈直到 QA 透過或 max-cycles 守衛觸發。

代理間通訊在設計上就是健壯的。AgentsRoom 提供專用 MCP 伺服器(agentsroom-team),為執行中的每個代理提供一組工具:讀取團隊上下文、讀取共享 NOTES.md 草稿板、為隊友發布筆記、向另一個角色傳送問題、讀取收件箱、讀取時間線、讀取相對執行基線的 git diff、用結構化 payload 完成步驟。這些工具會在每一輪重新注入到 Claude 會話中,所以它們能在上下文壓縮中存活。即使在 /compact 或 /clear 之後,代理仍然看得到它的團隊工具。

在此之上,UserPromptSubmit hook 在每條使用者訊息前提醒代理來自隊友的任何新筆記。工作區中的 NOTES.md 檔案是僅追加的,能在崩潰、重啟和機器重啟後存活。伺服器端校驗的交接 payload 模式防止代理用空或垃圾 payload 交接。這是大多數多代理 demo 悄悄跳過的部分,也是它們大多數在第 3 個迴圈就崩潰的原因。

執行 AI 工程團隊所需的一切

視覺化工作流程、真正的交接、真正的反饋迴圈、真正的代理間通訊。設計目的就是讓您用一次 Slack ping 而不是五十次來交付一個功能。

視覺化工作流程畫布

由 React Flow 驅動的無限可縮放畫布,與 n8n、Retool、Pipedream 和 Make 背後的引擎相同。放置節點、連線、儲存團隊。無需程式碼,無需 YAML。

14 個內建代理角色

Fullstack、Frontend、Backend、DevOps、QA、Security、PM、Architect、Mobile、Marketing、Git Expert、SEO、i18n、Brainstormer。再加上您已經在專案上儲存的任何自定義角色。

每節點的模型和提示

每個節點選擇自己的供應商、模型和步驟指令。Architect 用 Opus,QA 用 Haiku,重型後端用 Codex,便宜的前端用 Antigravity。自由組合。

自動交接

當代理呼叫 team_complete_step 時,AgentsRoom 建置交接 payload(功能摘要、變更檔案、風險、測試提示、標誌),並以該 payload 作為起始上下文 spawn 下一個節點。

手動交接選項

想要驗證每一步?把節點切換到手動模式。代理等待,您對結果滿意時點選 'Hand off'。兩全其美。

條件邊

每條連線可以帶一個標誌判斷,也可以帶多個,用 AND 或 OR 組合。QA 透過就交給 PM,評審失敗就退回 Dev,評審和分析同時失敗就停下來交給人。當兩條連線同時匹配時,條件最多的那條勝出。

反饋迴圈

Dev 到 QA,再回到 Dev,再回到 QA。當 QA 把工單打回時,系統會複用原來的 Dev 代理,並保留上一輪的完整記憶,所以它真的會把這個迴歸問題修掉,而不是從頭再來。

機器驗證的品質門

在節點上固定一條檢查命令 (npm test、lint、build)。代理宣告完成時 runner 執行它:退出碼 0 把路由標誌設為 true, 其他值設為 false。實測結果永遠覆蓋代理的自我報告。

唯讀審查節點

在節點上開啟一個開關, 該代理就不能再編輯、提交或推送: 它唯讀取 diff、執行測試, 然後給出結論。審查者永遠不會去修復自己正在審查的東西, 兩條審查分支也不會再因為寫入同一個修復而衝突。Claude、Codex、Grok、Antigravity、OpenCode 均由 CLI 自身強制執行, 在官方模板的審查節點上預設開啟。

並行審查分支

從一個節點畫出兩條無條件連線,兩個目標同時執行: QA 和 Security 並排審查同一份 diff, 然後匯合節點合併雙方報告。只要有一條分支亮紅,大門就保持關閉。

先問人,再繼續

Await 節點是暫停,不是結束: 執行停下來,把您寫在節點上的問題拋給您,您一回答,它就自己重新開始,並把答案交給下一步。卡住的代理會路由到它,而不是直接結束執行,通知也會送到您的手機上。

按步驟固定技能

把 Skills Library 的條目掛到節點上。代理在開始該步驟前先載入它們:你的審查清單或部署手冊在每次執行都被執行,而不是等代理想起來。

Max-cycles 守衛

可配置上限(預設 3)。避免無限的 QA-rejects-Dev 迴圈。達到上限時,執行在 awaiting-finalization 暫停,由您決定下一步。

執行挺得過重啟

執行中途關掉應用再開啟,執行會回到它停下的步驟。狀態、筆記和時間線都在磁碟上; 編排器會接著幹活,而不是留下一個殭屍。

團隊庫同步到帳戶

全域團隊與你的帳戶同步,跨機器跟隨你; 專案團隊隨 room 移動。兩者都保留離線快取,離線所做的修改在重新連線時回放。

共享 NOTES.md 草稿板

執行中的每個代理都讀寫工作區中的一個 markdown 檔案。能在壓縮、崩潰、重啟中存活。是團隊推理的唯一真相來源。

角色對角色收件箱

需要讓 QA 在執行中向 Architect 提問?team_ask 把訊息發布到角色的收件箱。該角色的下一個代理讀取並回復。代理之間的真實聊天,只持續這一次執行:比它活得更久的常駐收件箱,就是代理之間的訊息傳遞。

基於 MCP 的代理間通訊

所有團隊工具透過 MCP 伺服器暴露。工具能在 Claude 上下文壓縮中存活(Anthropic 每一輪都重新傳送)。對 /clear、/compact 和長迴圈具有韌性。

Haiku 驅動的交接摘要

如果代理不寫自己的功能摘要,會用一個小 Haiku 呼叫從 git diff 生成。便宜、快速,下一個代理總是帶著上下文落地。

Browser MCP 傳播

帶 verifyInBrowser 的團隊節點會自動把它的代理切換到瀏覽器訪問模式。QA 節點帶著完整的瀏覽器工具(navigate、click、type、screenshot、get logs)落地。

每次執行的臨時代理

每次團隊執行都 spawn 全新的代理,並在 dismiss 時銷燬。您的專案代理列表保持乾淨。團隊是工作流程,代理是執行時。

全域和專案團隊

把可重用的團隊儲存到全域庫(~/.agentsroom/teams)或固定到特定專案(與 room 一起提交)。同樣的編輯器,不同的範圍。

內建四個團隊模板

先建置再驗證、先規格再建置再驗證、捉蟲行動 (復現、修復、證明), 以及 QA 與 Security 並行的發布護盾。複製、編輯、執行。30 秒即可上手。

執行時間線 UI

每次交接以一張卡片出現在執行時間線上:哪個角色剛完成、摘要說了什麼、哪些檔案變更、哪些標誌被設定。可審計,可回放。

在任何 backlog 工單上執行

把工單拖到一個團隊上,鏈就在該工單上啟動。第一個代理讀取工單標題和正文,團隊的其餘成員從那裡接過去。

14 個專業角色,準備就緒可連線

每個角色都有自己的系統提示、關注領域和示例任務。在畫布上自由組合。隨時新增您自己的自定義角色。

Fullstack
End-to-end implementation
Frontend
UI, components, design tokens
Backend
API, database, performance
DevOps
CI/CD, infra, deployment
QA
Tests, edge cases, regression
Security
Audit, OWASP, secrets, auth
Architect
System design, refactor
PM
Specs, priorities, scope
Mobile
iOS, Android, React Native
Marketing
Copy, landing, SEO
Git Expert
Branches, rebase, history
SEO
Rankings, structured data
Localization
i18n, l10n, 14 languages
Custom
Bring your own role

為什麼真正的團隊勝過一個超級代理

多代理編排聽起來像個 buzzword。這裡是您真正會交付的功能上的實際差別。

場景:為電商網站新增 Stripe checkout 流程

獨行的超級代理

  • 讀取工單。在 API、React 表單、webhook、遷移和測試中寫了 600 行。
  • 在 webhook 上忘了 idempotency key。忘了測試失敗路徑。忘了 staging env var。
  • 說 '完成'。您花兩小時在生產中找 bug。

Agent Team(Dev to Security to QA)

  • Fullstack 代理交付實現,提交,帶著摘要和標記 auth 變更的風險列表交接。
  • Security 代理讀取 diff,審計 webhook 簽名檢查,在交接 payload 中為 QA 寫測試提示。
  • QA 代理在嵌入式瀏覽器中執行測試提示,命中一個 idempotency bug,設定 qaPassed equals false,把工單連同精確復現送回 Dev。
  • Dev 修復,再次交接。QA 透過。PM 收尾。執行進入 done。

同樣的工單,同樣的模型,同樣的專案。不同的工作形態。團隊方式抓到了獨行代理漏掉的東西,因為每個角色都有聚焦的簡報和結構化的交接。

執行同一支團隊的兩種方式

圖譜決定誰做什麼,模式決定這些角色由誰來扮演,而模式在你搭建團隊時就選定。一種保住上下文,另一種保住獨立性。沒有哪個版本能兩者兼得,所以這個取捨要你自己按團隊來定。

一個代理,全部角色

接力模式

整支團隊由一個會話跑完。它先扮演第一個角色,把工作交出去,然後變成下一個角色,始終在同一個主控台裡,一次都不重啟。兩個角色之間不需要做摘要,因為它們之間什麼都沒丟。

你得到什麼
你得到什麼: 完整的連續性。QA 角色本來就知道 Dev 角色為什麼那樣決定,連推理過程都清楚,所以沒人需要把二十分鐘前定下的決定再講一遍。
代價是什麼
代價是什麼: 說到底這是一個代理在換帽子。寫程式碼的會話就是審查這段程式碼的會話,而自審總比一雙新眼睛看漏得多。

當流水線裡連續性比第二意見更重要時選它:重構、遷移,以及那種上下文就是工作本身的長週期功能。

Agent Morphing 如何運作

每個角色一個代理,邊幹邊聊

團隊模式

每個角色都有自己的會話,而且同時活著。它們邊幹活邊互相寫訊息:測試告訴前端開發什麼壞了,前端開發問後端開發 payload 到底長什麼樣。還沒有人搭話的隊友,會在有人寫給它的那一刻啟動。

你得到什麼
你得到什麼: 貨真價實的第二意見。審查程式碼的從來沒寫過這段程式碼,而中途加入的隊友是從中立地讀一遍 diff 開始,而不是從自己寫它時的記憶開始。
代價是什麼
代價是什麼: 上下文是買來的,不是繼承來的。中途加入的隊友要讀共享筆記和 diff 才能跟上,這要花掉接力模式從不需要花的 token 和時間。

當你希望審查貨真價實,就選它:一次安全走查、一場設計評審、一輪抓蟲,凡是出問題都出在直接給上一步蓋章放行、而不去真正核查的場合。

代理間訊息如何運作

自由對話,還是照著圖譜走

團隊模式還有第二個開關,因為只能單向說話的團隊,不過是多繞了幾步的佇列。保持關閉,隊友就只寫給自己節點指向的那些角色:圖譜依然是約定,當一道關卡不允許被繞過時,這正是你要的。

開啟它,任何人都能寫給任何人,方向不限,也能一次寫給好幾個。測試在同一條訊息裡同時告知設計師和後端開發;後端開發直接回應設計師,而不必繞回負責人那裡。圖譜依然負責啟動這次執行,也依然負責結束它,只是不再決定誰有資格開口。

信任靠測量,不靠宣稱

一個自己批改自己作業的代理,遲早會給自己打及格。Agent Teams 用兩套機制讓流水線保持誠實。

退出碼說了算

任何節點都可以宣告一條檢查命令: npm test、lint、build, 只要能返回退出碼。代理呼叫 team_complete_step 時, runner 在工作區執行命令,並把實測結果寫進路由標誌。綠了,執行繼續前進。紅了,失敗輸出連同真實的 stderr 落到下一個代理上下文的最頂端。測試套件紅著卻聲稱全部透過的代理,會被紅色的套件路由,而不是被它的聲稱路由。

四隻眼睛,同時上陣

把節點展開成並行分支: QA 走一遍流程, Security 同時審計 diff, 各自在自己的代理裡,看不到對方的結論。匯合節點等齊所有分支,合併摘要、風險與標誌,再按合併結果路由。布林衝突按設計解析為 false: 一個不透過的審查者就足以按住發布。

Dev → [ QA ∥ Security ] → Release gate

團隊執行的工作方式

01

開啟 Teams 標籤

在專案檢視中, Teams 標籤列出四個內建模板 (先建置再驗證、先規格再建置再驗證、捉蟲行動、發布護盾), 以及你已儲存的團隊。複製一個模板,或點選 'New team'。

02

在畫布上建置工作流程

在 React Flow 畫布上放置代理節點。對每個節點,選擇角色(Fullstack、QA、Security、PM 等)、供應商、模型和幾行步驟指令。用邊連線。如果需要分支,在邊上新增條件。

Dev → QA → PM
03

為每個節點設定交接模式

自動交接:代理工作完成時呼叫 team_complete_step,runner 接管。手動交接:代理等待您點選 'Hand off'。按需混合兩者。

04

執行團隊

從 backlog 工單點選 'Run with team'。從空的代理槽點選 'Create as team'。第一個節點作為臨時代理在專案工作區中 spawn。

05

觀看交接發生

代理 N 完成後, AgentsRoom 組裝交接 payload (由代理或 Haiku 生成的摘要、git diff、風險、測試提示、標誌), 向 NOTES.md 追加一條筆記,按標誌挑選正確的出邊,並把該 payload 作為輸入上下文交給代理 N+1。如果節點宣告瞭檢查命令, runner 會先執行它:決定路由標誌的是實測退出碼,而不是代理的說法。

06

迴圈、結束、收尾

反饋迴圈重新進入原始代理(保留完整記憶)。Await 節點會把執行停在一個留給您的問題上,您一回答它就立刻重新開始。終止節點觸發 awaiting-finalization 並通知您,手機也會收到。您點選 'Finish run':代理被銷燬,PTY 被釋放,發起這次執行的待辦工單也隨之關閉。

在任何情況下都能存活的代理間通訊

大多數多代理 demo 跳過的細節。這就是 Agent Teams 在長時間執行和多個迴圈中保持穩定的原因。

Claude Code 代理有上下文視窗並會壓縮它。多代理系統的經典錯誤是只把團隊協調放在系統提示裡。兩輪 /compact 之後,代理就完全不知道自己在團隊中。AgentsRoom 不這麼做。

所有團隊協調存在於三個能在壓縮中存活的地方。第一,MCP 伺服器(agentsroom-team)暴露工具(team_get_context、team_read_notes、team_post_note、team_read_inbox、team_ask、team_read_timeline、team_read_diff、team_complete_step)。MCP 工具被 CLI 在每一輪重新傳送給 Claude,所以它們對上下文壓縮免疫。

第二,UserPromptSubmit hook 在每條使用者訊息前執行,如果該角色有新筆記或新收件箱訊息,會前置一個小提醒。無事時便宜,有事時關鍵。

第三,NOTES.md 和 state.json 存在工作區的磁碟上。代理可以隨時用一個簡單的 Read 或用 team_read_notes 重新讀取。能在崩潰、重啟、/clear、/compact 和機器重啟中存活。系統提示永遠不是真相來源,磁碟和 MCP 工具才是。

執行之外

團隊收件箱隨執行結束。專案名冊不會。

上面這一切都限定在一次執行裡:角色是圖裡的節點,收件箱屬於這次執行,執行一結束兩者都消失。對於一條你要重放的流水線,這是對的形狀;對於一個代理下週二想問另一個代理的問題,這是錯的形狀。

代理之間的訊息傳遞是另一層。專案裡已儲存的代理是常駐成員,擁有自己的地址和自己的收件箱,它們在任意 CLI 上按名字互相寫信,而一條訊息能扛過重啟、崩潰,以及傳送時正好離線的代理。Agent Teams 什麼都沒有被拿走:常駐成員可以發起一次執行,執行裡的節點也絕不會被提升為常駐成員。

檢視代理之間的訊息傳遞
沒有你也照跑

一次執行不一定要從你的點選開始。

團隊是觸發器可以指向的兩種東西之一,另一種是單個代理。定時觸發時,它按日曆節奏發動,或者跟著你 AI 訂閱的配額週期;Webhook 觸發時,它在 GitHub、GitLab、Slack、Linear、Sentry 或你的 CI 發來事件時發動。你的提示詞會送到團隊的第一步,流水線在你自己的機器上自行跑完,開始時你會收到和平常一樣的通知。

邊界很簡單:觸發器決定一次執行「什麼時候」開始,並把事件交給它,真正在跑的仍然是團隊。其餘的一切都沒變,同樣的交接載荷,同樣的條件邊,同樣的反饋迴圈,事後回看的還是同一條時間線。

檢視觸發器:定時與 Webhook

人們用 Agent Teams 建置什麼

Dev to QA 管道

經典款。Fullstack 交付功能。QA 在嵌入式瀏覽器中驗證,執行測試提示,簽收。兩節點團隊,在 backlog 的每個工單上執行。

帶反饋迴圈的 Dev to QA

和上面一樣,但有一條條件邊:qaPassed equals false 把工單連同測試提示送回 Dev。最多 3 個迴圈。在到達人類審查者之前抓住迴歸。

Dev to Security to QA

適用於觸及 auth、payments 或 PII 的功能。Security 代理審查 diff,標記風險,為 QA 寫測試提示。被出貨 fintech、healthtech 和 B2B SaaS 的團隊使用。

PM to Architect to Dev

規格優先工作流程。PM 代理把工單轉成結構化規格。Architect 選擇方案。Dev 實現。三個角色,乾淨分離,可追溯決策。

Frontend、Backend、DevOps fan-out

全棧功能的順序拆分。Frontend 交付 UI。Backend 交付 API。DevOps 新增基礎設施配置。每個角色在自己的領域工作,用乾淨的 diff 交接。

Marketing to SEO to i18n

是的,AgentsRoom Teams 不只是為程式碼服務。Marketing 寫落地頁文案。SEO 注入關鍵詞。Localization 翻譯成 14 種語言。一個團隊,一個工單,一次出貨。

發布護盾: QA 與 Security 並行

一個 dev 節點分出並排執行的 QA 和 Security, 然後由發布門合併兩份報告。作為模板隨應用附帶。任一分支報告問題,整個護盾就退回 Dev。

捉蟲行動:先復現再修復

QA 代理復現缺陷並寫下精確步驟。dev 修復根因。第二個 QA 重放同樣的步驟來證明修復。'在我機器上是好的' 就此終結。

與其他多代理方法的比較

多代理編排是一個擁擠的 buzzword。這裡是實際在出貨的東西,以及 AgentsRoom Teams 適合在哪裡。

Anthropic Subagents(Task 工具,.claude/agents)讓單一 Claude 會話委託給專門的輔助代理。對內聯委託很好,但父會話仍然是協調者,是一個單一上下文。AgentsRoom Teams 高了一個層級:每個團隊節點是一個獨立的頂層 Claude 會話,有自己的視窗、自己的狀態、自己的 scrollback。CrewAI、AutoGen 和 LangGraph 是多代理流的優秀 Python 框架,但它們生活在您的 IDE 之外,不會在您的本地儲存庫上端到端地執行真正的 Claude Code、Codex 或 Antigravity CLI。n8n、Make、Pipedream 和 Retool 提供我們使用的同類畫布編輯器,但它們是通用自動化平台,並非為 AI 編碼代理而建。AgentsRoom Teams 是畫布風格的多代理工作流程編輯器,但專門連線到您的 CLI 代理、您的專案、您的 git、您的終端和您的瀏覽器。

Claude subagentsTask toolCrewAIAutoGenLangGraphn8nMakePipedreamRetoolTemporalAirflowPrefectDagster

如果您在 Python 中建置 agentic 系統,請繼續在生產管道中使用 CrewAI 或 LangGraph。如果您用 Claude、Codex、GitHub Copilot CLI、Cursor 或 AgentsRoom 支援的另外 10 個代理 CLI 出貨程式碼,Agent Teams 就是在您實際編碼的地方執行的團隊工作流程。

FAQ

這與 Claude Code subagents(Task 工具,.claude/agents)有什麼不同?

Claude subagents 是來自單一父 Claude 會話的內聯委託。父決定何時呼叫 subagent,subagent 在隔離的上下文視窗中執行,返回結果,父繼續。AgentsRoom Teams 高了一個層級:每個節點是一個頂層的 Claude Code 會話,有自己的終端、自己的狀態和自己的 scrollback。您能在每個標籤裡即時看到每個代理執行,能隨時和任何一個對話,能暫停團隊,更改工作流程並恢復。它不是 Claude subagents 的替代品,您完全可以同時使用兩者。一個團隊節點可以在內部使用 subagents。

這只在 Claude Code 上有效嗎?

它在 AgentsRoom 支援的全部 14 個代理 CLI(Claude Code、Codex CLI、GitHub Copilot CLI、Cursor 以及另外 10 個)上都有效。每個團隊節點選擇自己的供應商和模型。基於 MCP 的團隊協調工具在所有供應商間表現一致,因為它們透過標準 Model Context Protocol 暴露。如果適合您的預算和延遲,您可以讓一個團隊在重型後端節點上用 Codex,在 QA 節點上用 Haiku。

什麼是交接 payload?

一個從一個代理傳到下一個的結構化物件。欄位:featureSummary(剛交付內容的簡短描述)、changedFiles(git diff name-status)、touchedAreas(UI、API、DB、config)、risks(下一個代理應該擔心的事)、testHints(QA 的優先順序)、flags(條件邊使用的 boolean,如 qaPassed)。代理用此 payload 呼叫 team_complete_step,runner 在伺服器端校驗,下一個代理把它當作起始上下文接收。

代理真的能來回跑嗎(Dev to QA to Dev)?

是的。當一個節點被重新進入時(cycle 大於 1),AgentsRoom 不會 spawn 新代理。它重用 cycle 1 的原始代理,把新交接 payload 直接寫入它現有的終端,代理保留前幾個迴圈的完整 Claude 會話記憶。這至關重要:一個已經知道 QA 上次標記什麼的 Dev 代理會修復 bug。一個沒有記憶的全新 Dev 代理只會重複同樣的錯誤。

如果 QA 永遠拒絕 Dev 怎麼辦?

團隊配置有一個 max-cycles 守衛,預設 3。達到上限時,執行以 'blocked' 狀態暫停並等您。您可以收尾執行、再手動交接一次,或全部取消。無無限迴圈,無意外的過夜帳單。

所有團隊代理共享同一個 git 工作區嗎?

是的。團隊在單一工作區和單一分支(或如果您使用 AgentsRoom Worktrees 功能則使用 worktree)中執行。每個代理透過 git 看到上一個代理的工作。交接 payload 包含相對執行基線的 git diff,所以下一個代理精確地知道什麼是新的。

這需要額外訂閱嗎?

不需要。Teams 是 AgentsRoom 的一部分。您帶著自己的供應商金鑰(Claude、Codex、GitHub Copilot CLI、Cursor 以及另外 10 個代理 CLI),只為您使用的 token 付費,與單一代理一樣。在小工單上執行 Dev to QA 團隊的成本通常和執行單一 Fullstack 代理相同,因為 QA 步驟上的 Haiku/Sonnet 很便宜。

團隊儲存在哪裡?會提交到 git 嗎?

專案團隊與 room 同在,同步到你的帳戶並快取於 {project}/.agentsroom/teams-cache.json (已加入 gitignore)。全域團隊同樣同步到你的帳戶:團隊庫跨機器跟隨你, ~/.agentsroom/teams/ 是離線快取。內建模板保留在本地:每台機器用自己的語言安裝它們。

如果代理崩潰或應用在執行中重啟會怎樣?

執行狀態持久化在磁碟上的 {workspace}/.agentsroom/team-runs/{runId}/ (state.json、NOTES.md、inbox/、timeline.jsonl), 寫入是原子的,筆記只增不改。被打斷的執行會在應用重啟後恢復:編排器重新進入當時的步驟,重開終端,代理從筆記和團隊工具裡找回上下文。團隊定義已被刪除的執行會自動關閉,而不是永遠掛著。

我能在不同工單上並行執行多個團隊嗎?

可以。每次執行相互獨立,由 runId 標識。同一專案的三張工單上可以同時跑三支不同的團隊。在單次執行內部,執行遵循你的圖:預設順序執行,在你畫了並行分支的地方並行 (例如 QA 和 Security 同時審查), 並且總有一個確定性的匯合。

兩個代理真的能同時執行嗎?

能。從一個節點畫出兩條無條件連線,兩個目標就會作為並行分支執行,各自擁有自己的代理和終端。分支深度為一個節點,且必須匯聚到同一個匯合節點,編輯器會在執行前校驗這一點。當所有分支完成,匯合節點收到一份合併後的 payload: 按角色標註的摘要、去重後的風險與測試提示,以及按故障安全規則合併的標誌 (布林衝突解析為 false)。

品質門到底是怎麼工作的?

你在節點上寫一條 shell 命令,例如 npm test, 也可以指定一個標誌名 (預設 checkPassed)。代理宣告步驟完成後, AgentsRoom 在工作區執行該命令,上限五分鐘。退出碼 0 向標誌寫入 true, 其他值寫入 false, 覆蓋代理對自己的一切說法。失敗時,輸出的最後幾千位元組會傳給下一個代理:迴環帶著真實的堆疊跟蹤落地,結果也會顯示在執行時間線上。

某個步驟能載入我 Skills Library 裡的流程嗎?

能。每個節點都可以固定 Skills Library 裡的技能,專案級或全域皆可。代理會被要求在開始該步驟前逐一載入:審查清單、部署手冊或測試流程會在每一次執行中執行,而不是依賴代理的記憶。

執行之前,AgentsRoom 會檢查我的團隊圖嗎?

是的。編輯器會執行一組圖檢查,並把阻斷性錯誤與警告區分開。錯誤會阻止執行:缺少 Start 或 End 節點、重複連線、兩條帶有相同條件的連線、條件自相矛盾的連線、無效的扇出。警告不會:前後帶空格的標誌名、從 Start 出發的連線上帶條件、所有出向連線都帶條件因而執行可能卡住的節點。兩者都會列在檢查面板中,出問題的連線會在畫布上換色,讓你在因此浪費一次執行之前修好圖。

代理能修改它正在執行的那支團隊嗎?

不能,這是刻意的設計。只要一次執行還活著,團隊定義就對來自 MCP 工具的寫入凍結:節點、連線、迴圈上限、步驟指令、技能、檢查命令、角色、供應商和模型對代理都是唯讀的;執行中已載入的技能同樣不能被改寫;刪掉團隊再重建也繞不過這道凍結。代理不該改寫約束自己的規則。而你隨時都能從介面上編輯任何東西。

我能從手機上啟動並跟進一次團隊執行嗎?

可以。移動伴侶應用能在某個專案上啟動一支團隊,顯示帶每個步驟進度的執行橫幅,並讓你進入當前正在幹活的那個代理的終端。執行本身仍然在你的桌面版、透過真實的 CLI 執行,和你在桌面上親自啟動完全一樣。

我該選接力模式還是團隊模式?

先問這次執行最可能栽在哪裡。如果會栽在把線索跟丟上,選接力:一個會話扮演所有角色,永遠不需要向自己重新解釋一個決定。如果會栽在自己同意自己上,選團隊:各個角色作為獨立代理執行,審查程式碼的就不是寫程式碼的那一個。接力是預設值,因為在這個設定存在之前搭好的每一支團隊本來就是這麼跑的,而不是因為它更好。

團隊模式下,所有代理會一起啟動嗎?

不會。隊友在第一次被需要時才啟動,可能是圖譜走到了它這一步,也可能是另一個代理寫信給它,此後它會一直活到本次執行結束。所以一支四角色團隊不會為了回答只牽涉兩個角色的問題而燒掉四個會話,而在第三輪被搭話的角色,仍是第一輪作答的那個代理。

隊友記得其他人做過什麼嗎?

只記得它讀得到的部分。中途加入的隊友有自己的會話,對已經做過的工作沒有任何記憶,而這恰恰是它的意見值錢的原因。它靠共享筆記、執行時間線,以及本次執行開始以來的 git diff 來跟上進度,這些都由它用自己的工具去讀。這份閱讀就是這個模式的成本,也正是接力模式仍然存在的理由。

我能禁止代理之間按任意順序互相發訊息嗎?

可以,而且預設就是如此。關閉自由對話後,隊友只能寫給自己節點在圖譜中指向的那些角色,因此沒法靠轉而去問別人來繞開一道關卡。當你想要一支真正的團隊時再開啟它:任何人都能寫給任何人,方向不限,也能一次寫給好幾個。無論開還是關,圖譜依然負責啟動這次執行,也依然負責結束它。

一次團隊執行能自己開始嗎,比如按計劃,或者在 webhook 觸發時?

可以。觸發器可以指向一支團隊,而不是單個代理,於是同一條流水線無人值守地跑起來:按日曆節奏,按你 AI 訂閱的配額週期,或者由 GitHub、GitLab、Slack、Linear、Sentry 或你的 CI 發來的事件觸發。提示詞送到團隊的第一步,這次執行和其他任何一次一樣發生在你自己的機器上,落進觸發器的歷史,還有一條通知告訴你它已經開始。觸發器就在專案的觸發器面板裡,和定時任務放在一起。

延伸閱讀

建置您理想的 AI 開發團隊

應用自帶四個模板。開啟 AgentsRoom, 放節點,畫連線,在任意工單上執行。你的 AI 工程團隊只有一次點選之遙。

免費下載 AgentsRoom

配套應用:隨時隨地監控你的 Agent

使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。

獲取擴充功能
Chrome Web Store

把 Bug 和需求直接傳送到您的公開待辦清單。

多專案管理
多供應商
多代理執行
即時狀態
檔案差異與提交
行動應用
即時預覽
代理團隊
瀏覽器自動化
Backlog 驅動開發
提示詞庫
技能庫
檢視所有功能