Codex 改完代码后怎么交给同事 Review？
很多团队已经能让 Codex 改代码，但卡在交付环节：同事打开 diff，只看到一堆文件变化，却不知道任务边界、验证命令和风险点。让 Codex 参与开发，不代表 Review 可以省掉；更稳的做法是把 AI 修改过程整理成可复查的交接材料。
适用场景：代码已经改了，但还没进入 Review
这篇适合让 Codex 修改前端页面、接口逻辑、静态 SEO 页面、自动化办公脚本或内部工具后，准备把结果交给同事复核的场景。如果你还在第一次任务前确认环境，先看 第一次让 Codex 改项目之前要检查什么。如果问题是大仓库里如何限制修改范围，可以配合 大项目里怎么让 Codex 只改该改的文件 使用。
交接目标：让 Review 人不用猜你的意图
Review 说明至少回答五件事：为什么改、改了哪些入口、怎么验证、哪些地方没改、失败时怎么回退。不要只把 Codex 的最终总结粘进去，也不要把聊天记录全贴给同事。好的交接应该像一次人工开发的 PR 描述，把 AI 参与过程压缩成可执行证据。
操作步骤：生成一份可复查的 Review 包
1. 先列变更范围，而不是先讲效果
让 Codex 输出按文件分组的变更说明：页面、接口、配置、测试、文档分别改了什么。可用命令包括 git diff --stat、git diff --name-only、rg "新增字段名" src tests。如果当前环境没有 git，也要列出本次新建和修改的文件路径。交接里明确哪些文件是人工已有改动，哪些是本次 Codex 生成，避免同事误以为全部是同一轮改动。
2. 把验证命令写成结果记录
“已测试”没有信息量。更好的写法是列命令、运行时间、结果和失败项，例如 npm test 通过，npm run build 因缺少某个环境变量未执行，页面截图检查通过。静态页面还应记录 canonical、JSON-LD、sitemap、robots 和中文乱码检查。涉及开发者 AI 调用时，补充模型名、request_id、响应状态码和日志字段，方便后续模型调用管理追溯。
3. 把风险点单独列出来
Codex 很容易把实现讲得很顺，但 Review 人真正关心的是风险。比如是否改到权限判断、是否影响缓存键、是否增加 AI API 调用次数、是否改变 CCSwitch 默认模型、是否修改数据库字段。涉及命令、部署或远程同步的任务，可以参考 让 Codex 执行命令前怎么确认风险，把只读、本地写入、远程变更分开。
4. 说明回滚点和未完成项
交接不是只汇报完成，也要说清楚可以怎么退回。小改动可以说明回滚文件；较大任务要记录旧配置、旧页面截图、旧接口响应或备份路径。未完成项也要写得具体，例如“移动端 360px 截图未验证”“接口超时分支缺少真实样本”“AI 自动化办公导入模板还没接生产数据”。这比一句“后续优化”更能帮助同事判断是否可以合并。
常见问题/避坑：不要让 Codex 自己宣布可以合并
第一个坑是把 Codex 的总结当成 Review 结论。模型可以整理证据，但是否合并必须由负责人判断。第二个坑是只展示成功命令，不展示没跑的命令和原因。第三个坑是没有保留截图、响应样本和日志片段，导致线上出问题后无法回看。第四个坑是把多个搜索意图混在一个 PR：既改 Codex 接入，又改 AI API 接入，又改自动化办公页面，Review 人很难把风险拆开。
如果你需要验收功能本身，可参考 Codex 改完功能后怎么做验收才不容易漏问题；如果是提示词版本造成结果变化，则回看 Codex 提示词改坏了怎么回滚。Review 交接关注的是协作证据，而不是再次讨论模型会不会写代码。
实际交接时，还可以附一段“我希望你重点看哪里”。例如权限判断、异常提示、移动端样式、AI API 调用次数、日志是否泄露敏感字段。这样 Review 人能先看高风险区域，再看普通实现。若同事发现问题，也要求按文件、现象、复现步骤反馈，而不是只写“这里不太对”。Codex 可以继续协助修正，但每次修正都要追加验证记录，避免第二轮改动覆盖第一轮已经验收的结论。
检查清单：发给同事前过一遍
- PR 或变更说明是否写清任务背景、范围和不做的内容。
- 文件列表是否区分本次 Codex 修改、人工已有改动和生成产物。
- 验证命令是否有结果，未执行的命令是否说明原因。
- 风险点是否覆盖权限、配置、缓存、成本、日志和回滚。
- 截图、接口样本或日志是否足够让 Review 人复核。
- 最终说明是否避免“保证没问题”这类无法验证的判断。
复盘标准：Review 人能复现你的判断
一份合格的 Codex Review 交接，不要求同事阅读完整对话，但要求他能沿着文件、命令和证据复现你的判断。永沃云枢建议把这类交接模板沉淀到团队文档里，和 Codex 安装专题、AI API 接入专题、CCSwitch 配置专题 一起维护。这样 https://ai.jn83.com 上的工具接入经验，才能从个人技巧变成团队流程。