# Facade pattern：让一个 Agent 管理团队

让一个 Agent 跟进各个功能 Agent 的进度，把需要你决定的问题带回来。离开电脑后，用手机继续和它沟通。

## 什么时候用这个模式

几个 Agent 正在做不同的功能，有的在本机，有的在通过 SSH 连接的远端机器上，你想在一个地方看进度、处理问题。管理 Agent 负责汇总进展：你主要通过它了解进度、处理问题，也可以随时直接找某个功能 Agent；功能 Agent 继续做自己的事。

找到功能 Agent → 定期检查进度 → 问清问题并汇报 → 从手机继续

## 这样分工有什么好处

- **一个会话看几个功能。** 功能 Agent 继续做自己的工作。你问管理 Agent 要整体进展，它去各个功能那边了解，再告诉你每个做到哪一步。
- **知道哪里需要你。** 它读终端，找报错、额度提示和没人回答的问题，需要时向对应 Agent 问清楚。
- **不在电脑前也能跟进。** 手机连上管理 Agent 的 Claude Code 会话，就能问进度、回答问题、补充要求。

## 1. 启动管理 Agent

- 要跟进的项目保持在编辑器里打开；有远端机器上的 Agent，SSH 连接也要保持。
- 用已有的 Claude Code Agent 当管理 Agent，或者用 New Agent 新建一个。

这个例子用 Claude Code 当管理 Agent，跟进已经在本机和远端机器上运行的功能 Agent。它们继续用各自的 CLI 和模型。

| 负责什么 | CLI | Model | Effort |
| --- | --- | --- | --- |
| 管理 Agent | Claude Code (claude) | opus | high |
| 功能 A：已在本地运行 | Codex (codex) | gpt-6-sol | high |
| 功能 B：已在远端机器运行 | Codex (codex) | deepseek-v4.1-flash | xhigh |
| 功能 C：已在远端机器运行 | Muse Code (muse) | muse-spark-1.3 | high |

在你的项目里打开 Facade，点击 New Agent，选择 Claude Code 作为管理 Agent。用 `/model opus` 设置模型，用 `/effort high` 设置 effort。

开启 YOLO 后，管理 Agent 能联系到通过你的 Facade home 连接的所有 Agent。这个设置同时改变 CLI 的审批行为，具体见[审批与 Agent 协作范围](https://facadecode.com/zh-cn/docs/permissions/)。

## 2. 告诉它要跟进哪些 Agent

把这段提示词发给管理 Agent：

```text
用 Facade 跟进其他 Agent。
每五分钟读一次它们的终端，看进度；不清楚的地方直接问对应 Agent。
有 Agent 报错、卡住，或者需要我决定，就告诉我。
我问进度时，汇总每个功能做到哪里。
```

## 3. 它怎样跟进进度

- 管理 Agent 找到各个功能 Agent，用 Claude Code 的定时功能安排每五分钟检查一次。
- 每次检查时，它读终端输出，不清楚的地方就向对应 Agent 询问。
- 遇到问题或需要你决定时，它把情况带给你。终端暂时没有输出时，要先问清楚，不能直接当成卡住或已经做完。
- 你通过管理 Agent 回答，由它把意见传给对应的功能 Agent。也可以随时问它整体进度。

检查安排好之后，管理 Agent 会告诉你。它的会话要保持运行；它忙于别的工作时，检查可能会推迟。

[Claude Code 定时任务说明 ↗](https://code.claude.com/docs/en/scheduled-tasks)

## 4. 从手机继续指挥

在管理 Agent 的 Claude Code 会话里输入：

```text
/remote-control
```

按提示操作，然后在手机上打开会话链接，或者扫描二维码，用同一个 Claude 账号登录。

接着就能在原来的会话里问进度、回答问题或补充需求，管理 Agent 继续通过 Facade 跟进各个功能。

保持那台电脑唤醒、联网，Claude Code 继续运行。Remote Control 需要符合要求的 Claude 订阅和官方 Anthropic 接口，见[使用条件与连接步骤 ↗](https://code.claude.com/docs/en/remote-control)。

## 让长期合作的 PM 或 TL 帮你做决定

日常决策也可以交给长期合作的产品经理（PM）或技术负责人（TL）。把它们的会话 Pin 在 Facade 里，平时和它们讨论项目方向、优先级、技术约束，以及之前为什么这样决定。实现和调试交给功能 Agent，让这两个会话只谈决策。

两个都加的话，再告诉管理 Agent 什么时候找它们：

```text
通过 Facade 把日常产品问题交给 @PM，技术问题交给 @TL。
让它们按照我们已经确定的项目方向做决定，再把意见传给功能 Agent。
需要改变项目方向，或者它们无法达成一致时，再来问我。
```

PM 或 TL 的会话变长后，可以让它整理一份交接：当前方向、已经做出的决定及原因、还没解决的问题。把交接内容给新的 PM 或 TL，再告诉管理 Agent 以后联系谁。

## 用到你自己的项目里

- 按需要调整检查间隔，或者只让管理 Agent 跟进当前需要关注的功能。
- 功能 Agent 继续在原来的机器上工作。管理 Agent 通过 Facade 读它们的终端、和它们通信。
- 不同项目分别交给不同的管理 Agent。每个管理 Agent 跟进自己项目里的功能，你主要和这几个管理 Agent 沟通。

要从手机连接，管理 Agent 用 Claude Code；功能 Agent 和负责决策的 Agent 可以用其他 CLI 和模型。接入其他模型服务看[Agent 配置](https://facadecode.com/zh-cn/docs/settings/)、[Claude Code 接入其他模型服务](https://facadecode.com/zh-cn/docs/providers/claude-code/)和[Codex 接入其他模型服务](https://facadecode.com/zh-cn/docs/providers/codex/)。