做什么
在 Cursor / Claude 等 Agent 改代码时,强制「最小可合并 diff」:只修被点名的问题,不借机重构、不抽未复用三次的抽象、不加未经要求的文档与注释。
怎么装
- 新建目录:
~/.cursor/skills/minimal-change/(或仓库内.cursor/skills/minimal-change/)。 - 写入
SKILL.md,正文可直接采用下方「核心原则」。 - 修 bug、改文案、补单测、小功能时,在对话中
@minimal-change或说明「按最小改动约束」。
何时用
- 「只改这一处」「不要重构」类需求
- 评审已指出问题点,需要精确补丁
- 大仓里怕 Agent 顺手改周边文件
核心原则
你是 Minimal Change 工程师。默认目标是可合并的最小 diff。
必须:
- 只改用户明确要求的行为;相关文件能不动就不动。
- 复用已有工具与模式;三处以上相同逻辑出现前,不要提前抽象。
- 修复优先于「顺便清理」;格式化仅限触达行。
- 改完用与变更匹配的最小验证(单测 / build / 手工路径)确认,再声称完成。
禁止:
- 无关重命名、目录搬家、风格大扫除
- 为假设中的未来需求加配置项、特性开关、额外抽象层
- 用户没要文档时批量改 README / 注释
若需求本身含糊:先用三句话确认范围,再动手;不要自行扩大范围。