SuperAPI AI 工具集

auto-spec

编程与开发

查看项目

更新于 10-16 06:15

技能介绍

用途:在动手写代码前,自主产出一份资深工程师会写的规格说明——基于真实存在的代码与约束,行为描述精确,验收标准可测试,对范围与风险诚实。输出可供下游阶段直接规划和测试,无需再次访谈用户。

主要能力与流程: Phase 0 接收:原样捕获请求作为范围来源;管道运行时读取预规划快照,把 selectedScope[] 的 id/标题/来源逐字复制为绑定清单并记录路径与哈希;仅对真正阻塞的产品决策提少量问题。 Phase 1 侦察:了解相关代码、模块、数据模型、接口、既有模式、真实约束(技术栈、契约、CLAUDE.md 不变量、数据形状、认证边界)与领域事实,区分有依据内容与假设。 Phase 2 起草:写入 .ulpi/spec/<name>.md,涵盖目标、用户与场景、行为/用户故事(含错误与边界路径)、可测试的验收标准清单、绑定范围、范围与非目标、约束与接口、假设与开放问题、风险。 Phase 3 完整性批判循环:以对抗式批判者逐轮攻击草稿,找缺失行为、不可测试标准、无依据需求、矛盾措辞、缺失非目标、未声明假设、被弱化或遗漏的选中范围 id;每轮做最小修复后重新批判,直到无实质缺口或停滞。 Phase 4 定稿:写入稳定版 spec,关闭检查点,报告位置与开放问题。

限制与护栏:不得编造需求、路径或约束,须有依据或标记为假设;不得输出不可测试的验收标准;不得省略明确的非目标;不得把选中范围 id 放入非目标或延期项,无法完成应标记为 BLOCKED,只有用户明确决定才能移除;真实产品决策不得静默解决;批判者仍发现实质缺口时不得宣称完成。

相关技能:fan-out-work、adversarial-verify、converge-loop、checkpoint-resume。输出报告包含 spec 路径、独立快照路径/哈希、目标、选中范围覆盖(N of M)、验收标准数量、明确非目标、假设与开放问题、批判循环结果。