Communitygithub.com

ComeOnOliver/skillshub

UIテスト作成時、インタラクションの記録、競合状態やタイミング依存、不安定なパス/フェイル動作、XCTest UIテストのフレーキー問題に対処するスキル。WWDC 2025の記録UI自動化、条件ベースの待機、ネットワークコンディショニング、多要素テスト、クラッシュデバッグ、アクセシビリティファーストのテストパターンを網羅します。

skillshub とは?

このスキルは、iOS/macOS向けUIテストの信頼性を最大化するための包括的なガイドです。従来の`sleep()`に依存した不確定な待機ではなく、`waitForExistence`や`XCTestExpectation`を使用した条件ベースの待機パターンに焦点を当て、テストのフレーキー性を根本から排除します。特に、ローカルとCI環境でのタイミング差異、アニメーションやネットワーク遅延による競合状態、多様なデバイスサイズやローカライゼーションへの対応など、実践的な課題を解決するためのテクニックを提供します。さらに、Xcode 26の新機能である記録UI自動化を活用したテスト記録・再生・ビデオデバッグのワークフローや、アクセシビリティ識別子を用いた堅牢なテスト設計、ネットワークコンディショニング、多要素テスト戦略についても詳細に説明しています。テストエンジニアは、このスキルを通じて、テストスイート全体の実行時間を短縮しながら、失敗率を劇的に低減させる方法を習得できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/CharlesWiltgen/Axiom/axiom-ui-testing

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

UIテスト

概要

条件を待機し、恣意的なタイムアウトは避けてください。核となる原則 フレーキーテストは、操作にかかる時間を推測することから発生します。条件ベースの待機が競合状態を排除します。

WWDC 2025の新機能: 記録UI自動化により、インタラクションを記録し、複数のデバイス/言語で再生し、テスト実行のビデオ録画を確認できます。

プロンプト例

以下は、開発者が実際に質問し、このスキルが回答するように設計された質問です。

1. 「UIテストがMacではローカルでパスするのに、CIでは失敗します。どうすれば信頼性を高められますか?」

→ このスキルは、デバイス/速度に関係なく動作する条件ベースの待機パターンを示し、CIのタイミング差異を排除します

2. 「テストでsleep(2)とsleep(5)を使っていますが、まだフレーキーです。恣意的なタイムアウトを実際の条件に置き換えるにはどうすればよいですか?」

→ このスキルは、データ読み込み、ネットワークリクエスト、アニメーションに対するwaitForExistence、XCTestExpectation、ポーリングパターンを説明します

3. 「Xcode 26の記録UI自動化を使ってテストを記録しました。ビデオを確認して失敗をデバッグするにはどうすればよいですか?」

→ このスキルは、録画を分析し、テストが失敗する正確なステップを見つけるためのビデオデバッグワークフローをカバーします

4. 「テストがiPadでは失敗するが、iPhoneではパスします。すべてのデバイスサイズで動作するテストを書くにはどうすればよいですか?」

→ このスキルは、堅牢なクロスデバイステストのための多要素テスト戦略とデバイスに依存しない述語を説明します

5. 「フレーキーでないテストを書きたいです。知っておくべき重要なパターンは何ですか?」

→ このスキルは、信頼性の高いテストアーキテクチャのための条件ベースの待機テンプレート、アクセシビリティファーストのパターン、決定木を提供します


レッドフラグ — テストの信頼性問題

これらのいずれかが見られる場合、タイミングの問題を疑ってください:

  • テストがローカルでパスし、CIで失敗する(タイミングの差異)
  • テストが通ったり通らなかったりする(競合状態)
  • テストがsleep()またはThread.sleep()を使用している(恣意的な遅延)
  • 「UI要素が見つかりません」で失敗し、再試行でパスする
  • テスト実行が長い(最悪のシナリオを待機している)

クイック決定木

テストが失敗?
├─ 要素が見つからない?
│  └─ sleep()ではなくwaitForExistence(timeout:)を使用
├─ ローカルでパス、CIで失敗?
│  └─ sleep()を条件ポーリングに置き換え
├─ アニメーションが問題?
│  └─ アニメーション完了を待機、無効化しない
└─ ネットワークリクエストのタイミング?
   └─ XCTestExpectationまたはwaitForExistenceを使用

コアパターン: 条件ベースの待機

❌ 間違い(恣意的なタイムアウト):

func testButtonAppears() {
    app.buttons["Login"].tap()
    sleep(2)  // ❌ 2秒かかると推測
    XCTAssertTrue(app.buttons["Dashboard"].exists)
}

✅ 正しい(条件を待機):

func testButtonAppears() {
    app.buttons["Login"].tap()
    let dashboard = app.buttons["Dashboard"]
    XCTAssertTrue(dashboard.waitForExistence(timeout: 5))
}

一般的なUIテストパターン

パターン1: 要素の出現を待機

// 要素が表示されるのを待機
func waitForElement(_ element: XCUIElement, timeout: TimeInterval = 5) -> Bool {
    return element.waitForExistence(timeout: timeout)
}

// 使用例
XCTAssertTrue(waitForElement(app.buttons["Submit"]))

パターン2: 要素の消失を待機

func waitForElementToDisappear(_ element: XCUIElement, timeout: TimeInterval = 5) -> Bool {
    let predicate = NSPredicate(format: "exists == false")
    let expectation = XCTNSPredicateExpectation(predicate: predicate, object: element)
    let result = XCTWaiter().wait(for: [expectation], timeout: timeout)
    return result == .completed
}

// 使用例
XCTAssertTrue(waitForElementToDisappear(app.activityIndicators["Loading"]))

パターン3: 特定の状態を待機

func waitForButton(_ button: XCUIElement, toBeEnabled enabled: Bool, timeout: TimeInterval = 5) -> Bool {
    let predicate = NSPredicate(format: "isEnabled == %@", NSNumber(value: enabled))
    let expectation = XCTNSPredicateExpectation(predicate: predicate, object: button)
    let result = XCTWaiter().wait(for: [expectation], timeout: timeout)
    return result == .completed
}

// 使用例
let submitButton = app.buttons["Submit"]
XCTAssertTrue(waitForButton(submitButton, toBeEnabled: true))
submitButton.tap()

パターン4: アクセシビリティ識別子

アプリでの設定:

Button("Submit") {
    // アクション
}
.accessibilityIdentifier("submitButton")

テストでの使用:

func testSubmitButton() {
    let submitButton = app.buttons["submitButton"]  // ラベルではなく識別子を使用
    XCTAssertTrue(submitButton.waitForExistence(timeout: 5))
    submitButton.tap()
}

理由: アクセシビリティ識別子はローカライゼーションによって変化せず、UIの更新全体で安定しています。

パターン5: ネットワークリクエストの遅延

func testDataLoads() {
    app.buttons["Refresh"].tap()

    // 読み込みインジケータが消えるのを待機
    let loadingIndicator = app.activityIndicators["Loading"]
    XCTAssertTrue(waitForElementToDisappear(loadingIndicator, timeout: 10))

    // データが読み込まれたことを確認
    XCTAssertTrue(app.cells.count > 0)
}

パターン6: アニメーションの処理

func testAnimatedTransition() {
    app.buttons["Next"].tap()

    // 遷移先のビューが表示されるのを待機
    let destinationView = app.otherElements["DestinationView"]
    XCTAssertTrue(destinationView.waitForExistence(timeout: 2))

    // オプション: アニメーションが落ち着くのを少し待機
    // 絶対に必要な場合のみ
    RunLoop.current.run(until: Date(timeIntervalSinceNow: 0.3))
}

テストチェックリスト

テスト作成前

  • すべてのインタラクティブ要素にアクセシビリティ識別子を使用する
  • ハードコードされたラベルを避ける(代わりに識別子を使用)
  • ネットワーク遅延とアニメーションを計画する
  • 適切なタイムアウトを選択する(UIは2秒、ネットワークは10秒)

テスト作成時

  • sleep()ではなくwaitForExistence()を使用する
  • 複雑な条件には述語を使用する
  • 成功パスと失敗パスの両方をテストする
  • テストを独立させる(任意の順序で実行可能)

テスト作成後

  • テストをローカルで10回実行する(フレーキー性を検出)
  • サポート対象の最も遅いデバイスでテストを実行する
  • CI環境でテストを実行する
  • テスト時間を確認する(1テストあたり30秒超の場合は最適化)

Xcode UIテストのヒント

テスト用の起動引数

func testExample() {
    let app = XCUIApplication()
    app.launchArguments = ["UI-Testing"]
    app.launch()
}

アプリコード内:

if ProcessInfo.processInfo.arguments.contains("UI-Testing") {
    // モックデータを使用、オンボーディングをスキップなど
}

テスト実行の高速化

override func setUpWithError() throws {
    continueAfterFailure = false  // 最初の失敗で停止
}

失敗テストのデバッグ

func testExample() {
    // 失敗時にスクリーンショットを撮る
    addUIInterruptionMonitor(withDescription: "アラート") { alert in
        alert.buttons["OK"].tap()
        return true
    }

    // 要素階層を出力
    print(app.debugDescription)
}

よくある間違い

❌ すべてにsleep()を使用

sleep(5)  // ❌ 操作が1秒で完了しても時間を浪費

❌ アニメーションを処理しない

app.buttons["Next"].tap()
XCTAssertTrue(app.buttons["Back"].exists)  // ❌ アニメーション中に失敗する可能性

❌ ハードコードされたテキストラベル

app.buttons["Submit"].tap()  // ❌ ローカライゼーションで破綻

❌ テストが互いに依存

// ❌ テスト2はテスト1が先に実行されることを前提としている
func test1_Login() { /* ... */ }
func test2_ViewDashboard() { /* ログイン済みを前提 */ }

❌ タイムアウト戦略がない

element.waitForExistence(timeout: 100)  // ❌ 長すぎる
element.waitForExistence(timeout: 0.1)  // ❌ 短すぎる

適切なタイムアウトを使用:

  • UIアニメーション: 2〜3秒
  • ネットワークリクエスト: 10秒
  • 複雑な操作: 最大30秒

実際の影響

Before(sleep()を使用):

  • テストスイート: 15分(最悪のケースを待機)
  • フレーキーテスト: 20%の失敗率
  • CI障害: 50%が再試行を必要とする

After(条件ベースの待機):

  • テストスイート: 5分(必要なときだけ待機)
  • フレーキーテスト: <2%の失敗率
  • CI障害: <5%が再試行を必要とする

重要な洞察 テストは、時間を推測する代わりに実際の条件を待機することで、より速く完了し、かつより信頼性が高くなります。


記録UI自動化

概要

Xcode 26の新機能: UI自動化テストをビデオ録画で記録、再生、レビュー。

3つのフェーズ:

  1. 記録 — インタラクション(タップ、スワイプ、ハードウェアボタン押下)をSwiftコードとしてキャプチャ
  2. 再生 — 複数のデバイス、言語、地域、向きで実行
  3. レビュー — ビデオ録画を視聴、失敗を分析、UI要素オーバーレイを表示

サポートプラットフォーム: iOS、iPadOS、macOS、watchOS、tvOS、axiom-visionOS(iPad用に設計)

UI自動化の仕組み

主要原則:

  • UI自動化は、ジェスチャーとハードウェアイベントを使用して、人が行うようにアプリと対話します
  • アプリから完全に独立して実行されます(アプリのモデル/データには直接アクセス不可)
  • 基盤技術としてアクセシビリティフレームワークを使用します
  • OSに実行するジェスチャーを指示し、同期的に1つずつ完了を待機します

アクションには以下が含まれます:

  • アプリの起動
  • ボタンやナビゲーションとの対話
  • システム状態の設定(ダークモード、axiom-localizationなど)
  • シミュレートされた位置情報の設定

アクセシビリティが基盤

重要な理解: アクセシビリティはUI自動化に直接情報を提供します。

アクセシビリティが見るもの:

  • 要素タイプ(ボタン、テキスト、画像など)
  • ラベル(表示テキスト)
  • 値(チェックボックスなどの現在の状態)
  • フレーム(要素の位置)
  • 識別子(アクセシビリティ識別子 — ローカライズされません)

ベストプラクティス: 優れたアクセシビリティ体験 = 優れたUI自動化体験

記録のためのアプリの準備

ステップ1: アクセシビリティ識別子の追加

SwiftUI:

Button("Submit") {
    // アクション
}
.accessibilityIdentifier("submitButton")

// インスタンス固有の識別子にする
List(landmarks) { landmark in
    LandmarkRow(landmark)
        .accessibilityIdentifier("landmark-\(landmark.id)")
}

UIKit:

let button = UIButton()
button.accessibilityIdentifier = "submitButton"

// テーブルセルにはインデックスを使用
cell.accessibilityIdentifier = "cell-\(indexPath.row)"

良い識別子の条件:

  • ✅ アプリ全体で一意
  • ✅ 要素の内容を説明している
  • ✅ 静的(コンテンツの変更に反応しない)
  • ✅ ローカライズされていない(すべての言語で同じ)

識別子が重要な理由:

  • タイトル/説明は変更される可能性があるが、識別子は安定している
  • ローカライズされた文字列全体で機能する
  • 動的コンテンツを持つ要素を一意に識別する

プロのヒント: Xcodeのコーディングアシスタントを使用して識別子を追加:

プロンプト:「このビューの関連部分にアクセシビリティ識別子を追加してください」

ステップ2: アクセシビリティインスペクタでアクセシビリティを確認

アクセシビリティインスペクタの起動:

  • Xcodeメニュー → 開発ツールを開く → アクセシビリティインスペクタ
  • または: Spotlightから起動

機能:

  1. 要素インスペクタ — 任意のビューのアクセシビリティ値を一覧表示
  2. プロパティの詳細 — プロパティ名をクリックしてドキュメントを表示
  3. プラットフォームサポート — すべてのAppleプラットフォームで動作

確認すべきこと:

  • 要素にラベルがある
  • インタラクティブな要素にタイプがある(テキストだけでなくボタン)
  • 状態を持つ要素(チェックボックス、トグル)に値が設定されている
  • 動的/ローカライズされたコンテンツを持つ要素に識別子が設定されている

サンプルコード参照: 優れたアクセシビリティ体験の提供

ステップ3: UIテストターゲットの追加

  1. Xcodeでプロジェクト設定を開く
  2. ターゲットリストの下にある「+」をクリック
  3. UI Testing Bundleを選択
  4. 完了をクリック

結果: テンプレートテストを含む新しいUIテストフォルダがプロジェクトに追加されます

インタラクションの記録

記録の開始(Xcode 26)

  1. UIテストソースファイルを開く
  2. ポップオーバーが表示され、記録の開始方法を説明(初回のみ)
  3. エディタガターの**「記録開始」**ボタンをクリック
  4. Xcodeがアプリをビルドし、シミュレータ/デバイスで起動

記録中:

  • アプリと通常通り対話(タップ、スワイプ、テキスト入力など)
  • インタラクションを表すコードがソースエディタにリアルタイムで表示されます
  • 入力(テキストフィールドへの入力など)に応じて記録が更新されます

記録の停止:

  • Xcodeの**「実行停止」**ボタンをクリック

記録セッションの例

func testCreateAustralianCollection() {
    let app = XCUIApplication()
    app.launch()

    // 「コレクション」タブをタップ(自動的に記録)
    app.tabBars.buttons["Collections"].tap()

    // 「+」をタップして新しいコレクションを追加
    app.navigationBars.buttons["Add"].tap()

    // 「編集」ボタンをタップ
    app.buttons["Edit"].tap()

    // コレクション名を入力
    app.textFields.firstMatch.tap()
    app.textFields.firstMatch.typeText("Max's Australian Adventure")

    // 「ランドマークを編集」をタップ
    app.buttons["Edit Landmarks"].tap()

    // ランドマークを追加
    app.tables.cells.containing(.staticText, identifier:"Great Barrier Reef").buttons["Add"].tap()
    app.tables.cells.containing(.staticText, identifier:"Uluru").buttons["Add"].tap()

    // チェックマークをタップして保存
    app.navigationBars.buttons["Done"].tap()
}

記録されたコードの確認

記録後、クエリを確認して調整:

複数のオプション: 各行には、要素をアドレスする代替方法を示すドロップダウンがあります。

選択の推奨事項:

  1. ローカライズされた文字列(テキスト、ボタンラベル)の場合: 利用可能な場合はアクセシビリティ識別子を選択
  2. 深くネストされたビューの場合: 最も短いクエリを選択(アプリの変更に強い)
  3. 動的コンテンツ(タイムスタンプ、温度)の場合: 汎用クエリまたは識別子を使用

例:

// テキストフィールドの記録オプション:
app.textFields["Collection Name"]              // ❌ ラベルがローカライズされると破綻
app.textFields["collectionNameField"]          // ✅ 識別子を使用
app.textFields.element(boundBy: 0)             // ✅ 位置ベース
app.textFields.firstMatch                      // ✅ 汎用的、最短

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

関連スキル