Skip to content

プロファイル ​

インストールするワークフローを選択し、スキル、コマンド、またはその両方としてインストールするかを選びます。

プロファイルは、OpenSpec のワークフロー(AI ツール内のスキルとコマンド)をマシン全体にどれインストールするかを指定する設定です。デフォルトのプロファイルは core です。ワークフローを含めたり除外したりすると、その選択内容は custom プロファイルとして保存されます。

コアセット ​

core プロファイルは6つのワークフローをインストールし、アイデアからアーカイブまでの全工程をカバーします:

ワークフロー用途
explore変更提案になる前にアイデアをじっくり検討します
propose変更提案を作成し、その計画成果物をすべて一度に生成します
apply変更提案のタスクを実装します
update変更提案の既存の計画成果物を改訂します
sync変更提案をアーカイブせずに、その仕様更新を specs/ にマージします
archive完了した変更提案をアーカイブに移動します

各項目は、完全なコントラクト(引数、作成するもの、応答内容)へのリンクになっています。

セットの拡張: オプションのワークフロー ​

コアセットに加えて、さらに6つのワークフローを利用できます。そのうち3つ(new、continue、ff)は、propose のように一度にすべてを作成するのではなく、変更提案の成果物を1つずつ作成します。

ワークフロー用途
new変更提案を空のスキャフォールドとして開始します
continue変更提案内で次の計画成果物を1つずつ作成します
ff変更提案と、実装に必要なすべての計画成果物を1回のパスで作成します
verify実装が変更提案の成果物と一致していることを確認します
bulk-archive複数の変更提案を一度にアーカイブします
onboard実際の変更提案を1つエンドツーエンドで行い、ワークフローを学びます

セットを変更するには、対話式ピッカーを実行します:

bash
openspec config profile

ピッカーは、設定対象(提供方法、ワークフロー、またはその両方)を尋ね、次に12個すべてのワークフローをチェックボックスとして一覧表示し、インストール済みのものにチェックを入れます。コア6つと完全に一致しない選択内容は custom プロファイルとして保存されるため、使用しないコアワークフローのチェックを外すこともできます。

提供方法: スキル、コマンド、またはその両方 ​

提供方法はプロファイル設定で、スキルのみ、またはコマンドのみをインストールするように選択できます。デフォルトは both です。プロジェクトのセットアップでは、2つの形式と、両方が存在する理由を説明しています。このフィールドの正確なコントラクトは、CLI 設定 (config.json) にあります。

変更する方法は2つあります:

対話式: openspec config profile を実行し、「Delivery only」を選択します。スキルのみに切り替える例を次に示します:

Current profile settings
  Delivery: both

? What do you want to configure? Delivery only
? Delivery mode (how workflows are installed): Skills only

Config changes:
  delivery: both -> skills
? Apply changes to this project now? (Y/n) y

直接指定: コマンド1つで、プロンプトは表示されません:

bash
openspec config set delivery skills   # または: both, commands

提供方法を変えてもプロファイル名は変わりません。core と custom はワークフローセットのみを表し、core に戻しても提供方法の設定は維持されます。

プロファイルの切り替え ​

切り替えは2ステップです。まずマシン上のプロファイルを変更し、次に各プロジェクトを更新して適用します。

  1. プロファイルを変更します:

    bash
    openspec config profile        # 対話式
    openspec config profile core   # コア6つにリセット(提供方法は維持)
  2. 作業中の各プロジェクトで更新を実行します:

    bash
    openspec update

現在のディレクトリが既存の OpenSpec プロジェクトの場合、対話式フローがそこでステップ2を実行することを提案します。