查看改动差异并运行测试复核

代理完成改动后，人工复核差异（diff）并运行验证是不可省略的交付闸门。本节给出固定复核流程与审查清单，教你用版本控制核对改动范围、判断是否夹带冗余修改，并用测试与运行结果确认行为。提交始终由人决定。

一、复核四步法

1. 看改动范围：先 git status 确认变更文件数量与路径，是否与任务约定清单一致。
2. 逐段看差异：再 git diff 阅读每处增删，确认每段修改都服务于原目标。
3. 对照改动说明：把代理给出的汇总与实际差异比对，防止"说明做了 A、代码改了 B"。
4. 运行验证：执行项目测试/构建/启动命令；把失败输出带回会话修复，直到通过。

二、diff 审查清单

检查项	重点判断
范围一致性	是否多出未授权文件、是否改到清单外模块
意图对齐	每处增删是否对应原始目标，有无顺手重构、改名、调整逻辑
错误处理	新增分支是否处理空值、异常与边界输入，有无吞错误
测试影响	是否删除/弱化已有断言，测试是否覆盖新逻辑的正常与异常路径
安全敏感点	是否引入拼接命令、硬编码密钥、未校验外部输入（安全章节详述）
可回退性	改动是否小而集中、便于用版本控制撤销

三、用测试与运行结果做客观验证

• 先跑项目既有的测试/构建命令（以项目配置中记录的命令为准），不要只凭"代码看起来对"就接受。
• 失败时保留完整报错，回贴到会话要求定位根因；要求先补复现问题的最小用例再修复。
• 涉及界面或功能行为时，启动应用走一遍关键路径做人工确认；纯逻辑改动以测试结果为主证据。
• 验证通过前不合并、不发布；验证证据（测试输出、检查结果）随改动一起保留便于回溯。

四、接受、修正与回退

结论	动作
验证通过且范围干净	由你本人按项目规范提交，提交信息概括目标与改动要点
有小问题	在会话中指明文件、位置与期望结果，修正后重新走"看 diff + 跑测试"
方向错误或夹带过多	用版本控制回退本次改动（如 git restore .，按项目仓库状态选用对应命令），重新给更聚焦的任务

# 1. 查看变更文件与差异
git status
git diff

# 2. 验证：执行项目测试/构建（以本项目实际命令为准）

# 3. 确认无误后由人提交；不满意先回退再重来
git add .
git commit -m "feat: 本次目标简述"

五、FAQ

问题	处理建议
diff 很长怎么审	先看 status 文件清单与统计，再按文件分批阅读；优先审查新增逻辑、异常分支与被删除代码。
测试通过就可以直接接受吗	测试通过只覆盖被断言的部分，仍需核对范围一致性与安全敏感点。
代理说"已完成"但没跑测试	不接受口头完成结论；要求给出可运行验证结果，未验证不计交付。
发现夹带重构	要求还原无关改动、只保留目标修改；把重构另立任务，不混入当前提交。

六、动手练习

• 练习：对一次代理改动依次执行"status → diff 对照 → 测试 → 决策"，用清单逐行勾选，记录发现的越界项并练习最小回退。