用途:在指定项目中初始化 spec-driven 工作流,生成 .spec-driven/ 目录及其脚手架,并引导用户补充项目上下文。
主要能力:运行 node {{SKILL_DIR}}/scripts/spec-driven.js init [path] 完成初始化。若 .spec-driven/ 不存在,会从零创建 roadmap/、specs/、changes/;若已存在,则修复缺失的脚手架文件并重新生成 specs/INDEX.md,不覆盖已有文件。随后读取 README.md、AGENTS.md、CLAUDE.md、package.json、pom.xml 等项目文件,起草 3–5 句 context 写入 .spec-driven/config.yaml 并请用户确认。还可协助把项目已有行为写成初始 spec 文件,按领域分组(如 auth/、api/、core/),使用 ### Requirement: <name> 标题与 RFC 2119 关键词,描述系统当前行为而非应有行为,并在 specs/INDEX.md 中登记。
使用方式:先确认目标项目路径(当前目录用 . 或显式路径),再执行 init 命令;路径与当前目录不同时才传入。初始化后建议运行 /roadmap-plan 规划路线图,或 /spec-driven-propose 创建首个变更。
限制:仅做初始化,不创建任何 changes;context 保持 3–5 句;已存在 .spec-driven/ 时不覆盖已有文件,只修复缺失脚手架。目标项目目录需在当前环境中可访问,且需确认路径为项目根目录。