Facade Code 說明文件
協作模式

Facade 模式:讓一個 Agent 管理團隊

讓一個 Agent 追蹤你的功能 Agent,並把他們的問題帶回來給你。離開座位後,還能從手機繼續與這位管理者對話。

什麼時候適合這個模式

當多個 Agent 正在開發功能,而你希望有一個地方查看進度、處理問題時,就很適合。它們可以全部在本機執行,也可以有一部分透過 SSH 在遠端機器上工作。管理者是團隊的單一聯絡窗口:各功能 Agent 繼續工作時,管理者會向它們收集最新進展。

為什麼這樣分工有幫助

  • 在一個對話中追蹤多個功能。向管理者詢問整體狀況,它會向各功能 Agent 收集進度,告訴你每個功能目前的狀態。
  • 找出需要處理的地方。它會檢查終端機是否有錯誤、額度訊息與尚未回答的問題,必要時向相關 Agent 追問細節。
  • 離開時也能掌握狀況。將手機連上管理者的工作階段,就能查看進度、回答問題並送出新的指示。

1. 啟動管理者

  • 讓你想追蹤的專案在編輯器中保持開啟。遠端機器上的 Agent 則要維持 SSH 連線。
  • 使用既有的 Claude Code Agent 擔任管理者,或用 New Agent 建立一個。

這個範例用 Claude Code 擔任管理者。功能 Agent 已經在執行,並各自沿用原本的 CLI 與模型。

角色CLI模型effort
管理者Claude Code (claude)opushigh
功能 A — 已在本機執行Codex (codex)gpt-6-solhigh
功能 B — 已透過 SSH 執行Codex (codex)deepseek-v4.1-flashxhigh
功能 C — 已透過 SSH 執行Muse Code (muse)muse-spark-1.3high

在你的專案中開啟 Facade,點選 New Agent,為管理者選擇 Claude Code。用 /model opus 設定模型,用 /effort high 設定 effort。

啟用 YOLO 時,管理者可以聯絡透過你的 Facade home 連線的所有 Agent。這個設定也會改變 CLI 的核准行為;詳見Agent 權限。

2. 請它追蹤其他 Agent

把這段提示詞送給管理者:

提示詞
用 Facade 追蹤其他 Agent。
每五分鐘讀取他們的終端機,查看進度。有任何不清楚的地方,直接問 Agent。
當有 Agent 發生錯誤、卡住或需要我提供資訊時,告訴我。
我詢問進度時,總結每個功能目前的狀態。

3. 它如何追蹤團隊

  1. 找到功能 Agent
  2. 定期檢查進度
  3. 追問問題並回報狀況
  4. 從手機繼續
  1. 管理者找到各個功能 Agent,並安排每五分鐘檢查一次。
  2. 每次檢查時,它會讀取這些 Agent 的終端機。如果進度不明確,就向相關 Agent 追問。
  3. 它會回報問題,並把需要你決定的事情帶回來。
  4. 你在管理者的工作階段中回答,它再把你的回覆轉達給該功能 Agent。你隨時可以要求整體進度報告。

管理者會告訴你檢查排定的時間。請讓它的工作階段持續執行;管理者忙碌時,檢查可能會延後。

Claude Code 排程任務 ↗

4. 從手機繼續

在管理者的 Claude Code 工作階段中執行:

從手機連上管理者
/remote-control

依提示操作,然後在手機上開啟工作階段連結,或掃描 QR 碼。

你可以向管理者詢問進度、回答它的問題,或送出更新後的需求。它會繼續透過 Facade 追蹤各功能 Agent。

請讓管理者所在的電腦保持喚醒並連上網路,Claude Code 也要持續執行。帳號需求與連線協助請見從手機繼續工作。

選用:加入 PM 或技術主管協助專案決策

日常決策方面,你可以啟動一個產品經理(PM)或技術主管(TL)Agent,並在 Facade 中固定它。和它討論專案方向、優先順序、技術限制與過去的決策。實作與除錯交給功能 Agent,讓這些對話聚焦在決策上。

如果兩者都加入,請告訴管理者如何運用它們:

讓 PM 與 TL 處理日常決策
把日常的產品問題透過 Facade 交給 @PM,技術問題交給 @TL。
請他們依我們已議定的專案方向做決定,再由你把答案轉達給各功能 Agent。
如果某個問題會改變這個方向,或他們無法達成共識,就來問我。

PM 或 TL 的工作階段變長時,請它做一份交接,涵蓋專案方向、過去的決策、決策原因與尚未解決的問題。把交接內容交給新的 PM 或 TL,再告訴管理者要聯絡哪個 Agent。

在你的專案中使用

  • 調整檢查間隔,或請管理者專注在需要處理的功能上。
  • 功能 Agent 可以繼續留在原本的機器上工作。管理者會讀取它們的終端機,並透過 Facade 傳訊息給它們。
  • 不同的專案各自使用自己的管理者。每個管理者追蹤自己專案的 Agent,你則分別與這些管理者確認狀況。

使用 Remote Control 時,管理者請維持使用 Claude Code。功能 Agent、PM 與 TL 可以使用其他 CLI 與模型。關於儲存的啟動設定與其他供應商,請見Agent 設定、Claude Code 接入其他供應商,以及Codex 接入其他供應商。

以 Markdown 檢視 ↗說明文件

搜尋說明文件

搜尋本指南。用 ↑ ↓ 移動、Enter 開啟、Esc 關閉。