run-e2e

前提: 本スキルは git worktree + devcontainer を用いた並列実行フローを前提とする。.stdd.config.yml で worktree プラグインを併せて有効化すること。

Worktree上でE2Eテストを実行するスキル

worktree環境のdevcontainer内でE2Eテストをセットアップ・実行する。 稼働中のdevcontainerがあればそれを使い、なければ新規作成する。

1. 稼働中のworktree devcontainerを検索

for i in 1 2 3 4; do
  wt_dir="{{worktree.base_path}}/worktree-${i}"
  container=$(docker ps --filter "label=devcontainer.local_folder=${wt_dir}" --format "{{.Names}}" 2>/dev/null)
  if [ -n "$container" ]; then
    echo "FOUND:${i}:${container}"
  fi
done

判定ロジック

• FOUND:N が出力された場合 → そのINSTANCE_ID=Nのdevcontainerを使用。ステップ2へ進む
• 何も出力されない場合 → 稼働中のworktree devcontainerなし。ステップ1-Bで新規作成する

1-B. Worktree＋devcontainerを新規作成

稼働中のworktree devcontainerがなかった場合のみ実行する。

空きINSTANCE_IDを特定

for i in 1 2 3 4; do
  wt_dir="{{worktree.base_path}}/worktree-${i}"
  if [ ! -d "$wt_dir" ]; then
    echo "AVAILABLE:${i}"
    break
  fi
done

最初に見つかった空きIDを使用する。空きがない場合はユーザーに不要なworktreeの破棄を案内して中断する。

worktree作成

./scripts/create-worktree.sh -b claude/e2e-run -i <INSTANCE_ID>

devcontainer起動

devcontainer up --workspace-folder {{worktree.base_path}}/worktree-<INSTANCE_ID> --override-config {{worktree.base_path}}/worktree-<INSTANCE_ID>/.devcontainer/devcontainer.override.json

起動完了を待ってからステップ2へ進む。

2. 環境変数の算出

特定したINSTANCE_IDから以下を算出する:

WORKTREE_DIR = {{worktree.base_path}}/worktree-<INSTANCE_ID>
OVERRIDE_CONFIG = ${WORKTREE_DIR}/.devcontainer/devcontainer.override.json

# ポート計算（INSTANCE_IDに応じてオフセット）
# 各アプリのベースポートは .stdd.config.yml の apps[].port を用いる（apps[] の数だけ繰り返す）
APP_PORT(<apps[].id>) = <apps[].port> + INSTANCE_ID * 100   (例: base=3000, ID=1 → 3100, ID=2 → 3200)
SUPABASE_API_PORT = 54321 + INSTANCE_ID * 1000
SUPABASE_DB_PORT = 54322 + INSTANCE_ID * 1000

以降のdevcontainer execコマンドはすべて以下の形式で実行する:

devcontainer exec --workspace-folder <WORKTREE_DIR> --override-config <OVERRIDE_CONFIG> bash -c "COMMAND"

重要: 変数代入をコマンドの先頭に置かないこと。必ず devcontainer exec からコマンドを始める（auto-approve対象パターンに合致させるため）。