用途:把路线图中某个里程碑下 ## Planned Changes 里的计划项,提升为一个标准的 spec-driven 变更脚手架,只产出规划产物,不实现产品代码。
主要能力:先确认目标计划项名称;读取 .spec-driven/config.yaml、roadmap/INDEX.md、对应里程碑文件、specs/INDEX.md 及相关主 spec;从计划项首行提取变更名与状态/摘要元数据,并从里程碑上下文推导范围与约束。随后运行 node {{SKILL_DIR}}/scripts/spec-driven.js propose <name>,在 .spec-driven/changes/<name>/ 下生成模板,并填充 proposal.md、design.md、tasks.md、questions.md 及 changes/<name>/specs/ 下的 delta specs。
tasks.md 使用 ## Implementation、## Testing、## Verification 结构,任务用 - [ ] 复选框;Testing 部分必须包含 lint/validation 类关键词与 unit test(s) 关键词,且指明可运行命令或已知运行器,否则 verify 会失败。delta spec 需与主 spec 路径一致,格式含 mapping frontmatter 与 ADDED/MODIFIED/REMOVED Requirements;无 spec 影响则留空目录,不编造映射路径。
必要用法:前置条件是项目根存在 .spec-driven/(可用 ls .spec-driven/ 检查),缺失时先执行 /spec-driven-init,roadmap 缺失时运行 node {{SKILL_DIR}}/scripts/spec-driven.js init;完成后运行 node {{SKILL_DIR}}/scripts/spec-driven.js verify <name>,修复可修的格式问题并重跑;最后向用户报告变更路径、来源里程碑与未决问题,并询问是否进入 /spec-driven-apply <name> 或 /spec-driven-auto,未经明确选择不得自动进入执行路径。
限制:仅将 Planned Changes 转为变更脚手架;不确定的测试命令应写成 open question 而非猜测;实现与测试映射放在 spec frontmatter 而非需求正文。运行环境、平台兼容性与收费等事实暂未提供。