用途:本技能用于全局安装 OpenSpec CLI,使 openspec 命令在 PATH 中可用。它只覆盖安装环节,不运行 openspec init;项目初始化需使用 openspec-initial,引导式教程可用 openspec-onboard。
适用场景:首次配置 OpenSpec;用户反馈 openspec: command not found;升级到最新版本;CI 或脚本需要预装 CLI。
前置条件:需要 Node.js 20.19.0 或更高版本,可用 node --version 检查;若未安装,先引导用户安装 Node.js(如 nvm、fnm 或官方安装器)。
使用方式:先运行 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。CI 中可在可缓存步骤执行 npm install -g @fission-ai/openspec@latest。安装后再次运行 openspec --version 验证。升级与安装命令相同。
限制与排错:Node.js 版本过低需先升级;npm 权限错误时,若使用 nvm/fnm 可不用 sudo,否则考虑改用 nvm;安装后仍 command not found 需确认全局 bin 目录在 PATH 中(可用 npm bin -g 查看);无 nix 时可改用 npm/pnpm/yarn/bun。