SuperAPI AI 工具集

spec-execution

编程与开发

查看项目

更新于 10-15 21:38

技能介绍

用途:把一个 specs/*.md 规格文档按波次(wave)方法落地实现。每个波次是一个可验证的检查点:结束后仓库应能构建、相关测试通过,规格需反映当前真实状态。触发语包括“execute this spec”“implement this plan”“run the spec”等。

使用方式:先做预检(spec 状态、是否被更新规格取代、目标与验证方式、阻塞性开放问题),再通读活动路径而非附录历史;然后把实施计划拆成波次,判断任务并行还是串行:改动不同文件可并行,有导入依赖、修改同一文件、跨阶段或阶段内相互依赖则串行。每个波次执行任务(可用子代理,但主代理负责编排、整合、验证、更新规格与提交),随后运行 bun typecheck 与 bun test(如适用)验证,勾选规格中完成项并记录偏差,再按评审粒度提交或设检查点。提交需同时包含代码改动与对应的规格更新,使用具体文件暂存,禁止 git add . 或 git add -A。

适用场景:有明确规格与实施计划、需要分阶段可回退落地的开发工作。限制:仅按规格事实执行,遇到产品决策、破坏性操作、大范围重构或与现有代码冲突时才询问用户;波次不宜过大(超过 5-8 个文件需重新评估);子代理并行数建议控制在 3-4 个以内。最终需用 post-implementation-review 复核,将持久决策写入 docs/adr/,运行 bun scripts/check-doc-hygiene.ts,并用 git rm 删除已完成规格。技能未提供具体收费、价格或平台信息。