改:可审阅修改
大约 2 分钟
第五章:改:用可审阅方式修改文件(小步、可回滚)
5.1 核心原则:你审阅的是“差异”,不是“解释”
任何自动化改动,最终都要落在差异上:
- 改了哪些文件
- 行为变化在哪里
- 风险点是否可控
- 是否能回滚
因此你应该把“先审阅再继续”变成默认路径:
每轮修改完成后先给出 diff,我审阅通过后再继续下一轮。5.2 小步改动:一次只改一个意图
最常见的翻车是混合主题:
- 修 bug 的同时重构半个模块
- 引入新依赖顺便改一堆配置
- 顺手格式化全仓库
更稳的方式是拆成多轮交付:
- 第一轮:最小修复/最小功能
- 第二轮:补测试与边界条件
- 第三轮:重构清理(可选)
每一轮都能通过验证命令,才允许进入下一轮。
5.3 禁止动作:把风险挡在最前面
如果你不写禁令,AI 很可能会“顺手优化”。建议你直接写进任务里:
禁止:
1) 新增依赖(除非明确要求)
2) 修改基础设施/部署目录
3) 全仓库格式化与大规模重命名5.4 改动摘要模板(便于审阅与协作)
除了 diff,你还可以要求结构化摘要:
请按以下格式总结改动:
1) 改动文件列表
2) 行为变化(用户可感知)
3) 风险点与回滚方式
4) 需要补的测试与原因5.5 本章小结
“改”想要稳,关键是:
- 小步:一次只改一个意图
- 可审阅:先 diff 再继续
- 可回滚:范围可控,不做扩散式编辑
下一章进入“验”:如何运行命令与查看诊断,把正确性变成可复现结果。
