SuperAPI AI 工具集

principle-sequence-verifiable-units

编程与开发

查看项目

更新于 11-01 16:53

技能介绍

用途

该技能面向多步骤工作:批量扫描(sweeps)、数据或代码迁移、一连串相似修改,以及提交与 PR 的组织方式。它并不提供一个工具或脚本,而是一条工作原则:把工作排成按顺序执行的小单元。

主要能力(原则要点)

  1. 小单元划分:每个单元都结束在一个可以检查的状态。
  2. 不提前推进:当前单元未通过检查(未变“绿”)之前,不开始下一个单元。
  3. 断裂定位成本低:在导致断裂的单元处发现问题,定位成本低;整批结束后才发现,问题容易被掩盖,而且已经在不稳固的基础上继续构建。
  4. 可复现交付:把单元按顺序组织成评审者可以复现的交付序列,把“相信我”变成“看它先变红,再变绿”。

使用方式

执行层面:在批量扫描、迁移或任何连续同类修改中,每次修改后先验证,再开始下一次。每个单元是一个前后括号:已知良好状态 → 一次修改 → 运行检查 → 继续。先变基到干净主干,使每次检查都对照真实基线。即使由工具完成编辑、逐单元检查几乎不增加成本,也仍要执行检查。

交付层面:按能证明工作的顺序堆叠提交与 PR。典型形态是先写失败测试,然后在其上修复。其他叙事顺序包括:先删减再重塑、先采集基线再处理、先搭脚手架再实现功能。每个提交都能独立落地,整个序列读起来像一条论证。

适用场景

  • 批量修改、批量扫描、迁移脚本。
  • 一连串相似编辑。
  • 组织提交历史与 PR 堆叠,使评审者能逐步复现。
  • 需要先建立基线再施加改动的实验或处理流程。

与其他原则技能的关系

该技能是“证明它有效”(prove-it-works)原则技能的排序补充:前者保证每次检查是真实的,后者让逐单元检查成本低廉。三者配合使用时,检查真实、成本低、顺序可验证。

限制

该技能是原则性指导,未提供具体工具、命令、代码或自动化实现;实际检查方式、工具链与提交规范需由使用者自行确定。文本未说明适用的编程语言、平台或团队规模。