e2e-live-docker - SKILL.md Agent Skill

name: e2e-live-docker description: 実 Claude API + Docker サンドボックスを叩く docker カテゴリの総合テストを実行する。`DISABLE_SANDBOX` を unset した状態で `yarn dev` が起動済みであることが前提（サンドボックス off だと全 test が `test.skip` で抜ける）。

前提

yarn dev を別ターミナルで起動済み（http://localhost:5173 が応答する）
DISABLE_SANDBOX を unset で起動していること。/api/sandbox の payload は enabled 時 { sshAgent, mounts }、 disabled 時空オブジェクト {} を返す（server/api/sandboxStatus.ts 参照）。spec 側の getSandboxStatus(page) helper はこの {} を null に正規化するので、 sandbox off だと spec の gate が null === null で hit して全 test が test.skip で抜ける
Docker daemon が起動しており、 mulmoclaude-sandbox image が build 済（yarn dev 初回起動時に自動 build）
Claude 認証済み（claude login 済み or ANTHROPIC_API_KEY 設定済み）
各シナリオ固有の前提（unmet なら spec が test.skip で抜ける、ログにスキップ理由が出る）:
- L-23: X_BEARER_TOKEN が host の env に設定されていること
- L-28: SANDBOX_MOUNT_CONFIGS=gh または SANDBOX_SSH_AGENT_FORWARD=1 のいずれかが設定されていること

実行

yarn test:e2e:live:docker

デバッグ時

HEADED=1 yarn test:e2e:live:docker

カバーするシナリオ

L-23: X MCP tools (readXPost / searchX) が Docker サンドボックス on 状態で host の X_BEARER_TOKEN を見て enabled になる（B-01 回帰）
L-26: サンドボックス on 状態で開始したセッションが reload で「No conversation found」を出さず履歴復元される（B-04 回帰、 in-container workspace path 整合）
L-28: agent が container 内で gh auth status を Bash 実行し、 host の gh credential が container に届いていることを確認する（B-06 回帰）

結果の確認

詳細: playwright-report-live/docker/index.html（このカテゴリ専用サブディレクトリに出力されるので、親 /e2e-live の総合レポートは上書きされない）
動画リプレイ: npx playwright show-trace test-results-live/docker/<spec>/trace.zip

fake-echo / CI matrix について

このカテゴリは fake-echo backend (MULMOCLAUDE_FAKE_AGENT=1) で再現できない（実 Docker サンドボックス起動が必要）ので、 .github/workflows/e2e_live_no_llm.yaml の matrix には 意図的に登録していない。同等の理由で各 test も E2E_LIVE_NO_LLM=1 が立っていると skip する。 routine な CI 検証ではなく 開発者が手元で Docker on モードを切り替えて回す ことを想定したスイート。

Docker on/off の検証も必要な場合

このカテゴリは Docker on 必須で、 off では全 test が test.skip するだけ。「両モード巡回」を取りたい時は 1) 現在モード (/api/sandbox の payload で確認) で yarn test:e2e:live:docker を回す、 2) もう一方のモードに dev を再起動して yarn test:e2e:live を回して他カテゴリの両モード健全性を見る、の併用が想定。