代码审阅与变更处理
代码审阅把助手的执行结果变成可以逐项判断的修改。先确认审阅对象,再检查文件、差异块和验证结果;阅读进度、提交范围和远程 PR 状态分别处理。
先确定你在看什么
| 对象 | 判断依据 |
|---|---|
| 本地工作区差异 | 当前目录中的文件、Git 状态和差异内容 |
| 远程 PR 差异 | 该 PR 的目标分支、实际提交和远程补丁 |
| 验证结果 | 对应提交或工作区运行的命令、输出及失败信息 |
远程 PR 的只读差异不作为本地提交范围。比较远程补丁时,不把工作区中同名文件的内容当成该 PR 的原始上下文。
按文件和差异块检查
打开编程工作区的变更视图,核对新增、修改、删除和未跟踪文件。先判断每个文件是否属于任务,再读具体差异块。对改名、删除、配置和依赖变更,检查调用方与构建过程是否同步。
审阅时重点检查:
- 修改是否解决实际触发路径,而非只改变表面文案或隐藏错误。
- 原有加载、失败、恢复及权限分支是否保留。
- 测试是否证明行为,断言、阈值与检查是否被削弱。
- 密钥、日志、生成文件及其他任务的改动是否混入。
处理意见与提交范围
本地列表将工作区与暂存区合并展示;勾选框表达提交范围,不另设一套手动暂存流程。取消全部勾选会留下空提交范围,不能据此发起空提交。文件的已读状态只记录阅读进度,与勾选范围无关。
把意见对应到具体文件、差异块和复现条件。让助手修正后刷新差异,并重新验证受影响的路径。已读标记表达审阅进度,不代替测试,也不代表同意提交。
本地提交前核对所选文件与差异块。没有可提交的变更或未选择范围时,先完成选择,不用空提交表示任务完成。提交结果、推送结果和 PR 审批分别检查。
丢弃与恢复
丢弃会影响本地文件。操作前确认范围,保存需要保留的工作,并区分任务生成的修改与用户原有修改。对来源不明的差异先核对,不执行全仓重置。
遇到差异过期、目录切换或读取失败时,重新确认工作区并刷新。验证完成后再次检查 Git 状态;不能使用旧截图或旧提交的通过结果确认新修改。
与 Evolver 审核的区别
本页审阅的是代码差异。evolver review 审核候选 Gene;候选资产获准不等于代码获准、测试通过或发布获准。对应流程见审查与验证。
处理超大差异与远程 PR
发现截断提示时,按文件缩小范围;只有已完整取得的本地补丁才能继续展开上下文。远程 PR 是只读审阅对象,核对 base 与 head 后阅读远端补丁,不能把本地同名文件直接当作远端上下文,也不能把远程已读标记当作 GitHub 审批。
| 操作 | 操作后核对 |
|---|---|
| 刷新 | 文件与差异块是否对应刚完成的修改 |
| 更改勾选 | 提交范围是否只包含本次任务 |
| 修正反馈 | 原触发条件是否消失,相关检查是否通过 |
| 丢弃改动 | 影响文件与范围是否明确,所需内容是否已保存 |