SuperAPI AI 工具集

principle-sequence-verifiable-units

编程与开发

查看项目

更新于 10-28 16:16

技能介绍

用途

该技能适用于多步骤工作(批量修改、迁移、一连串同类编辑),也适用于如何堆叠提交(commit)与 PR。它要求把工作排成一系列小单元,每个单元以一个可检查的状态结束,并且在声明的检查通过之前不推进到下一个单元。

对于耦合的迁移,可调用 /principle-migrate-callers-then-delete-legacy-apis 来定义单元和中间关卡。

为什么这样做

在导致问题的那个单元处发现的断裂,定位成本很低。而在一个批次之后才发现的断裂会被埋没,并且你已经在有问题的基线上继续构建了更多内容。把这些单元按顺序组织成评审者可以重放的交付过程,就能把“相信我”变成“看它先红,再变绿”。

执行方式

在批量修改、迁移或任何一连串同类编辑中,在开始依赖工作之前,先在声明的关卡处验证每一处改动。每个单元是一个“前/后”括号:已知良好状态、一次改动、运行检查,然后继续。使用调用工作流的已验证基线,包括一个集成修订版本;保留无关工作和现有的分支归属。当某个杠杆(工具/脚本)执行编辑时,逐单元检查几乎不花成本,但仍要运行它。

交付方式

按能证明工作的顺序堆叠提交与 PR。典型形态是先有失败测试,然后在其上放修复。其他叙事顺序包括:在重塑之前先做减法、在处理之前先捕获基线、在功能之前先搭脚手架。中间的证明性提交可以显示为红色;被检查的交付单元包含修复。独立落地的单元必须通过其验收关卡。

与其他原则的关系

该原则是 /principle-prove-it-works 的排序补充,后者保证每个检查都是真实的;也是 /principle-build-the-lever 的补充,后者让逐单元检查变得廉价。