메뉴
mood-board プロジェクトの Maestro E2E テストを実行する。ビルド、シミュレータ起動、Firebase Emulator ready 確認、ダイアログ処理、フロー単位実行（FAIL 時は画面確認 → helper/環境側のみ修正 → 再実行のループ）、結果サマリを一貫して行う。「Maestro テスト実行」「E2E テストを回して」「Maestro を動かして」「テストを走らせて」と言及された時に使用。モバイルアプリのテストや動作確認にも使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
最新iOSランタイムの無印iPhoneシミュレータ名を取得する。「シミュレータ名を取得」「シミュレータを特定」「iPhone/iPadシミュレータ」「どのシミュレータを使う」と言及された時に使用。
Conventional Commits形式でgitコミットを作成する。「コミット」「commit」「変更をコミット」「コミットして」「コミットお願い」「この変更を保存」「git commit」「変更を記録」と言及された時に使用。hunk単位でステージングしコミットメッセージを自動生成する。プッシュやPR作成は対象外。
実装完了後の品質レビューパイプラインを実行する。Agent Teams でコードレビュー、E2Eテスト、UI/UXレビューを並列で実行し、結果を集約してレポートする。「品質レビュー」「レビューして」「quality review」「実装完了したのでチェック」と言及された時に使用。
Codex CLIを使って単発の質問や確認を行う。「Codexに質問」「Codexに聞いて」「Codexに確認して」「codex exec」と言及された時に使用。1回の実行で結果を返す。反復的なコードレビューにはreviewing-codexスキルを使用。
Search and read Apple developer documentation including SwiftUI, UIKit, Foundation, and 300+ frameworks. Use when the user asks about Apple APIs, iOS/macOS development, Swift syntax, or needs to look up Apple documentation.
自然言語やMermaid記法からVisio風スイムレーンフローチャートSVGを生成する。「フローチャート生成」「SVGフローチャート」「スイムレーン図」「フローをまとめて」「処理の流れ」「フロー図を作って」「図にして」「処理フローを可視化」「ワークフロー図」と言及された時に使用。コードベースの処理フロー可視化にも対応。
| name | maestro-e2e-runner |
| description | mood-board プロジェクトの Maestro E2E テストを実行する。ビルド、シミュレータ起動、Firebase Emulator ready 確認、ダイアログ処理、フロー単位実行（FAIL 時は画面確認 → helper/環境側のみ修正 → 再実行のループ）、結果サマリを一貫して行う。「Maestro テスト実行」「E2E テストを回して」「Maestro を動かして」「テストを走らせて」と言及された時に使用。モバイルアプリのテストや動作確認にも使用。 |
| context | fork |
| agent | general-purpose |
| allowed-tools | Bash(xcrun:*), Bash(npx:*), Bash(pgrep:*), Bash(pkill:*), Bash(kill:*), Bash(date:*), Bash(mkdir:*), Bash(cp:*), Bash(lsof:*), Bash(curl:*), Bash(firebase:*), Bash(tail:*) |
mood-board アプリの Maestro E2E テストをローカル iOS Simulator で実行する。 環境の生存確認・修正・再実行ループを主体とし、フロー YAML 自体は改変しない。
シミュレータ確認 → Firebase Emulator ready 確認 → アプリビルド判定 → Metro 起動 →
アプリ起動 + ダイアログ処理 → フロー単位実行（FAIL 時: 画面確認 → 修正 → 再実行）→ 結果サマリ
mood-board-app/.maestro/flows/*.yaml の検証ステップ（assertVisible / tapOn / extendedWaitUntil 構成）は改変しない。これは合意済みの検証仕様。mood-board-app/.maestro/helpers/_prelude.yamlmood-board-app/.maestro/helpers/sign_up.yamlmood-board-app/.maestro/helpers/sign_out.yamlRemoteConfigContext の初期値、emulatorConfig.ts のログ、SeedTestData の冪等化など「動作の土台」に相当する小さな修正finding-ios-simulator スキルを使用してシミュレータ名を取得する。
xcrun simctl list devices booted 2>/dev/null
xcrun simctl boot "<シミュレータ名>" 2>&1 || true
Firebase Emulator は Maestro フロー（特に 04/05 の生成系）の前提。ここで必ず疎通確認する。
curl -sf http://127.0.0.1:5001/moodboard-genai-dev/asia-northeast1/ >/dev/null 2>&1
または:
lsof -ti:5001 2>/dev/null
重要: グローバル firebase コマンドが無い環境があるので、必ず functions/node_modules/.bin/firebase をフルパスで使う。
Bash の run_in_background で起動する:
cd mood-board-firebase && ./functions/node_modules/.bin/firebase emulators:start \
--only auth,firestore,functions,storage \
--project moodboard-genai-dev \
> /Users/<user>/.../mood-board-app/.artifacts/<feature>/logs/emulator.log 2>&1
curl -sf -X POST "http://127.0.0.1:5001/moodboard-genai-dev/asia-northeast1/onRequest-SeedTestData?reset=1"
curl -sf -X DELETE "http://127.0.0.1:9099/emulator/v1/projects/moodboard-genai-dev/accounts"
pgrep -f 'expo|metro' 2>/dev/null
| 状態 | アクション |
|---|---|
| このセッションで起動した Metro が生存 | ビルドスキップ → Step 3 |
| 不明な Metro が動作中 | ユーザーに確認 |
| Metro なし + アプリ未インストール | フルビルド（Step 2a） |
| Metro なし + アプリインストール済み | Metro だけ起動 → Step 3 |
xcrun simctl listapps booted 2>/dev/null | grep "dev.mooz.ai.app"
# または
xcrun simctl get_app_container booted dev.mooz.ai.app app 2>/dev/null
pkill -f 'expo start|metro' 2>/dev/null || true
cd mood-board-app && BUILD_FLAVOR=dev npx expo prebuild --platform ios
cd mood-board-app && BUILD_FLAVOR=dev npx expo run:ios --device "<シミュレータ名>"
ビルドは 5〜10 分。run_in_background で実行し、完了まで待機。
cd mood-board-app && FIREBASE_EMULATOR=true BUILD_FLAVOR=dev \
npx expo start --dev-client -c \
> /Users/<user>/.../mood-board-app/.artifacts/<feature>/logs/metro.log 2>&1
8081 ポートが ready になるまで待機。
expo run:ios 初回、あるいは launchApp 後に出るシステムダイアログを mcp__maestro__inspect_view_hierarchy で検出して対処:
| ダイアログ | アクション |
|---|---|
| "Open in mooz.ai?" | 「Open」をタップ |
| 通知許可 | 「Don't Allow」をタップ（フロー側で消費されない想定） |
| トラッキング許可 (ATT) | 「Allow」をタップ |
| Apple Account / "Sign in to Apple Account" | 「Cancel」をタップ |
| Expo Dev Launcher "Development servers" | dev.mooz.ai をタップ |
これらは本来 helpers/_prelude.yaml が処理する。処理漏れを見つけたら _prelude.yaml に追記する（後述のループ内修正）。
take_screenshot でバンドル完了（SignUp 画面が見えている）を確認する。通常 10〜20 秒。
mkdir -p .artifacts/<feature>/recordings
xcrun simctl io booted recordVideo --codec h264 \
.artifacts/<feature>/recordings/session-$(date +%Y%m%d-%H%M%S).mp4 &
RECORD_PID=$!
録画は Step 7 で停止する。フロー単位で分けたい場合は各フローの開始／終了で再録画する。
フローは以下の順で、1 本ずつ実行する。一括 (run_flow_files に複数パスを渡す) は禁止。
mood-board-app/.maestro/flows/01_auth.yaml
mood-board-app/.maestro/flows/02_navigation.yaml
mood-board-app/.maestro/flows/03_sign_out_cycle.yaml
mood-board-app/.maestro/flows/04_album_generation.yaml
mood-board-app/.maestro/flows/05_video_generation.yaml
[A] 実行
mcp__maestro__run_flow_files(device_id=<id>, flow_files="<1本だけ>")
↓ PASS → [G] 次のフローへ
↓ FAIL
[B] 画面状態の捕捉（必須・最初に 1 回）
1. mcp__maestro__take_screenshot
→ .artifacts/<feature>/screenshots/<flow>-fail-<timestamp>.png に保存
2. mcp__maestro__inspect_view_hierarchy
→ 階層 JSON をログへ
3. tail -80 .artifacts/<feature>/logs/metro.log
4. tail -80 .artifacts/<feature>/logs/emulator.log
[C] 原因分類（下表）
[D] 分類 A〜G のみ自動修正
- flows/*.yaml は絶対に触らない
- 直すのは helpers/*.yaml と環境側のみ
- 修正内容を REPORT.md の「修正ログ」に追記
[E] 同じフローを再実行
→ PASS: [G] へ
→ 同じエラーで FAIL: [B]〜[D] のループ（最大 3 回）
→ 4 回目に入る前、または分類 H/I に該当: 停止してユーザーに相談
[F] 分類 H / I に突き当たった場合:
- H: 期待する testID が画面に存在しない（フロー側の検証仕様変更が必要）
- I: 生成が 5 分超で返ってこない（Emulator の stub/Vertex 設定調査が必要）
これらは **勝手に flows/*.yaml を書き換えず**、ここで停止してユーザーに報告する
[G] 次のフローへ進む
| 分類 | 典型的な症状 | 修正先 | 自動/手動 |
|---|---|---|---|
| A | Expo Dev Launcher が表示されたまま | helpers/_prelude.yaml に Launcher 処理追加 | 自動 |
| B | 未処理ダイアログ（Apple/ATT/通知/RedBox） | helpers/_prelude.yaml or sign_up.yaml | 自動 |
| C | 画面遷移は正しいが要素が描画される前にタップしている | 該当 helper に extendedWaitUntil 追加 | 自動 |
| D | topic-list-screen が空（データ未シード） | 環境: SeedTestData?reset=1 再実行 | 自動 |
| E | SignUp 画面のまま匿名ボタンが効かない | 環境: Auth Emulator DELETE accounts | 自動 |
| F | Metro に繋がっていない（白画面・Bundling のまま） | 環境: Metro 再起動 | 自動 |
| G | 前回セッションの keychain / 写真ライブラリが残留 | 環境: xcrun simctl keychain booted reset 等 | 自動 |
| H | 期待する testID が画面に存在しない | フロー検証仕様の変更が必要 → 停止相談 | 手動 |
| I | 生成が 5 分超で返ってこない | Emulator の生成 stub 調査 → 停止相談 | 手動 |
kill -INT $RECORD_PID 2>/dev/null
wait $RECORD_PID 2>/dev/null
録画は PASS/FAIL 問わず .artifacts/<feature>/recordings/ に残す。
## 実行情報
- デバイス: iPhone 17 Pro (iOS 26.1)
- Firebase Emulator: ready (PID / ログパス)
- Metro: ready (8081)
- 実行時間: XX 秒
- 録画: .artifacts/<feature>/recordings/xxx.mp4
| フロー | 結果 | リトライ回数 | 修正内容 |
|--------------------------------|-----------|-------------|---------------------------------|
| 01_auth.yaml | PASS/FAIL | 0/1/2/3 | 例: _prelude に Allow ダイアログ |
| 02_navigation.yaml | | | |
| 03_sign_out_cycle.yaml | | | |
| 04_album_generation.yaml | | | |
| 05_video_generation.yaml | | | |
修正ログセクションに、ループ内で何をなぜ直したかを箇条書きで記録する（次回セッションのデバッグ資産になる）。
take_screenshot を最初に呼ぶinspect_view_hierarchy を併用する_prelude.yaml 側の構造的な欠落を疑うflows/*.yaml の検証ステップは改変禁止。フロー側を触りたくなった時点で、それは分類 H / I → 停止してユーザーに相談mcp__maestro__list_devices()
connected: true のデバイスを使用。
dev.mooz.ai.appmood-board-app/mood-board-app/.maestro/flows/mood-board-app/.maestro/helpers/（修正 OK）devmoodboard-genai-dev, functions=5001, auth=9099, firestore=8080, storage=9199mood-board-app/.artifacts/<feature>/{screenshots,recordings,logs}（<feature> はブランチ名ベース）