Subagents 的核心价值在于并行处理不同维度的分析任务，并将精简后的结论汇总给主会话。对于新手，第一次使用 Subagents 的最佳实践是进行“并行只读评审”，这既能体验并行的效率，又能完全规避文件冲突的风险。

任务设计思路

将一个大型评审任务拆解为三个互不干扰的只读方向：

  1. 结构评审：关注目录分层与模块组织。

    2. 2. 文档评审：检查说明文档是否缺失步骤。

    3. 构建评审：核对脚本命令与构建流程的准确性。

    执行流程

    第一步：发出并行指令

    在提示词中显式要求使用 Subagents，并明确定义各子代理的职责边界与限制条件（如：严禁修改文件、严禁安装依赖）。

    第二步：观察调度状态

    Codex 接收任务后会启动多个 Agent Thread。你可以通过查看线程列表来监控各个子代理的进度。

    第三步：处理权限请求

    子代理在执行读取操作时可能会触发权限申请。由于本次任务设定为只读评审，应拒绝任何涉及“写入”、“删除”或“联网”的权限请求，确保环境安全。

    第四步：获取汇总报告

    等待所有子代理完成后，主会话会整合各方结论。一份合格的报告应包含总体判断、各方向的详细发现（带文件路径）以及最小化的后续改进建议。

    关键操作技巧

    • 控制并发：初次练习建议并发数量不超过 3 个，避免信息过载。
    • 强制汇总：明确要求 Codex 等待所有子代理全部完成后再进行最终回复。
    • 审查证据：重点检查子代理的结论是否有真实的源码或文档依据，剔除推测性内容。

    为什么不直接让它们改代码？

    多个子代理同时修改文件容易产生冲突，且增加了人工审计的难度。先通过“只读评审”建立对子代理能力的信任，是构建稳定自动化流的必经阶段。

    总结

    通过本次练习，你应能掌握 Subagents 的调度方式、线程监控以及结果汇总逻辑。这标志着你从“单兵作战”模式进化到了“多代理协作”模式。