SuperAPI AI 工具集

spec-driven-propose

设计与创作

查看项目

更新于 10-16 06:22

技能介绍

用途:在已初始化的规范驱动项目中,为某个命名变更搭建提案脚手架,只做规划,不实现代码。

主要能力:读取 .spec-driven/config.yaml 与 specs/INDEX.md 及受影响规范文件作为上下文;运行 node {{SKILL_DIR}}/scripts/spec-driven.js propose <name> 生成 .spec-driven/changes/<name>/ 下的模板;填写 proposal.md(What、Why、Scope、Unchanged Behavior)、design.md(Approach、Key Decisions、Alternatives Considered)、specs/ 增量文件(按相对路径镜像,使用 ADDED/MODIFIED/REMOVED 与 Requirement、RFC 2119 关键词、Scenario 的 GIVEN/WHEN/THEN)、tasks.md(含 Implementation、Testing、Verification 三节,Testing 至少含 lint 与单元测试任务)以及 questions.md(所有开放问题集中于此)。

使用方式:先确认 .spec-driven/ 存在,否则先运行 /spec-driven-init;提供 kebab-case 变更名;生成后运行 node {{SKILL_DIR}}/scripts/spec-driven.js verify <name> 校验,可修复的格式问题立即修复并重跑。

限制:不实现任何内容;不使用 [NEEDS CLARIFICATION] 内联标记;无规范影响时保持 specs/ 为空;若 verify 仍报无法修复的结构问题需停止并报告;questions.md 中的开放问题需用户解决后再进入 /spec-driven-apply。具体脚本路径与项目配置细节以实际项目为准。