让 ChatGPT 与 Codex 协同AGENTS、.agents 与 Handoff 工程配置主题AI 开发工程治理实践版本CSDN 发布稿 v1.0适合人群想让多个 AI 工具长期维护同一工程仓库的开发者阅读方式本文可独立阅读不依赖其他文章背景。从零打通 那啥GPT 网页版 桌面版 访问本地代码CodexPro MCP 实战教程CodexPro MCP Cloudflare 配置详解HTTP2、QUIC 与连接排障GPT Codex CLI CodexPro 三位一体AI 编程协作工作流一句话结论.agents目录可以把 ChatGPT 的架构评审、Codex 的本地执行和 completion report 串成闭环AGENTS.md 则是 Codex 官方支持的仓库级自定义指令文件可记录项目规则、验证方式和完成标准。ChatGPTarchitecture-reviewscodex/inbox handoffCodex 执行codex/reportscodex/done1. 为什么需要.agents当项目只有一个人、一个聊天窗口时随便说一句“帮我改一下”可能够用。但长期项目不一样。长期项目需要回答谁提出的任务要改哪些文件验收标准是什么Codex 实际做了什么ChatGPT 怎么知道执行结果下一轮从哪里继续.agents的作用就是把这些问题文件化。2. 推荐目录结构.agents/ ├── README.md ├── chatgpt/ │ ├── README.md │ ├── instructions/ │ │ └── README.md │ └── architecture-reviews/ │ └── README.md └── codex/ ├── README.md ├── inbox/ │ └── README.md ├── done/ │ └── README.md └── reports/ └── README.md3. 每个目录放什么目录内容.agents/chatgpt/instructions/ChatGPT 生成的任务说明.agents/chatgpt/architecture-reviews/架构评审、ADR 草案.agents/codex/inbox/待 Codex 执行的 handoff.agents/codex/done/已完成 handoff.agents/codex/reports/Codex 执行报告4. Handoff 生命周期ChatGPT 生成任务 | v 写入 inbox | v 用户明确要求 Codex 执行 | v Codex 修改文件并验证 | v Codex 写 completion report | v ChatGPT 读取报告复审关键点进入 inbox 不等于自动执行。5. Handoff 模板建议模板# HANDOFF-0001: Repository Structure v0.2 ## Handoff ID HANDOFF-0001 ## From ChatGPT ## To Codex ## Date 2026-07-07 ## Status Pending ## Objective 说明这次任务要达成什么。 ## Scope 说明包含什么、不包含什么。 ## Instructions 列出具体执行步骤。 ## Files to Modify 列出预计修改文件。 ## Acceptance Criteria 列出验收标准。 ## Completion Report 未执行时写 Not executed。模板文件可以放在templates/agent-handoff-template.md6. Completion Report 怎么写建议报告格式# HANDOFF-0001 Completion Report ## Summary ## Files Changed ## Verification ## Git Status ## Not Done ## Next Steps报告必须让 ChatGPT 不看终端也能知道做了什么。改了哪里。怎么验证。还有什么风险。7. AGENTS.md 的作用.agents是任务流目录AGENTS.md 是 Codex 会在任务开始前读取的自定义指令文件。AGENTS.md 可以写仓库结构和重要目录。如何运行、测试和验证项目。修改前后的 Git 检查习惯。什么叫完成以及如何写执行报告。哪些内容不应引入当前任务。示例# AGENTS.md ## Repository Rules - Use the existing .venv. - Do not recreate the virtual environment. - Do not push to remote without explicit approval. - Write completion reports for handoff execution. - Do not introduce unverified business rules or architecture assumptions.8. 和治理文件的关系不要让 AGENTS.md 变成万能文档。推荐分工文件职责README.md项目入口、安装方式、常用命令docs/设计说明、教程、操作文档AGENTS.mdCodex 自定义指令、项目规则、验证方式.agents/代理任务与报告decision-log/决策、设计、里程碑9. 安全注意事项handoff 和报告里不要写token。API key。Cloudflare 临时完整 URL。私有客户信息。不能公开的本地路径。如果必须引用敏感配置用占位https://example.trycloudflare.com/mcp?codexpro_tokenredacted10. 推荐落地步骤创建.agents目录结构。给每个目录写 README。创建templates/agent-handoff-template.md。创建第一个 handoff但不要自动执行。用户明确要求后由 Codex 执行。Codex 写 report。ChatGPT 读取 report进入下一轮。11. FAQ.agents要不要提交到 Git如果它是项目协作流程的一部分建议提交。若里面有临时私密内容应拆分到 ignored 目录。handoff 进入 inbox 后 Codex 会自动执行吗不会。必须由用户明确告诉 Codex 执行。ChatGPT 怎么知道 Codex 的结果Codex 把执行报告写到.agents/codex/reports/ChatGPT 通过 CodexPro 或用户复制内容读取报告。12. 系列总结如果你正在搭建一套 AI 开发协作流程可以按下面顺序逐步落地让 ChatGPT 访问本地代码。理解 CodexPro、MCP、Cloudflare 链路。建立 ChatGPT Codex CLI CodexPro 工作流。用.agents和 AGENTS.md 固化长期协作规范。这就是 AI 工程治理的起点不是让 AI 随便改文件而是让 AI 的计划、执行、验证和复盘都有工程痕迹。13. 参考资料OpenAI Codex AGENTS.md guideOpenAI Codex best practicesOpenAI Codex MCP guideOpenAI Codex CLI featuresCodexPro GitHub README