codex多agent协作新手项目落地实践

起点：一句话的设想

事情开始于一个很朴素的想法。

我在用 Codex 开发一个高校 EdTech 系统（管理端 + 学生端，角色权限、活动、提交、审核那一套）。手动一个人写很累，我就想：能不能让 Codex 里跑几个 agent，各司其职、自己协作？

我脑子里的分工特别清楚：

• 产品 agent 只看功能设计；
• 研发 agent 按设计开发，做完自己丢给测试；
• 测试 agent 按用例测，不合格提 bug 给研发，合格提给产品做验收（DC）。

听起来很顺。但真正动手，我才发现：让 agent 各自干活不难，难的是让它们"协作得住"——不丢状态、不打架、不失控、能真交付。这篇就是把踩过的坑和想通的地方，完整记一遍。

第一个顿悟：原生多 agent，不是我要的那种协作

我一开始以为直接用 Codex 的原生 subagent 就行。查下来才明白：它是"并行扇出"型的——主 agent 一次性派出多个子 agent 并行干活、汇总结果，然后子 agent 就销毁了。子 agent 之间没有持久的相互通信，跑完即焚。

可我要的是"串行 + 回环"：产品→研发→测试，测试不过要打回研发反复修，过了再到产品验收。这是一条带状态、要来回 ping-pong 的流水线。

原语错配。用"并行扇出"硬套"串行回环"，只会得到一堆丢了上下文、各说各话的 agent。

想通这点，方向就变了：不靠 agent 互相调用来协作，而靠"产物文件 + 状态机 + 驱动脚本"做异步协作。agent 不需要记住彼此，它们围着一组共享文件工作。

把"记忆"换成"文件"

多模块项目还有个绕不开的问题：上下文会溢出、会遗忘。模块一多，agent 跑着跑着就忘了前面的约定、重复生成已有代码、和早先的决定自相矛盾。

我的解法是一条原则：凡是要被记住的，都写进文件，不靠