opsx-workspace-gate

OPSX Workspace Gate

OPSX ワークフロー向けの内部共有スキルです。OpenSpec プロジェクトのルートを確立し、ホストがワークフロー固有のオーケストレーションを開始する前に、ネイティブスキルの前提条件を確認します。

1. プロジェクトのルートを特定する

次の優先順位に従い、一意の結果が最初に見つかった時点で終了します。

1. 現在の作業ディレクトリに openspec/ がある。
2. 現在の編集ファイルから上位へたどり、openspec/ を含む最初の祖先ディレクトリを使用する。
3. 現在の作業ディレクトリの直下の子ディレクトリを検索し、openspec/ を探す。
   • 一致が1件：それを使用する。
   • 複数一致：候補を一覧表示し、ユーザーが選択するまで待つ。
4. 一致なし：停止し、初期化済みの OpenSpec プロジェクトを入力するか、openspec init を実行するようユーザーに依頼する。

【工程定位结果】目标工程根：<absolute path> を出力します。以降の OpenSpec パス、CLI コマンド、ネイティブスキルへの委譲は、このルートから実行します。作業ディレクトリを変更できない場合は、絶対パスを使用します。

2. OpenSpec ディレクトリを確認する

<project-root>/openspec/ が存在することを確認します。存在しない場合は停止し、ユーザーに openspec init の実行を案内します。黙って初期化してはいけません。

3. ネイティブ OPSX スキルを確認する

プロジェクトルート以下のインストール済みスキルディレクトリを検索し、次の正確な名前のスキルがあることを確認します。

必須スキル	ワークフローでの用途
openspec-new-change	変更を作成する
openspec-continue-change	成果物を作成または継続する
openspec-apply-change	チェック済みのタスクを実装する
openspec-archive-change	完了した変更をアーカイブする

openspec-verify-change は任意です。レガシー名や別名では、このゲートの要件を満たしません。必須スキルが見つからない場合は停止し、ユーザーに openspec init（初回セットアップ）または openspec update（スキルの更新）を実行するよう案内します。

委譲に関する規律

• ネイティブ OPSX スキルに委譲する前に、そのスキルの現在の SKILL.md を読みます。
• openspec status や openspec validate などの CLI コマンドは使用可能なツールですが、ネイティブスキルへの委譲の代わりにはなりません。
• ホストは、ステージの順序、Jira／Git の操作、再試行と変更の紐付け、成果物の出力先、ワークフロー固有のすべての判断を担います。

統合ガイド

OPSX ホストでは opsx-workspace-gate を依存関係として宣言し、場所の特定と各ゲートのために読み込んでから、ホスト固有のセットアップを続行します。この場所特定のアルゴリズム、正確な名前の表、委譲ルールをホストにコピーしてはいけません。