subagents

子 Agent

概述

协调一个编排器与一个或多个子 Agent 之间的工作。使用子 Agent 探索或执行相互独立的工作路径，同时由编排器负责任务分解、冲突控制、整合、验证和最终判断。

核心规则

仅在使用子 Agent 能让工作更安全、更快或更全面时才使用。

分派任务前，先判断任务是否有明确且互不重叠的工作路径。如果任务很小、紧密耦合，或可能导致文件冲突，则跳过子 Agent，并说明原因。如果执行环境不支持子 Agent，则继续以单 Agent 方式工作，并说明这一限制。

编排器的职责

• 理解用户请求，并检查足够的上下文，以安全地拆分工作。
• 按文件归属、子系统、问题、产物或审查关注点，确定相互独立的工作路径。
• 避免将相互重叠的写入任务分配给多个子 Agent。
• 为每个子 Agent 提供范围明确的提示词，说明工作范围、允许处理的文件或区域、预期输出和约束。
• 不要在子 Agent 提示词中包含机密、凭据、隐藏推理或与任务无关的用户更改。
• 跟踪每个子 Agent 的状态、发现、输出和风险。
• 在中央统一整合结果，不要让子 Agent 作出相互冲突的最终决定。
• 进行最终验证并给出最终答复。

适合交给子 Agent 的工作路径

在以下工作路径中分派子 Agent：

• 研究不同的库、API、文档或产品选项。
• 审查不同关注点，例如正确性、安全性、用户体验、性能、文档或测试。
• 检查无需同时编辑同一文件的不同代码区域。
• 实现边界明确的独立模块、测试、测试夹具、文档或示例。
• 复现相互独立的故障，或从不同系统收集日志。

每个有意义的工作路径优先分配一个子 Agent。不要为了显得并行而额外创建 Agent。

不适合交给子 Agent 的工作路径

以下情况不要分派子 Agent：

• 任务简单到协调开销大于实际工作量。
• 工作需要由单个编辑者持续作出设计判断。
• 多个 Agent 需要同时编辑相同文件或紧密耦合的代码。
• 仓库处于容易出问题的脏状态，并行编辑可能覆盖用户的工作。
• 可用的子 Agent 机制无法返回足够详细的信息，无法安全地验证或整合。
• 用户要求直接实现，且任务范围较窄。

分派提示词检查清单

每个子 Agent 提示词都应包含：

• 用户目标。
• 分配给子 Agent 的确切工作路径。
• 子 Agent 应检查的文件、目录、系统或来源。
• 如果允许编辑，子 Agent 可以编辑的文件或区域。
• 子 Agent 不得触碰的文件或区域。
• 预期交付内容：发现、补丁摘要、测试结果、建议或产物。
• 该工作路径的验证要求。
• 明确报告阻碍因素和不确定性的要求。

如果工作路径属于研究或审查，请要求提供证据和可执行的发现，而不是宽泛的评论。

整合工作流

1. 制定简短的任务分解计划。
2. 判断使用子 Agent 是否有帮助且安全。
3. 如果有帮助，且执行环境支持，则并行分派范围明确的工作路径。
4. 审核每个子 Agent 的结果后再采信。
5. 解决矛盾、重复内容和范围偏移。
6. 在中央应用或整合已接受的更改，同时保留无关的用户工作。
7. 运行覆盖整合结果的验证。
8. 总结使用了哪些子 Agent、各自负责什么、更改了哪些内容，以及哪些验证已通过。

冲突控制

• 将协调器视为唯一的最终集成者。
• 优先使用能提供调查结果或针对性补丁的子代理，而不是让其大范围、不受控地修改代码。
• 如果两条工作线意外产生重叠，停止对重叠部分进行并行编辑，并手动合并。
• 如果其他 Agent 可能改动过附近代码，在应用或集成更改前重新读取文件。
• 切勿盲目覆盖用户或其他 Agent 的更改。

最终回复

报告：

• 是否使用了子代理。
• 如果使用了，说明分配的工作线以及每条工作线返回的内容。
• 如果跳过了，说明原因。
• 最终集成的更改或结论。
• 执行过的验证以及仍存在的风险。