SuperAPI AI 工具集

superspec-plan

通用与其它

查看项目

更新于 10-16 06:50

技能介绍

用途:当 OpenSpec 变更已有 proposal/specs、需要产出规划产物时使用,只负责 design 与 tasks 两类产物,不扩展范围。

主要能力:通过 openspec CLI(禁止 /opsx、/openspec 斜杠命令)驱动流程,所有调用优先加 --json。先确定变更:用户给出名称则直接使用,否则运行 openspec list --json 让用户确认;无变更时停止并提示先运行 /superspec-research。随后循环检查 openspec status --change <change> --json,判断 design、tasks 是否 ready/complete/blocked。design 就绪时运行 openspec instructions design --change <change> --json,读取 proposal 与 specs/**/spec.md,按模板写入 outputPath;tasks 就绪时运行 openspec instructions tasks --change <change> --json,读取 design.md 与 delta specs 后写入。

tasks.md 硬性要求:仅允许 - [ ] X.Y <task> 形式的复选框任务,按依赖排序、可独立验证,不得有段落或标题。TDD 规则:对每个 #### Scenario 生成 5 条任务(RED、VERIFY_RED、GREEN、VERIFY_GREEN、REFACTOR),Verify Command 依次取 Scenario 的 Test Obligation、design.md 的 Test Commands,否则停止询问。仅 docs、纯配置、生成物、格式化/重命名可用 [NON-TDD],每条生成 DO 与 VERIFY 两条,VERIFY 必须机械化。

限制:design 或 tasks 因缺少 proposal/specs 被阻塞时停止并指向 /superspec-research;其他阻塞原因需展示 JSON 并询问;outputPath 非具体路径时停止并展示完整 JSON;JSON 结构不明时不得猜测。每次输出需显示 Selected change 与写入路径,出错时展示失败命令。