[!info] related notes

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

Surgical Changes

一句话定义

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

核心机制 / 工作原理

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

最小例子 / 最小场景

修复空 email 导致校验器崩溃时，只改空 email 分支，不顺手重写注释、格式、相邻校验逻辑和 docstring。

边界与易混淆点

• 不是永远禁止重构，而是无关重构不该夹带在一次小任务里
• 如果旧实现本身就是 bug 根源，必要范围内的结构调整仍然合理

Related notes

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