SuperAPI AI 工具集

principle-sequence-verifiable-units

编程与开发

查看项目

更新于 11-06 21:01

技能介绍

用途

本技能用于组织多步骤工作,把任务切成一个个可验证的小单元,并规定提交与 PR 的堆叠顺序。资料明确其适用对象包括:批量扫描(sweeps)、迁移(migrations)、一连串相似编辑(runs of similar edits),以及如何堆叠提交和 PR。

主要能力

  • 将工作排成小单元序列,每个单元以一个可检查的状态结束。
  • 当前单元未通过检查(green)之前,不推进到下一个单元。
  • 在执行层面,每个单元都是一个 before/after 括号:已知良好状态、一次改动、运行检查、然后继续。
  • 在交付层面,按能证明工作有效的顺序堆叠提交和 PR,典型形态是先放失败测试、再在其上放修复;其他叙事顺序包括重塑前先做减法、处理前先捕获基线、功能前先搭脚手架。
  • 每个提交可独立落地,整个序列读起来像一条论证。

使用方式

资料给出的执行要点:

  1. 每个会话开始前读取一次宿主适配器(host adapter),它把上游 Cursor 专用的工具、模型、路径和权限说明映射到当前宿主,并设定权限边界。
  2. 在批量扫描、迁移或任何相似编辑序列中,开始下一个改动前先验证当前改动。
  3. 先 rebase 到干净主干,使每次检查都针对真实基线。
  4. 当某个杠杆(lever)批量完成编辑时,逐单元检查几乎不增加成本,但仍应执行。

适用场景

资料明确点名:批量扫描、迁移、一连串相似编辑,以及提交和 PR 的组织与堆叠。

限制与说明

资料未提供安装命令、价格、平台支持范围或具体工具命令。技能说明中提到的宿主适配器为必需前置步骤,其具体内容需按宿主环境映射。该技能与 prove-it-works 原则技能(保证每次检查真实)和 build-the-lever 原则技能(让逐单元检查成本低廉)互补。