[!info] related notes

• 所属 MOC: AI MOC
• 前置概念: Karpathy Guidelines Skill
• 易混淆概念: AI Code Review 与 AI 重构
• 关系笔记: Matt Pocock Skills 与 Karpathy Guidelines 的区别

Surgical Changes

一句话定义

改动应尽量小而准，每一行 diff 都应该能直接追溯到用户请求或修复目标。

核心机制 / 工作原理

AI 改代码的风险常常不是“目标没改对”，而是“顺手把无关部分也改了”。最小 diff 能降低隐性回归、降低 review 成本，也更方便定位问题。

最小例子 / 最小场景

修复空 email 导致校验器崩溃时，修改相关校验并补必要的回归验证，不顺手改无关注释、格式和相邻逻辑。

边界与易混淆点

• 不是永远禁止重构，而是无关重构不该夹带在一次小任务里
• 如果旧实现本身就是 bug 根源，必要范围内的结构调整仍然合理
• 清理本次修改造成的未使用导入、变量和函数；原有无关死代码另行记录，不混入当前任务
• 小 diff 降低审查成本，但本身不证明行为正确

Related notes

• AI MOC
• Agent MOC
• Coding Agent MOC
• Goal-Driven Execution