SuperAPI AI 工具集

principle-sequence-verifiable-units

编程与开发

查看项目

更新于 10-16 05:39

技能介绍

用途

该技能用于多步骤工作,例如批量清扫(sweeps)、迁移(migrations),以及一连串相似改动的执行;也用于如何堆叠提交(commits)与 PR。核心要求是把工作排成一系列小单元,每个单元结束在一个可检查的状态上,当前单元未变绿之前不要推进。

理由

在造成破坏的那个单元处发现问题,定位成本很低;等到一批改动结束后才发现问题,问题会被埋没,而且此时已经在坏的基础上继续叠加了工作。把这些单元排成一条审查者可以重放的交付序列,就能把“相信我”变成“看它先变红,再变绿”。

执行方式

在清扫、迁移或任何连续相似改动中,先验证每一次改动,再开始下一次。每个单元是一个 before/after 括号:已知良好状态、一次改动、运行检查,然后继续。先 rebase 到干净的 trunk 上,使每次检查都针对真实基线进行度量。当某个杠杆(lever)自动完成改动时,逐单元检查几乎不花成本,即便如此也要运行它。

交付方式

按能证明工作的顺序堆叠提交与 PR。典型形态是先有失败的测试,再把修复叠在其上。其他叙事顺序包括:重塑之前的减法、处理之前的基线捕获、功能之前的脚手架。每个提交都能独立落地,整条序列读起来就像一个论证。

与其他原则技能的关系

该技能是 prove-it-works 原则技能的排序补充:后者保证每次检查是真实的;它也是 build-the-lever 原则技能的补充:后者让逐单元检查变得低成本。

限制

资料未提供该技能的具体安装命令、支持的平台、是否收费及价格信息,暂未提供。