mcpField
O
openspec-initial

openspec-initial

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

openspec-initial について

`openspec init` コマンドでプロジェクトに OpenSpec を初期化するスキルです。必要なディレクトリを作成し、選択した AI ツールとの連携を設定します。

主な機能

  1. 01OpenSpec のプロジェクトディレクトリ作成
  2. 02対応する AI ツール連携の設定
  3. 03対話形式または引数でツールを選択
  4. 04任意でプロジェクト設定を作成

活用シーン

  1. 01プロジェクトで初めて OpenSpec を設定
  2. 02AI ツール連携の追加や変更
  3. 03指定したディレクトリで OpenSpec を初期化

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/openspec-initialを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
examples/
all-tools.md
claude-cursor.md

詳細

OpenSpec 初期化スキル

openspec init を実行して、プロジェクトで OpenSpec を初期化します。openspec/ ディレクトリ（仕様、変更、設定）を作成し、AI ツールとの連携（スキルとスラッシュコマンド）を設定します。このスキルは、OpenSpec CLI がすでにインストールされていることを前提としています。インストールされていない場合は、まず openspec-install に案内してください。

使用するタイミング

  • プロジェクトで初めて OpenSpec を有効にするとき（「OpenSpec を初期化して」「ここに OpenSpec をセットアップして」）。
  • 既存のプロジェクトに AI ツールとの連携（Claude、Cursor、Windsurf など）を追加するとき。
  • ツールの選択を変更した後に再初期化するとき。

前提条件

  • OpenSpec CLI がインストールされていること（openspec-install を参照）。openspec が PATH にない場合は、続行する前に openspec-install を実行するよう案内してください。

ワークフロー

  1. CLI を確認する

    • ユーザーから「openspec command not found」と報告された場合は、まず openspec-install に案内してください。

  2. パラメーターを選択する

    • path（任意）：対象ディレクトリ。デフォルトは現在のディレクトリです。
    • --tools（任意）：AI ツールを非対話形式で設定します。値は all、none、またはカンマ区切りのリスト（例：claude,cursor）です。
    • --force：確認を求めずにレガシーファイルを自動でクリーンアップします。

  3. コマンドを実行する

    • 対話形式：openspec init
    • 特定のツールを指定した非対話形式：openspec init --tools claude,cursor
    • すべてのツール：openspec init --tools all
    • 特定のディレクトリ：openspec init ./my-project

  4. 必要に応じてプロジェクト設定を作成する

    • 初期化中に、プロジェクトのコンテキスト、スキーマのデフォルト値、アーティファクトごとのルールを含む openspec/config.yaml の作成を求められることがあります。これは任意ですが、推奨されています。詳しくは openspec-config を参照してください。

  5. 出力を確認する

    • 成功すると、specs/、changes/、および必要に応じて config.yaml を含む openspec/ ディレクトリが作成されます。選択したツールに応じて、ツール固有のディレクトリ（.claude/skills/、.cursor/rules/ など）が作成されます。

対応ツール

amazon-q、antigravity、auggie、claude、cline、codebuddy、codex、continue、costrict、crush、cursor、factory、gemini、github-copilot、iflow、kilocode、opencode、qoder、qwen、roocode、trae、windsurf

出力

  • openspec/：
    • specs/ — 仕様（信頼できる唯一の情報源）
    • changes/ — 変更案
    • config.yaml — プロジェクト設定（任意）
  • ツール設定：選択したツールに応じて .claude/skills/、.cursor/rules/、.windsurf/skills/ などが作成されます。

次のステップ

  • CLI のアップグレード後に openspec-update を使用して、ツール設定を再生成します。
  • ワークフロー全体のガイド付きチュートリアルには openspec-onboard を使用します。
  • または、作業を開始します。アイデアを検討するには openspec-explore、変更を開始するには openspec-new を使用します。

さまざまな環境

シナリオコマンド
対話形式openspec init
Claude + Cursoropenspec init --tools claude,cursor
すべてのツールopenspec init --tools all
特定のディレクトリopenspec init ./my-project
CI / 非対話形式openspec init --tools claude --force
ツール設定をスキップopenspec init --tools none

トラブルシューティング

  • 「openspec: command not found」：まず openspec-install を使用してください。
  • レガシーファイルが検出された：--force を使用して自動クリーンアップするか、対話形式のプロンプトに従ってください。
  • ツールがリストにない：正しい ID を確認するには、対応ツールのリストを確認してください。

参考資料

コメント

Markdown 対応