用途
本原则用于指导工作的切分与推进节奏,尤其适合以下两类场景:一是清扫(sweep)、迁移(migration)或任何一连串相似改动的执行;二是为一个分支的提交顺序、以及一叠拉取请求(pull request stack)排序。它的目标是让每一步都停在一个可被检查确认的状态上,从而让问题在产生处就被发现。
主要能力
- 小单元推进:工作被拆成小单元,每个单元以一次检查可确认的状态收尾,当前单元通过后下一个单元才开始。
- 降低定位成本:在制造问题的那个单元发现断裂,定位成本低;若在一批之后才发现,问题会压在已经建立在其上的工作之下。
- 单元即括号:把每个单元框定为“已知良好状态 → 一次改动 → 检查 → 下一个单元”。
- 相似改动的逐个检查:在一连串相似改动中,每完成一次改动就检查一次,再开始下一次。
- 脚本场景同样检查:当由脚本执行改动时,每个单元的检查成本几乎为零,但仍要运行。
- 提交与拉取请求排序:让历史为工作本身提供论证,例如减法先于它为之让路的重塑、基线捕获先于与之对比的处理、脚手架先于功能。
- 提交独立成立:每个提交单独检出时都能通过门禁。
- 证据保留:失败运行的输出按其所在树的哈希作为证据保留,测试与其修复落在同一个提交中。
使用方式
按单元推进工作:先确认一个已知良好的状态,再做一次改动,然后运行该单元的检查;绿了之后才进入下一单元。检查的形式是切片范围内的窄范围测试运行。提交层面,按能自证其理的顺序排列提交和拉取请求栈,保证每个提交单独检出时通过门禁。在某次运行失败时,保留其输出作为证据,并把测试与修复放进同一个提交。
适用场景
- 清扫式改动、迁移或任何一批相似编辑的执行过程。
- 分支内提交顺序的编排与拉取请求栈的组织。
限制与边界
单元的检查是切片内的窄范围测试运行;完整门禁只在切片的提交处运行一次(在已声明的阶段内,则在该阶段的最后一个提交上),通过 verify 执行,本原则绝不在中间插入完整运行。该原则依赖且不替代其他实践:每个检查背后的证明属于 principle-prove-it-works 原则,清除无用负担的减法遵循 principle-subtract-before-you-add 原则。关于其具体安装方式、命令或平台支持,资料中暂未提供。