用 Prompt 模板，把 Codex 多 Agent 协作做成了“开箱即用”
在实际开发中，很多团队尝试用 Codex 做多 Agent 协作，最后都发现同一个问题：每次新对话都要重新解释一遍规则、角色、流程，效率极低。
真正的高效做法，是把所有长期规则、角色边界、协作流程、提示词模板全部沉淀到仓库里，让 Codex 一打开项目就能“懂规矩”，实现真正的开箱即用。
本文将手把手教你如何用 Prompt 模板体系，把 Codex 多 Agent 协作彻底做成标准化、可复制的生产力工具。
什么是 Codex 多 Agent “开箱即用”？
“开箱即用”在这里的含义是：
- 新建对话后，无需重复输入长提示词
- Codex 自动读取项目内的规则文件，明确知道自己是谁、不能做什么、该如何协作
- 主线程（Orchestrator）可以直接调度各类专家 SubAgent，流程可控、可追溯、可审查
- 即使换人、换项目，也能快速保持一致的协作标准
核心实现方式就是Prompt 模板 + 仓库级文档体系。
第一步：建立 AGENTS.md —— Codex 的“家法”
AGENTS.md 是整个体系中最重要的一份文件，它相当于给 Codex 量身定制的《团队协作手册》。
这份文件应该包含以下核心内容：
- 角色定义：主 Orchestrator、不同领域的 Expert Agent（前端、后端、AI 算法、测试、DevOps 等）
- 严格边界：什么能做、什么坚决不能做（比如禁止批量删除、禁止全局重构、禁止写 TODO 注释等）
- 协作流程：父线程如何 spawn 子 Agent、如何检查产物、如何更新黑板
- 门禁规则（Gates）：每次任务完成必须满足的硬性标准
- 常用 Prompt 模板：各种场景下的标准化指令，做到“复制粘贴即可用”
关键技巧：每次新建 Codex 对话时，第一条消息永远是：
“你现在是本项目的 Orchestrator，请先完整阅读 AGENTS.md 和 docs/blackboard/state.yaml，再开始工作。”
这样 Codex 一上来就有完整上下文，避免了“失忆”问题。
第二步：搭建三层文档体系
高效的多 Agent 协作通常需要三层互补文档：
1. AGENTS.md（总纲 + Prompt 模板库）
存放全局规则、角色定义、最重要的 Prompt 模板。这是 Codex 每次都会读取的核心文件。
2. DEVELOPER_GUIDE.md（技术执行手册）
面向具体开发的 Agent，包含：
- 项目技术栈和架构分层
- 代码规范与 API 设计标准
- 环境变量、启动命令、测试流程
- 任务完成标准（必须编译通过、类型检查通过、提供修改文件清单等）
每次让开发类 Agent 工作时，都要把这份文档塞给它，确保它“懂这个项目的规矩”。
3. PROGRESS.md（任务调度中心 + 黑板）
这是整个多 Agent 协作的指挥部，实时记录：
- 当前任务分配给哪个 Agent
- 分支名称、涉及文件、依赖关系
- 阻塞项和完成状态
- 黑板（Blackboard）最新状态
主 Orchestrator 每次调度前都要先读这份文件，调度后及时更新它。
第三步：设计高质量 Prompt 模板
以下是几类最常用的“开箱即用” Prompt 模板，建议直接放到 AGENTS.md 中：
1. 任务初始化模板
你现在是 领域 Expert Agent。
请严格遵循 DEVELOPER_GUIDE.md 中的技术规范和任务完成标准。
当前任务是：xxx
依赖的前置任务状态请参考 PROGRESS.md。
请只修改以下文件：xxx
完成后必须：
1. 提供修改文件清单
2. 说明每个文件的改动原因
3. 确认符合所有门禁规则
2. Orchestrator 调度模板
你现在是主 Orchestrator。
请先读取 AGENTS.md、PROGRESS.md 和 docs/blackboard/state.yaml。
当前阶段目标是：xxx
请按以下步骤执行：
1. 检查所有前置任务是否完成
2. 分配任务给对应 Expert Agent
3. 明确告知每个 Agent 的边界和完成标准
4. 等待子 Agent 返回后进行质量检查
5. 更新 PROGRESS.md 和 blackboard
3. 审查与修复模板
请以 QA Agent 身份审查以下变更：
- 检查是否符合 DEVELOPER_GUIDE.md 中的所有规范
- 检查是否违反 AGENTS.md 中的任何禁止事项
- 列出所有问题，并给出具体修复建议
第四步：配置 Codex 读取规则
为了让 Codex 更智能地读取文档，建议在 .codex/config.toml 中增加：
project_doc_fallback_filenames = "AGENTS.md", "CLAUDE.md", "TEAM_GUIDE.md"
同时推荐在项目根目录建立 docs/codex/ 文件夹，把所有 Prompt 模板、责任矩阵、黑板 schema、重试策略等文档都放在这里，形成完整的知识库。
第五步：实际工作流示例
- 产品提出新需求
- Orchestrator 阅读 PROGRESS.md 和黑板，制定详细计划
- 按计划依次 spawn 对应的 Expert Agent（每个 Agent 都收到对应 Guide）
- 各 Agent 完成任务并提交修改清单
- Orchestrator 进行审查，必要时触发修复循环
- 全部通过后更新黑板和 PROGRESS.md
- 进入下一阶段
整个过程高度结构化，即使是新手接手也能快速跟上节奏。
总结：从“每次都要教”到“开箱即用”
把 Codex 多 Agent 协作做成“开箱即用”的核心，只有两句话：
把该说的规矩都写进文件，把该重复的话都做成模板。
当你把 AGENTS.md、DEVELOPER_GUIDE.md、PROGRESS.md 和一系列高质量 Prompt 模板搭建完成后，你会发现：
Codex 不再是一个需要反复教导的“实习生”，而变成一个真正懂规矩、守边界、可编排的生产力伙伴。
你只需要做好 Orchestrator，剩下的就交给标准化的 Prompt 模板体系。
需要完整可直接使用的 Prompt 模板合集和推荐目录结构，可以在评论区留言，我后续会整理成开源模板仓库，欢迎大家一起迭代这个 Codex 多 Agent 最佳实践。