CODEXGUIDE / 04 / 验收结果
修改后如何验证：从 diff 到回归检查
建立 Codex 修改后的验证顺序，覆盖 Git diff、测试、构建、页面检查和无法验证的部分。
验证顺序
- 先看 git diff 和 git status，确认范围没有扩大。
- 运行与任务对应的最小测试或检查。
- 需要时再运行构建、页面验证或更宽范围回归。
- 记录成功、失败和无法验证的部分。
故障分类矩阵
先按可观察证据分类，再选择修复动作。不要用扩大权限、删除缓存或大范围重构来掩盖根因。
| 症状 | 优先检查 | 证据 | 下一步 |
|---|---|---|---|
| 命令被拒绝 | 工作区、sandbox、审批 | 命令与权限提示 | 缩小范围或请求明确批准 |
| Git diff 为空 | 路径、分支、worktree | git status --short --branch | 回到实际修改的工作区 |
| 测试失败 | 基线、依赖、代码 | 完整命令和错误 | 最小复现并比较基线 |
| 构建通过但页面错误 | 路由、浏览器、交互 | 页面行为和控制台 | 补做浏览器验证 |
| 环境命令不存在 | 终端、PATH、版本 | 版本输出和当前目录 | 统一执行环境后重试 |
不要只看 Codex 的完成提示
完成提示不是验收结果。验收必须有命令输出、页面行为、测试结果或人工检查证据。
验证失败怎么办
先保留失败现场，不要立刻删除缓存或改成 Full access。进入权限、Git 与验证失败 FAQ查看对应分支。