cross-agent-install-smoke

クロスエージェントのインストールスモークテスト

稼働中のハーネスのインストールを変更せずに、スキルの追加同期を検証します。

対象範囲： インストールスモークテストのみです。メンテナーから明示的に依頼されない限り、稼働中の適用インストールは実行しないでください。

ディスパッチ

$ARGUMENTS	アクション
Empty / phase1 / dry-run	フェーズ 1 の dry-run JSON アサーションを実行
phase2 / local / smoke	フェーズ 2 の一時 HOME スモークテストを実行（INSTALL_SMOKE=1 が必要）
all	フェーズ 1 を実行し、ゲート条件を満たす場合はフェーズ 2 を実行
help	フェーズ、ゲート条件、コマンド例を表示

フェーズ 1 — Dry-Run JSON

リポジトリのルートから、決定論的チェッカーを実行します。

uv run python skills/cross-agent-install-smoke/scripts/dry_run.py

フェーズ 1 では、リポジトリのスキル同期 dry-run コマンドを実行し、次の項目をアサートします。

• トップレベルのキー：ok、mode、inventory_count、include_installed、agents
• mode が dry-run である
• 各エージェントの行に、agent とバケットフィールド missing、already_present、unresolved、skipped が含まれる
• バケットフィールドは、従来の文字列リスト または コンパクトオブジェクト {count, sample, truncated}（Wave 1b 以降のデフォルト JSON）のいずれかを使用できます
• 存在する場合、オプションのバケット（projection_ensure、projection_blocked、store_missing、internal_projection、pin_blocked）も同じ形式を使用します

合格条件：スクリプトが 0 で終了し、JSON の概要を stdout に出力すること。フェーズ 1 は dry-run のみです。--apply は決して使用しないでください。

フェーズ 2 — 一時 HOME スモークテスト

フェーズ 2 はオプトイン方式で、一時ディレクトリ内のホームディレクトリのみを変更します。

INSTALL_SMOKE=1 uv run python skills/cross-agent-install-smoke/scripts/local_smoke.py

スクリプトは次の処理を行います。

1. INSTALL_SMOKE=1 が設定されていない場合は実行を拒否します
2. 一時ディレクトリ内に独立した HOME を作成します
3. リポジトリに対してリポジトリの検証コマンドを実行します
4. 単一ハーネスのスキル同期 dry-run JSON プローブを実行します
5. 一時ホームをクリーンアップします

フェーズ 2 の実行先に、本番環境のホームディレクトリを指定しないでください。

検証契約

uv run python skills/cross-agent-install-smoke/scripts/check.py
INSTALL_SMOKE=1 uv run python skills/cross-agent-install-smoke/scripts/check.py

完了条件：

1. フェーズ 1（dry_run.py）が、CI とローカルのメンテナーによる実行で 0 で終了すること。
2. フェーズ 2 が INSTALL_SMOKE=1 の設定時にのみ実行されること。
3. 選択したフェーズのゲート条件に対して scripts/check.py が 0 で終了すること。

重要なルール

1. デフォルトは dry-run とし、このスキルから稼働中のインストールを適用しないでください。
2. スキル同期の JSON は証拠として扱い、リポジトリのポリシーより優先されるものとは見なさないでください。
3. ハーネス間のインストール調整を推奨する前に、フェーズ 1 を実行してください。
4. フェーズ 2 は INSTALL_SMOKE=1 と使い捨ての一時 HOME を条件に実行してください。
5. ハーネス固有のインベントリエラーを報告し、トップレベルの ok: false を隠さないでください。