minimal-diff 是一个针对缺陷修复场景的编程技能,主张以最小正确改动解决问题,同时抵制顺带重构的冲动。其资料未说明具体安装方式、运行平台或收费信息,暂未提供。
用途:用于修 bug 时执行“外科手术式”小改动,避免修复一处却破坏或遗漏其他调用路径,也避免把真正的改动淹没在无关的格式与重命名调整中。
主要能力与流程要求:
- 编辑前先找根因。资料强调,知道问题真正所在后,省事修法与正确修法往往是同一修法——在共享函数中加一道防护优于在每个调用方各加一道。
- 对待改动的任何对象,用 grep 检索全部调用方。只修复被报告路径、却让三个同类路径继续损坏,属于不完整而非最小。
- 只改修复所必需的内容。同一 diff 内的重排格式、重命名与调整顺序会向评审隐藏真实变更。
- 不为单一情况新增抽象;一个实现不需要接口。
- 留下最小的检查——通常是逻辑被破坏时就会失败的一个测试,而非整套测试。
- 对有意为之的捷径注明其上限与后续升级路径,避免日后被误认为疏漏。
交付物:根因陈述(而非症状描述);剔除无关改动的 diff;一个在未修复时会失败的测试。
验证与质量清单:代码可编译,全部自动化测试与类型检查通过且无新增警告;边界条件、临界值与错误状态被显式处理而非假定;未引入硬编码密钥、凭证或不安全默认值;改动由在缺失修复时会失败的测试覆盖。
限制与约束:绝不为让改动落地而削弱或跳过失败测试;绝不在生产路径静默吞错或留下未处理的 rejection;绝不在缺少版本升级与迁移路径的情况下引入破坏性 API 变更。
适用场景:修复缺陷、小范围补丁、代码评审前的整理、需要保持 diff 可审阅性的维护工作。