mcpField
O
openspec-install

openspec-install

github.com/full-stack-skillsAgent 工作流189 次安装4 周前更新
代码仓库

关于 openspec-install

openspec-install 是指导安装和升级 OpenSpec CLI 的技能，面向首次配置、命令不可用或需要在 CI 中预装 CLI 的场景。它列出多种包管理器和 nix 方式，并包含安装前提与验证步骤；不负责初始化项目。

主要功能

  1. 01检查现有 CLI 版本
  2. 02提供 npm、pnpm、yarn、bun 安装方式
  3. 03提供 nix 一次性或持久安装方式
  4. 04验证安装并说明升级方法
  5. 05说明 Node.js 版本和 PATH 排错

适用场景

  1. 01首次安装 OpenSpec CLI
  2. 02修复 openspec 命令不可用
  3. 03将 CLI 预装到 CI 流程
  4. 04升级现有 OpenSpec 安装

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-install

安装后在 Claude Code 中输入/openspec-install确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
examples/
nix.md
npm.md
pnpm.md

详细介绍

OpenSpec 安装技能

安装 OpenSpec CLI，使 openspec 可全局使用。此技能仅涵盖安装 CLI；不会运行 openspec init。安装后如需初始化项目，请使用 openspec-initial。

适用场景

  • 首次设置 OpenSpec（“安装 OpenSpec”“开始使用 OpenSpec”）。
  • 用户反馈“找不到 openspec 命令”。
  • 升级到最新版本。
  • CI 或脚本需要预先安装 CLI。

前置条件

  • Node.js 20.19.0 或更高版本——使用 node --version 检查。如果尚未安装，请先指导用户安装 Node.js（例如通过 nvm、fnm 或官方安装程序）。

工作流

  1. 检查是否已安装

    • 运行 openspec --version。如果运行成功，则 CLI 已安装；建议使用 openspec-initial 设置项目，或通过 npm install -g @fission-ai/openspec@latest 升级。

  2. 选择包管理器并安装

    • 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（持久安装）：nix profile install github:Fission-AI/OpenSpec

  3. 验证安装

    • 运行 openspec --version 以确认安装成功。

  4. 升级现有安装

    • 使用与安装相同的命令，例如 npm install -g @fission-ai/openspec@latest。

输出

  • openspec 命令可在 PATH 中全局使用。

后续步骤

  • 使用 openspec-initial 在项目中运行 openspec init。
  • 或使用 openspec-onboard 跟随引导式教程。

不同环境

环境命令
npmnpm install -g @fission-ai/openspec@latest
pnpmpnpm add -g @fission-ai/openspec@latest
yarnyarn global add @fission-ai/openspec@latest
bunbun add -g @fission-ai/openspec@latest
nix（一次性运行）nix run github:Fission-AI/OpenSpec -- init
nix（持久安装）nix profile install github:Fission-AI/OpenSpec
CI在可缓存的步骤中运行 npm install -g @fission-ai/openspec@latest

故障排除

  • Node.js 版本过旧：OpenSpec 要求 Node.js 20.19.0 或更高版本。请先升级 Node.js。
  • 权限错误（npm）：如果使用 nvm/fnm，请在不使用 sudo 的情况下运行 npm install -g；否则可考虑使用 nvm。
  • 安装后找不到命令：确保全局 bin 目录位于 PATH 中（使用 npm bin -g 检查）。
  • 无法使用 nix：请安装 nix，或改用 npm/pnpm/yarn/bun。

参考资料

评论

支持 Markdown