maestro-e2e

使用する場面

次の場合は、このスキルを使用してください。

• E2E テスト、UI テスト、統合テストを作成するとき
• ログイン、登録、ナビゲーションのフローをテストするとき
• 権限ダイアログ（カメラ、位置情報、通知）を扱うとき
• テスト失敗のデバッグや、UI 階層の調査を行うとき
• Maestro のテストファイル（.yaml）を扱うとき

キャプション

ネイティブの権限ダイアログを扱う場合は、プラットフォーム固有の情報を確認するため、./rules/permissions.md ファイルを読み込んでください。

Flutter アプリを扱う場合は、Semantics パターンを確認するため、./rules/platforms/flutter.md ファイルを読み込んでください。

使用方法

詳しい説明とコード例については、個別のルールファイルを参照してください。

コア

• rules/installation.md - macOS、Linux、Windows への Maestro のインストール
• rules/test-structure.md - YAML テストの構造、appId、環境変数、フローの定義
• rules/commands.md - 40 種類以上の Maestro コマンドの完全なリファレンス
• rules/selectors.md - id、text、index、マッチャーによる要素の指定
• rules/assertions.md - assertVisible、assertNotVisible、assertTrue、AI アサーション
• rules/interactions.md - tapOn、inputText、スクロール、スワイプ、ジェスチャーのコマンド
• rules/permissions.md - iOS と Android の権限設定とダイアログの処理

プラットフォーム

• rules/platforms/android.md - Android 固有の情報：ADB、権限ダイアログ、エミュレーター
• rules/platforms/ios.md - iOS 固有の情報：ダイアログの自動非表示、シミュレーター、制限事項
• rules/platforms/flutter.md - Semantics と identifier を使った Flutter の統合
• rules/platforms/react-native.md - testID と accessibilityLabel を使った React Native
• rules/platforms/web.md - Chromium を使ったデスクトップブラウザーのテスト

高度な内容

• rules/advanced/parameters.md - 環境変数、外部パラメーター、${} 構文
• rules/advanced/conditions.md - when: visible、platform による条件付き実行
• rules/advanced/nested-flows.md - runFlow コマンドによる再利用可能なサブフロー
• rules/advanced/javascript.md - evalScript、runScript、GraalJS のサポート
• rules/advanced/waiting.md - extendedWaitUntil、waitForAnimationToEnd
• rules/advanced/repeat-retry.md - 不安定なテストのための繰り返しと再試行のパターン

その他

• rules/debugging.md - Maestro Studio、階層の調査、トラブルシューティング
• rules/screenshots.md - スクリーンショット、動画の録画、視覚的な証拠
• rules/ci-integration.md - GitHub Actions、GitLab CI、Maestro Cloud
• rules/best-practices.md - セマンティック識別子、アトミックなテスト、プロジェクト構造