用途:该技能用于安装 OpenSpec CLI,使 openspec 命令在全局可用。仅覆盖 CLI 安装,不运行 openspec init;项目初始化需改用 openspec-initial。
适用场景:首次配置 OpenSpec;用户报告“openspec: command not found”;升级到最新版本;CI 或脚本需要预装 CLI。
前置条件:需要 Node.js 20.19.0 或更高版本,可用 node --version 检查;若未安装,先引导用户通过 nvm、fnm 或官方安装器安装 Node.js。
主要流程:先运行 openspec --version 检查是否已安装;若已成功,可建议用 openspec-initial 做项目设置,或通过 npm install -g @fission-ai/openspec@latest 升级。然后按包管理器安装:npm 使用 npm install -g @fission-ai/openspec@latest;pnpm 使用 pnpm add -g @fission-ai/openspec@latest;yarn 使用 yarn global add @fission-ai/openspec@latest;bun 使用 bun add -g @fission-ai/openspec@latest;nix 一次性运行 nix run github:Fission-AI/OpenSpec -- init,持久安装使用 nix profile install github:Fission-AI/OpenSpec。安装后再次运行 openspec --version 验证。CI 可在可缓存步骤中使用 npm install -g @fission-ai/openspec@latest。
限制与排查:Node.js 版本过低需先升级;npm 权限错误在 nvm/fnm 下可不用 sudo;安装后命令找不到需确认全局 bin 目录在 PATH 中(可用 npm bin -g 查看);nix 不可用时改用 npm/pnpm/yarn/bun。