一个月实践复盘 · 团队分享精简版
Codex 团队协作实践：提效方法与反面教训
从“让 AI 写代码”升级为“让 AI 参与调查、实施、验证和经验沉淀”。
Executive takeaway
核心结论
Codex 的真正价值，不只是更快写代码，而是缩短
“理解问题 → 制定方案 → 实施修改 → 真实验证 → 经验沉淀”的完整链路。
91近一个月文字任务
24活跃工作日
52排查与逻辑理解任务
34集中在 3 个父任务的子代理任务
数据用于观察协作方式，不等同于项目质量或最终业务收益。
What worked
五个有效做法
1. 先理解系统，再修改代码
先确认流程、判断条件、数据来源和影响范围。复杂系统中，找对修改位置比快速生成代码更重要。
2. 用现场证据代替模糊描述
日志、截图、录屏、接口响应、协议和复现步骤越完整，结论越可靠。
3. 把需求写成状态和异常分支
正常路径、异常路径、恢复条件和页面提示应在开发前明确，必要时先画状态机或验收表。
4. 把真实验证纳入完成标准
编译、安装、ADB 日志、设备操作和异常复测，才构成完整交付。
5. 把重复踩坑升级成规则
重复出现的问题，应沉淀为模板、技能、目录约束或完成检查项。
What failed
五个反面教训
1. 任务过短、依赖上下文
“看一下”“按图修改”不利于重开、转交和跨项目协作，附件失效后也难以复现。
2. 分析与实施授权混在一起
必须明确是只分析、先方案后实施，还是允许直接修改并验证。
3. 开发中持续追加核心需求
探索可以迭代，但实施前需要需求冻结点，否则返工和测试范围会持续扩大。
4. 小任务过度使用子代理
多代理会增加重复读取、结论冲突和汇总成本，只适合真正独立的并行调查。
5. 只检查生成，没有检查交付
还应检查目录、格式、验证证据、变更记录和未决事项是否完整。
Recommended workflow
推荐的团队协作流程
任务定界确认项目、目标、权限、范围和验收标准。
证据调查读取代码、日志、接口和现场材料。
方案冻结确认主流程、异常分支和验证计划。
实施验证修改代码，完成编译、安装和关键场景测试。
交付沉淀记录结果，并把重复经验升级为规则。
Copy & use
可直接复制的任务模板
【项目】项目名称和工作目录 【任务模式】只分析 / 先方案后实施 / 直接实施并验证 【目标】希望解决的具体问题 【证据】日志、截图、接口响应、复现步骤、相关文件 【范围】允许修改和禁止修改的内容 【权限】是否允许改代码、安装设备、执行 Git 操作 【验收】什么结果算完成 【交付物】代码、方案、测试结果、文档或变更记录
Team agreement
建议形成的团队约定
- 单模块任务默认不用子代理；独立调查方向一般控制在 2～3 个。
- Git 提交、推送和合并始终保留人工授权。
- 只读查询不强制生成文档；代码修改需要验证和变更记录。
- 正式方案保留 Markdown 与 HTML，并归档到正确目录。
- 长任务结束时固定输出：结论、改动、验证、未决事项、下次继续入口。
结语
人负责目标、取舍、授权和验收Codex 负责调查、执行、验证和沉淀。