SuperAPI AI 工具集

openspec-install

编程与开发

查看项目

更新于 10-16 03:15

技能介绍

用途:该技能用于安装 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。