用途:在项目目录中运行 openspec init,完成 OpenSpec 初始化,创建 openspec/ 目录结构,并配置所选 AI 工具集成。
主要能力:生成 openspec/ 目录,其中 specs/ 存放规格(source of truth),changes/ 存放变更提案,可选生成 config.yaml 项目配置;按所选工具创建对应配置目录(如 .claude/skills/、.cursor/rules/、.windsurf/skills/ 等)。支持工具包括 claude、cursor、windsurf、codex、gemini、github-copilot、cline、roocode、trae 等。
使用方式:需先安装 OpenSpec CLI;若提示“openspec command not found”,先执行 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。
适用场景:首次在项目启用 OpenSpec;为已有项目添加 AI 工具集成;更改工具选择后重新初始化。
限制:假定 OpenSpec CLI 已安装,否则需先完成安装;工具须在支持列表内;资料未提供 OpenSpec 的收费、版本要求或其他细节。