SuperAPI AI 工具集

openspec-install

部署与运维

查看项目

更新于 10-16 03:15

技能介绍

用途:本技能只负责把 OpenSpec CLI 安装到全局,使 openspec 命令在 PATH 中可用;它不执行 openspec init,项目初始化需改用 openspec-initial。

适用场景:首次配置 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。安装后再运行 openspec --version 验证。升级与安装命令相同。CI 中可在可缓存步骤执行 npm install -g @fission-ai/openspec@latest。

限制与排错:Node.js 版本过低需先升级;npm 权限错误时,若使用 nvm/fnm 可不用 sudo,否则考虑改用 nvm;安装后仍找不到命令,需确认全局 bin 目录在 PATH 中(可用 npm bin -g 查看);没有 nix 时可改用 npm/pnpm/yarn/bun。