Subagents (子代理) 是 Codex 提供的一项进阶并行工作流能力。它允许主会话临时调度多个职责明确的子代理，在独立的线程中同步完成特定维度的分析、探索或代码评审，最终将精炼的结论汇总至主会话进行统一决策。

核心价值：为什么需要 Subagents？

  • 并行提效：在处理复杂任务时，可以同时开启安全审查、性能评估与文档检查等多个子任务，显著缩短等待时长。
  • 上下文降噪：将繁琐的探索性过程（如扫描上百个日志文件）移至独立的子线程，确保主会话始终聚焦于核心业务逻辑与最终交付。
  • 专业化分工：您可以为不同的子代理指定不同的驱动模型或操作规则。例如，由逻辑严密的模型负责架构分析，由速度更快的模型负责格式检查。

Subagents 的工程协作逻辑

  1. 主会话调度 (Dispatch)：开发者向主会话下达任务，并由主会话决定如何拆分并启动子代理。

    2. 2. 子代理并行执行 (Parallel Execution)：各子代理在各自的权限边界与沙盒约束内独立工作，互不干扰。

    3. 结论汇总 (Consolidation)：任务完成后，子代理仅将核心发现或代码片段交回主会话，主会话负责最终的逻辑整合。

    场景决策矩阵

    | 适用场景 | 慎用/不适用场景 |

    | :--- | :--- |

    | 大规模只读评审：并行审查分支的安全合规性、测试覆盖率及可维护性。 | 原子级简单任务：修改单行文案或微调 CSS 样式，单线程效率更高。 |

    | 复杂工程调研：分别由不同子代理梳理前端路由、后端 Service 及部署脚本。 | 强时序依赖任务：必须先完成数据库迁移才能修改 API 接口的任务。 |

    | 多维度故障诊断：同时扫描配置文件、环境依赖、运行日志及 Git Diff。 | 高冲突风险修改：严禁多个子代理同时对同一组核心文件进行写入操作。 |

    核心技术术语

    • Agent Thread (代理线程)：每个子代理运行的独立会话上下文。
    • Sandbox Inheritance (沙盒继承)：子代理默认继承主会话的权限策略（如只读/可写）与安全边界。
    • Task Handoff (任务移交)：在不同工作区或代理角色之间高效传递任务状态与关键上下文。

    专业协作建议

    1. “先分析，后操作”：在完全掌握并行冲突控制前，建议仅利用 Subagents 进行只读性质的分析、审计与方案评审。

      2. 2. 职责精确对齐：在启动子代理时，必须赋予其窄而准的职责描述（如“仅检查敏感词泄露”），避免职责重叠导致的资源浪费。

      3. 主会话把控全局：开发者应始终保持在主会话中的最终决策权，将子代理视为提供专业情报的“侦查员”，而非最终代码的“决策者”。

      掌握 Subagents，意味着您已具备编排复杂 AI 任务的能力，这将使您在处理大型复杂工程项目时更加游刃有余。

      ---

      下一篇推荐：第一次使用 Subagents 做只读评审 —— 实战演练如何调度多个代理并行分析项目风险。