SuperAPI AI 工具集

superspec-research

编程与开发

查看项目

更新于 10-16 06:50

技能介绍

用途:为 Superspec(superspec-rpi)OpenSpec 变更生成提案(proposal)与规格(specs)研究产物,范围仅限这两类工件。

主要能力与规则:必须仅通过 openspec CLI 驱动,禁止使用以 /opsx 或 /openspec 开头的斜杠命令;支持 JSON 输出的调用优先加 --json;若某命令不支持(如 openspec new change),则不带 --json 运行,再继续下一个支持 JSON 的命令(通常是 openspec status --change <change> --json)。

变更选择:用户给出变更名则直接使用;否则运行 openspec list --json 并请用户确认;无变更或需新建时,询问 kebab-case 变更名与一句话描述,然后运行 openspec new change <change> --schema superspec-rpi --description "<description>"。始终打印 Selected change: <change>。

工件循环:反复执行直到 proposal 与 specs 均 complete。先运行 openspec status --change <change> --json 判断状态;若 JSON 结构不明,展示 JSON 并询问用户,不得猜测。若 specs 因缺少 proposal 被阻塞,先创建 proposal。proposal 就绪但未完成时,先按 skills/superspec-brainstorm/SKILL.md 做澄清(期间不运行 openspec、不写文件),产出 Brainstorming Notes 后再写 proposal.md。随后运行 openspec instructions proposal --change <change> --json,从 JSON 取 outputPath 与模板写入;outputPath 非具体路径则停止并展示 JSON。specs 就绪后运行 openspec instructions specs --change <change> --json,按 proposal 的 Affected Specs 生成具体文件 specs/<kebab-name>/spec.md,不得写通配路径。每个 delta spec 需含 ADDED/MODIFIED/REMOVED Requirements,使用 MUST/SHALL 规范语言,并为每条需求提供 Given/When/Then 场景(含正常路径与边界/失败用例),每个 Scenario 必须带 Test Obligation 块(Type、Test File、Test Name、Verify Command、Expected (RED)、Key Assertions),字段缺失须询问用户。写完后重新运行 status,两者 complete 才停止。

限制:仅限 proposal 与 specs 工件;错误时须展示失败的确切命令(含 --json);不得猜测 JSON 字段。