mcpField
O
openspec-install

openspec-install

github.com/full-stack-skillsエージェントワークフロー189 回インストール4 週間前に更新
リポジトリ

openspec-install について

openspec-installは、OpenSpec CLIのインストールとアップグレードを案内するスキルです。初回設定、コマンドが見つからない場合、CIでの事前導入に対応し、前提条件と確認手順も示します。プロジェクトの初期化は行いません。

主な機能

  1. 01インストール済みCLIのバージョン確認
  2. 02npm、pnpm、yarn、bunでの導入
  3. 03nixによる一時または継続的な導入
  4. 04インストール確認とアップグレード案内
  5. 05Node.js要件とPATHのトラブル対応

活用シーン

  1. 01OpenSpec CLIを初めてインストール
  2. 02openspecコマンドが見つからない問題を解決
  3. 03CIワークフローにCLIを事前導入
  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: command not found」と報告されたとき。
  • 最新バージョンにアップグレードするとき。
  • CLI を事前インストールする必要がある CI やスクリプトで使用するとき。

前提条件

  • 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 対応