Free Preview

先试读:Codex 多 Agent 实战:怎么拆任务、分配角色、汇总结果

多 Agent 的价值不是让更多模型同时改代码,而是把可以独立推进的探索、测试和审查放进隔离上下文,再由主 Agent 统一判断和验收。

这篇会帮你解决什么

  • 识别真正可并行的读密集任务。
  • 为每个子 Agent 写清角色、范围和交付格式。
  • 由主 Agent 负责合并判断,不把多个答案直接拼接。

可以先照着试的一句话

先把这个任务拆成依赖图,只把可独立且以读取、分析、测试为主的部分交给子 Agent;每个子 Agent 必须返回证据、结论、未验证项和建议,不得修改文件。

完整文章会继续展开机制、工作流、验收标准和风险边界。

01 · 判断是否并行

多 Agent 最适合独立、读密集、输出可比较的工作

子 Agent 拥有独立上下文,可以分别检查安全、测试、性能、文档或不同模块。它们不会自动共享完整推理,因此适合边界清楚、输入稳定、结果能用统一格式汇总的任务。大范围代码探索、并行查资料、独立审查和测试失败分类,通常能获得真实收益。

相反,连续修改同一组文件、依赖上一小步即时反馈、需要频繁统一设计判断的工作,不适合强行并行。多个 Agent 同时写同一文件,会把节省的时间变成冲突、重复修改和难以追责的差异。

02 · 任务图

先画依赖关系,再决定哪些节点可以同时启动

  1. 写出最终决策和验收证据,而不是只写“研究一下”。
  2. 把任务拆成能单独回答的问题,标记输入、输出和依赖。
  3. 依赖同一前置结论的节点,等前置完成后再启动。
  4. 同一文件或同一业务判断只指定一个写入负责人。
示例:准备一次登录模块改造

Agent A 只读梳理认证调用链;Agent B 检查安全风险;Agent C 运行并分类现有测试;主 Agent 根据三份证据确定最小修改方案。设计确定后,再由一个 Agent 实施,其他 Agent 负责复核,而不是四个 Agent 同时改登录代码。

03 · 输出协议

角色名称不如任务边界和返回格式重要

角色:安全审查
范围:auth/ 与相关测试,只读
问题:列出可被利用的真实风险,不做泛化建议
证据:文件路径、行号、触发条件、现有保护
输出:结论 / 严重度 / 修复建议 / 未验证项
禁止:改文件、联网、读取凭证、扩展到无关目录

给子 Agent 的上下文要足够完成任务,但不要把主任务的所有历史都复制进去。统一输出格式能让主 Agent快速比较矛盾结论,也能识别“有结论但没有证据”的低质量结果。

04 · 汇总而非拼接

主 Agent 要解决冲突、去重和证据强弱,不能只复制摘要

汇总时先按问题而不是按 Agent 排列结果:哪些事实一致,哪些结论冲突,差异来自输入、假设还是证据不足。高风险结论必须回到代码、测试或官方资料核验;无法核验的内容明确标记,不用多数投票代替判断。

如果必须并行写入,使用不同文件或独立 worktree,并提前指定合并顺序和最终负责人。合并后重新运行完整测试,因为每个分支分别通过并不等于组合后仍然正确。

05 · 验收

用总耗时、证据质量和返工量判断是否值得多 Agent

  • 子任务边界清楚,且没有越权读取或写入。
  • 每份结论带有路径、命令、来源或可复现步骤。
  • 主 Agent 处理了冲突与遗漏,并说明最终取舍。
  • 修改由明确负责人实施,合并后测试和页面验证重新执行。
  • Agent 数量越多,令牌、协调和审查成本越高;没有并行收益就回到单 Agent。

行动建议:第一次只开两个只读子 Agent,让它们从不同角度审查同一低风险模块。比较证据和遗漏后,再决定是否把这种分工固化成自定义子 Agent。

资料 · 时效核验

产品能力会变,学会回到官方资料

官方资料与核验日期

本文依据官方资料核验于 2026-07-15。功能名称、入口、套餐、地区可用性和实验性标记仍可能变化,使用时以官方文档与产品内实际显示为准。

Next Step

学完这篇,下一步这样走

选一个低风险任务完整走一遍,再扩大权限或增加自动化。

现在就练一下

先把这个任务拆成依赖图,只把可独立且以读取、分析、测试为主的部分交给子 Agent;每个子 Agent 必须返回证据、结论、未验证项和建议,不得修改文件。