第三十五课：Subagents 子代理

学习目标

• 理解子代理系统的概念
• 掌握任务分解方法
• 了解并行执行机制

一、什么是子代理

子代理是 Codex App 中的嵌套代理系统。主代理可以将复杂任务分解为多个子任务，分配给子代理并行执行。

1.1 主代理 vs 子代理

主代理：

• 分析任务
• 分解子任务
• 协调子代理
• 汇总结果

子代理：

• 执行具体任务
• 独立运行
• 返回结果

二、任务分解

2.1 分解原则

• 独立性：子任务之间尽量独立
• 粒度适中：不要太细也不要太粗
• 明确目标：每个子任务有明确的目标

2.2 分解示例

任务：重构用户模块

分解为：

1. 子代理 1：分析现有代码
2. 子代理 2：设计新架构
3. 子代理 3：实现新代码
4. 子代理 4：编写测试

三、并行执行

3.1 独立上下文

每个子代理有独立的上下文，不会相互干扰。

3.2 独立沙盒

每个子代理在独立的沙盒中运行。

3.3 结果汇总

子代理完成后，结果返回给主代理，主代理汇总并验证。

四、使用场景

4.1 大规模重构

将重构任务分解为多个子任务，并行执行。

4.2 多文件修改

修改多个文件时，每个文件分配给一个子代理。

4.3 测试和验证

运行测试时，不同测试用例分配给不同子代理。

五、最佳实践

5.1 合理分解

将任务分解为合适的粒度，避免太细或太粗。

5.2 避免依赖

尽量让子任务之间没有依赖关系。

5.3 验证结果

主代理应该验证子代理的结果。

六、本课小结

要点	说明
子代理	嵌套代理系统
任务分解	独立性、粒度、明确目标
并行执行	独立上下文、独立沙盒
使用场景	大重构、多文件、测试

下一步

下一课我们将了解 Worktrees 功能。