プロファイル
インストールするワークフローを選択し、スキル、コマンド、またはその両方としてインストールするかを選びます。
プロファイルは、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つエンドツーエンドで行い、ワークフローを学びます |
セットを変更するには、対話式ピッカーを実行します:
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つで、プロンプトは表示されません:
openspec config set delivery skills # または: both, commands提供方法を変えてもプロファイル名は変わりません。core と custom はワークフローセットのみを表し、core に戻しても提供方法の設定は維持されます。
プロファイルの切り替え
切り替えは2ステップです。まずマシン上のプロファイルを変更し、次に各プロジェクトを更新して適用します。
プロファイルを変更します:
bashopenspec config profile # 対話式 openspec config profile core # コア6つにリセット(提供方法は維持)作業中の各プロジェクトで更新を実行します:
bashopenspec update
現在のディレクトリが既存の OpenSpec プロジェクトの場合、対話式フローがそこでステップ2を実行することを提案します。