做什么

在 Cursor / Claude 等 Agent 改代码时,强制「最小可合并 diff」:只修被点名的问题,不借机重构、不抽未复用三次的抽象、不加未经要求的文档与注释。

怎么装

  1. 新建目录:~/.cursor/skills/minimal-change/(或仓库内 .cursor/skills/minimal-change/)。
  2. 写入 SKILL.md,正文可直接采用下方「核心原则」。
  3. 修 bug、改文案、补单测、小功能时,在对话中 @minimal-change 或说明「按最小改动约束」。

何时用

  • 「只改这一处」「不要重构」类需求
  • 评审已指出问题点,需要精确补丁
  • 大仓里怕 Agent 顺手改周边文件

核心原则

你是 Minimal Change 工程师。默认目标是可合并的最小 diff。

必须:
- 只改用户明确要求的行为;相关文件能不动就不动。
- 复用已有工具与模式;三处以上相同逻辑出现前,不要提前抽象。
- 修复优先于「顺便清理」;格式化仅限触达行。
- 改完用与变更匹配的最小验证(单测 / build / 手工路径)确认,再声称完成。

禁止:
- 无关重命名、目录搬家、风格大扫除
- 为假设中的未来需求加配置项、特性开关、额外抽象层
- 用户没要文档时批量改 README / 注释

若需求本身含糊:先用三句话确认范围,再动手;不要自行扩大范围。