antithesis-launch

Antithesis の起動

スキルのバージョン： 2026-10-21 4f8d80b

前提条件

• snouty がインストールされていない場合は、作業を進めないでください。インストール方法については、https://raw.githubusercontent.com/antithesishq/snouty/refs/heads/main/README.md を参照してください。
• snouty が 0.8.0 より古い場合は、作業を進めないでください。snouty --version でバージョンを確認してください。更新するには snouty update を使用してください。
• snouty doctor を実行してください。コンテナランタイムと Compose CLI を確認します。両方の結果をユーザーに報告し、同じ組み合わせでビルドしてください。このスキルでは docker compose を使用しますが、snouty が CLI として指定したものが docker-compose の場合は、代わりに docker-compose を使用してください。

目標

次の順序でのみ、Antithesis の実行を起動してください。

1. docker compose build（ビルド済みイメージを使用するよう指示された場合はスキップ）
2. snouty validate
3. 検証に失敗した場合は停止し、エラーを報告
4. snouty launch

必須入力

• 分単位の duration が必須です。ユーザーから指定されていない場合は、実行を送信する前に確認してください。

検出

• ユーザーが指定したパス、コマンド、または Antithesis ディレクトリ名から開始してください。
• それ以外の場合は、リポジトリを調査し、ハーネスの構成を把握してください。コマンドを選択する前に、近くにある AGENTS.md、README*、Makefile*、および Antithesis 固有のスクリプトを確認してください。
• Antithesis 用の docker-compose.yaml を探して、設定ディレクトリを見つけてください。antithesis/config のようなディレクトリを優先しますが、標準外の構成にも対応してください。
• 次の項目は、Antithesis を示す強い手がかりとして扱ってください。近くにある scratchbook/ または test/ ディレクトリ、/opt/antithesis に言及する compose の内容、ANTITHESIS_ 環境変数、setup_complete、または既存の snouty の使用例です。
• compose ファイルの候補が複数ある場合は、リポジトリのドキュメントまたは既存の snouty launch の使用例で参照されているものを優先してください。それでも判断できない場合は、推測せずにユーザーに確認してください。
• docker-compose.yaml を含むディレクトリを、snouty validate <CONFIG> および snouty launch --config <CONFIG> の引数として使用してください。
• そのファイルを指定してビルドしてください。docker compose -f <CONFIG>/docker-compose.yaml build。
• snouty はイメージをビルドもプルもしないため、すべてのイメージが snouty の選択するエンジンのストアにすでに存在している必要があります。両方のエンジンがインストールされている場合、snouty は podman を優先します。
  • snouty に docker のストアを使用させるには、SNOUTY_CONTAINER_ENGINE=docker を設定してください。
• podman を使用する場合は、podman compose -f <CONFIG>/docker-compose.yaml build でビルドしてください。このラッパーは Docker Compose v2 を podman の API ソケット経由で実行するため、イメージは podman のストアに格納されます。まずプロバイダーを確認してください。podman compose version が Docker Compose version ... を出力する必要があります。Compose v2 のバイナリが見つからない場合、podman は代わりに podman-compose Python ツールを使用します。

実行引数

• 起動方法は次の順序で決定してください。ユーザーによる明示的な指定、既存のリポジトリのドキュメント／スクリプト／使用例。それ以外の場合、docker-compose.yaml ファイルを使用するときは basic_test、Kubernetes のセットアップを使用するときは basic_k8s_test をデフォルトとします。

• ビルド済みイメージを使って実行を起動するよう明示的に指示された場合は、ユーザーが指定したイメージ参照を使って snouty launch --config-image <CONFIG_IMAGE> を実行してください。

• それ以外の場合は snouty launch --config <CONFIG> を使用します。この方法では ANTITHESIS_REPOSITORY が必要です。すでに設定されている場合は、現在の環境の値を再利用してください。設定されていない場合は、停止してユーザーに確認してください。

• 次のすべての値を必ず明示的に設定してください。

  • --duration：ユーザーが指定した実行時間
  • --source：リポジトリ名
  • --test-name：リポジトリ名にブランチ名または設定名を加えたもの
  • --description：ブランチ名、現在の目標、前回の実行からの変更点などの詳細を含む、簡潔で読みやすい実行の説明。

• 上書きを許可してください。このスキルを呼び出すユーザーまたは別のスキルが起動パラメーターを指定した場合は、上記のデフォルト値ではなく、指定された値を使用してください。

実行

• これらのコマンドは完了までに長い時間がかかる場合があります。すぐに完了すると想定せず、バックグラウンド実行または十分に長いタイムアウトを優先してください。
• ビルドが成功し、snouty validate が正常終了するまでは、snouty launch を実行しないでください。

docker compose -f "$CONFIG_DIR/docker-compose.yaml" build
snouty validate "$CONFIG_DIR"
snouty launch \
  --json \
  --launcher "$LAUNCHER" \
  --config "$CONFIG_DIR" \
  --duration "$DURATION" \
  --source "$SOURCE" \
  --test-name "$TEST_NAME" \
  --description "$DESCRIPTION"

出力

• 提出前に、設定ディレクトリ、compose のビルドコマンド、検証コマンド、最終的な snouty launch コマンドの形式を報告します。
• 検証に失敗した場合は、ただちに停止し、失敗したコマンドと主なエラーを表示します。
• --json フラグを指定すると、snouty launch は run_id を含む機械可読形式の出力を生成します。run_id を解析して報告します。実行完了後のトリアージに必要です。

セルフレビュー

• 選択した設定ディレクトリには、実際に Antithesis の docker-compose.yaml が含まれています。
• ビルド、検証、実行の各ステップは、すべて同じ設定を参照しています。
• snouty launch の実行前に、snouty validate が成功しています。
• 実行時には source、test-name、description、duration を明示的に設定し、呼び出し元から値が指定されている場合はデフォルト値より優先して使用するとともに、呼び出し元から指定された追加パラメーターも使用しています。
• ビルドでは、compose CLI とコンテナエンジンとして snouty doctor が報告したものを使用しています。
• duration、ANTITHESIS_REPOSITORY のような不足している必須項目や、設定場所が曖昧な場合は、不適切な提出を行わずに停止しました。