11.7 团队管理与最佳实践

面向经管学生、研究者与从业者的 AI 智能体设计教材

11.7 配图

Agent Teams 是一种协作工具，但并非所有场景都适合使用。本节讨论它的适用条件、管理方式和使用限制。

适用场景

Agent Teams 在以下场景中能发挥最大价值：

• 研究与分析：多个队友从不同角度研究同一个问题。例如分析一个投资标的时，一个队友研究财务数据，一个研究行业趋势，一个评估管理层。各自的发现可以直接分享给其他队友。
• 独立模块实现：开发一个系统的多个独立模块。每个队友负责一个模块，模块之间有清晰的接口定义。队友之间在需要对齐接口时直接沟通。
• 并行调试：一个队友负责复现和定位问题，另一个队友扮演批评者角色，质疑定位结论的完整性。两个队友的对话能暴露单个智能体可能忽略的问题。
• 跨栈功能开发：前端、后端和数据库各有一个队友。三者需要频繁协调接口格式和数据流转，直接通信通常比通过 Lead 中转更高效。

不适用场景

以下场景使用 Agent Teams 反而会增加复杂度，不如用子代理或单智能体：

场景	原因	替代方案
严格的顺序任务	后一步依赖前一步的完整结果，并行没有意义	单智能体按步骤执行
编辑同一个文件	多个队友同时修改同一文件会产生冲突	一个子代理处理
简单且独立的子任务	队友之间不需要交流，Agent Teams 的通信机制是浪费	子代理
任务规模很小	创建团队的开销大于任务本身	主代理直接执行

文件冲突防范

多个队友同时工作时，文件冲突是最常见的问题来源。预防的关键是在任务分配时为每个队友指定独立的工作目录：

▶ Claude Code

队友 A：工作目录 src/frontend/，不要修改 src/backend/ 中的文件
队友 B：工作目录 src/backend/，不要修改 src/frontend/ 中的文件
队友 C：工作目录 src/database/，不要修改其他目录中的文件

如果某些文件需要多个队友访问，约定只读访问规则：配置文件（如 config.json）所有队友可读、只有 Lead 可写；接口定义文件（如 api-spec.yaml）所有队友可读、修改需通过 Lead 协调。

Lead 还应主动监控队友的工作进度。共享任务列表是最直接的监控手段，Lead 可以随时查看哪些任务已完成、哪些正在进行、哪些被阻塞。如果一个队友长时间停留在同一个任务上，Lead 应主动询问是否遇到困难。

质量门禁：Hook 事件

Agent Teams 提供三个专属 Hook 事件，可以在 settings.json 中配置自动检查：

Hook 事件	触发时机	用途
TeammateIdle	队友即将进入空闲状态	退出码 2 可发送反馈并让队友继续工作
TaskCreated	新任务被创建时	退出码 2 可阻止创建并返回反馈
TaskCompleted	任务被标记为完成时	退出码 2 可阻止完成并返回反馈

Agent Teams 的任务流转可以在关键节点接入自动检查，确保交付质量。

团队关闭流程

团队的关闭需要按顺序进行：

1. Lead 向每个队友发送关闭请求
2. 队友批准关闭（如果队友正在执行关键操作，可以拒绝）
3. 所有队友关闭后，Lead 执行团队清理
4. 共享任务列表和团队配置被清除

关闭和清理的两条规则

第一，不要直接终止队友进程——强制终止可能导致文件写入不完整或任务状态不一致。始终使用关闭请求让队友有机会完成当前工作。第二，团队清理必须由 Lead 执行，队友不应运行清理操作，否则可能导致共享资源状态不一致。

已知限制

Agent Teams 作为实验性功能，存在以下已知限制：

限制	影响
无会话恢复	/resume 和 /rewind 不会恢复 in-process 模式的队友。恢复会话后 Lead 可能尝试联系已不存在的队友，需要重新创建
任务状态可能卡住	队友有时不会将任务标记为已完成，导致依赖该任务的后续任务被阻塞。需要手动更新状态或让 Lead 提醒队友
关闭延迟	队友会完成当前正在执行的请求或工具调用后才关闭，可能需要等待
单团队限制	一个 Lead 同一时间只能管理一个团队，需要先清理当前团队才能创建新团队
无嵌套团队	队友不能创建自己的子团队或队友，只有 Lead 能管理团队
固定领导权	Lead 角色不能转移给其他队友
权限继承	队友初始继承 Lead 的权限模式，生成后可单独修改，但无法在创建时逐个指定
Split-pane 终端限制	仅支持 tmux 和 iTerm2，不支持 VS Code 内置终端、Windows Terminal 和 Ghostty

这些限制意味着 Agent Teams 更适合中等规模的协作任务，例如 3-5 个队友、明确的任务边界，以及一个清晰的协调者。

从小规模开始

初次使用 Agent Teams 时，建议先用研究和评审任务练手，从 2 个队友开始，使用 in-process 模式。给每个队友明确的角色和边界，避免职责模糊导致重复工作。理解通信和任务协调的机制后再增加队友。