批量同构任务模式
概述
Multi-Agent 系统中处理"大量结构相同、目标独立"子任务的工程模式，通过 CSV 格式的任务描述批量派遣 worker agent，实现线性扩展的开发效率。
关键内容
- 模式定义：主 Agent 枚举所有任务目标（文件列表/数据库表/API 清单），生成 CSV 格式的任务列表，调用
spawn_agents_on_csv批量派遣 worker agent，每个 worker 处理 CSV 中的一行任务。 - 典型场景：为 50 个 API endpoint 各写一份测试；将 30 个 Python 模块迁移到新框架；为 20 个数据库表生成 CRUD 代码。共同特征是任务结构相同、彼此独立、数量较多。
- 工作流程：主 Agent 枚举任务 → 生成 CSV → 调用 spawn_agents_on_csv → 等待所有 worker 完成 → 汇总结果生成报告。每个 Worker Agent 拥有独立上下文和独立沙箱，不共享 token 或文件系统。
- 隔离性保证：每个 worker agent 运行在独立的上下文窗口中，互不干扰；独立的Codex沙箱系统确保安全隔离；
default_worker_timeout（默认 30 分钟）提供超时保护，防止单个 worker 卡死影响整体。 - 效率杠杆：7 个 Agent 并行工作 ≈ 串行工作时间的 1/7。开发者从"写代码"角色升级为"审批 + 方向把控"角色，实现人类监督带宽的杠杆化。
与其他模式的对比
| 维度 | 批量同构任务 | 异构协作任务 |
|---|---|---|
| 任务特征 | 结构相同、彼此独立 | 结构不同、相互依赖 |
| 派遣方式 | spawn_agents_on_csv 批量 | spawn_agent 逐个 |
| 同步机制 | wait 所有 worker | wait_agent 显式依赖链 |
| 典型角色 | 同角色多实例 | 多角色协作（coder + reviewer） |
来源
- raw/articles/ai-tools/codex/07_codex_multi_agent.md — Codex CLI 深度解析 Vol.7：Multi-Agent 并行编码的调度与协同
相关
- Codex多Agent调度 — 批量同构任务是多 Agent 调度的核心应用场景 (part_of)
- Codex CLI — 通过 spawn_agents_on_csv 工具实现此模式 (implements)
- Orchestrator-Subagent-Pattern — 批量模式是协调器-子智能体模式的特化扩展 (extends)
- 人类监督带宽 — 批量模式杠杆化开发者审批带宽 (relates_to)