用途:在项目中初始化 OpenSpec,生成 openspec/ 目录(specs 规格、changes 变更、可选 config.yaml)并配置所选 AI 工具的集成(技能与斜杠命令)。前提是已安装 OpenSpec CLI;若提示 openspec 命令未找到,应先执行 openspec-install。
主要能力与用法:交互式运行 openspec init;非交互指定工具如 openspec init --tools claude,cursor;全部工具 openspec init --tools all;指定目录 openspec init ./my-project;CI 场景 openspec init --tools claude --force;跳过工具配置 openspec init --tools none。参数:path 可选,默认当前目录;--tools 可选,取值 all、none 或逗号分隔列表;--force 自动清理旧文件而不提示。初始化过程中可能提示创建 openspec/config.yaml(项目上下文、schema 默认值、按产物规则),可选但推荐。
支持工具:amazon-q、antigravity、auggie、claude、cline、codebuddy、codex、continue、costrict、crush、cursor、factory、gemini、github-copilot、iflow、kilocode、opencode、qoder、qwen、roocode、trae、windsurf。
输出:openspec/ 下的 specs/、changes/、可选 config.yaml,以及按所选工具生成的 .claude/skills/、.cursor/rules/、.windsurf/skills/ 等目录。
适用场景:首次在项目启用 OpenSpec、为已有项目添加 AI 工具集成、更改工具选择后重新初始化。
限制与后续:需先安装 CLI;工具 ID 须在支持列表中;升级 CLI 后可用 openspec-update 重新生成工具配置;可用 openspec-onboard 获取完整流程引导,或用 openspec-explore、openspec-new 开始工作。