Claude Code で iOS テスト基盤を組み直す — XCTest・Swift Testing・XCUITest の役割分担

# MyApp CLAUDE.md
 
## アーキテクチャ
- パターン: MVVM + Coordinator
- 非同期処理: Swift Concurrency (async/await + Actor)
- DI: 手製のコンテナ（ServiceLocator）を使用
 
## テスト方針
- Unit Test: Swift Testing フレームワーク優先（Xcode 16+）
- Integration Test: XCTest で Repository〜ViewModel 間を検証
- UI Test: XCUITest で Critical Path のみ（ログイン・購入フロー）
 
## テストファイル命名規則
- Unit: `{対象クラス名}Tests.swift`
- Integration: `{機能名}IntegrationTests.swift`
- UI: `{フロー名}UITests.swift`
 
## モック方針
- プロトコルベースのモックを使用（Mockolo 不使用）
- テストダブルは `Mocks/` フォルダに集約
 
## 禁止事項
- 本番コードに #if DEBUG ブロックを使わない
- sleep() による非同期待機は禁止（XCTestExpectation or async/await を使う）

// Swift Testing での ViewModel テスト例
import Testing
@testable import MyApp
 
@Suite("ArticleViewModel Tests")
struct ArticleViewModelTests {
 
    // 依存関係のセットアップ
    let mockRepository: MockArticleRepository
    let viewModel: ArticleViewModel
 
    init() {
        mockRepository = MockArticleRepository()
        viewModel = ArticleViewModel(repository: mockRepository)
    }
 
    @Test("初回ロード時に記事一覧を取得できる")
    func fetchArticlesOnLoad() async throws {
        // Arrange
        let expected = [Article.stub(id: "1"), Article.stub(id: "2")]
        mockRepository.stubbedArticles = expected
 
        // Act
        await viewModel.loadArticles()
 
        // Assert
        #expect(viewModel.articles.count == 2)
        #expect(viewModel.articles.first?.id == "1")
        #expect(!viewModel.isLoading)
    }
 
    @Test("ネットワークエラー時にエラーメッセージを表示する")
    func showErrorOnNetworkFailure() async throws {
        // Arrange
        mockRepository.shouldThrowError = true
 
        // Act
        await viewModel.loadArticles()
 
        // Assert
        #expect(viewModel.errorMessage != nil)
        #expect(viewModel.articles.isEmpty)
    }
 
    // Parameterized Test: 複数の入力値で同一ロジックをテスト
    @Test("各カテゴリのフィルタリングが正しく動作する", arguments: [
        ("tech", 3),
        ("design", 2),
        ("business", 0)
    ])
    func filterByCategory(category: String, expectedCount: Int) async throws {
        mockRepository.stubbedArticles = Article.stubCollection()
        await viewModel.loadArticles()
        viewModel.filterByCategory(category)
        #expect(viewModel.filteredArticles.count == expectedCount)
    }
}

# 実装ファイルを指定してテストを生成
claude "Sources/Features/Article/ArticleViewModel.swift を読んで、
Swift Testingフレームワーク（import Testing）を使ったユニットテストを
ArticleViewModelTests.swift として生成してください。
- 全publicメソッドのハッピーパスとエラーケースをカバー
- パラメータ化テストを活用
- モックは Sources/Tests/Mocks/ の既存パターンに合わせる"

# 移行候補の特定
claude "Tests/ フォルダ配下の全 XCTest ファイルを分析して、
Swift Testing に移行しやすい順にリストアップしてください。
判断基準: setUp/tearDown の複雑さ・非同期処理の有無・依存関係の数"

# 特定ファイルの移行
claude "Tests/Unit/UserServiceTests.swift を XCTest から Swift Testing に移行してください。
変換ルール:
- XCTAssertEqual → #expect(a == b)
- XCTAssertNil → #expect(value == nil)
- setUp() → init()
- tearDown() → deinit（deinit を使う場合は Suite を struct ではなく final class にする）
- 非同期: XCTestExpectation → async/await
元のファイルはバックアップし、変換後のファイルで上書きしてください"

claude "このアプリのCritical Pathとして以下のフローをUIテスト化してください:
1. メールアドレス+パスワードでのログインフロー
2. 商品詳細→カート追加→購入完了フロー
各テストでアクセシビリティIDを使い、UI変更に強いセレクターにすること"

// XCUITest の例: ログインフロー
import XCTest
 
final class LoginFlowUITests: XCTestCase {
 
    private var app: XCUIApplication!
 
    override func setUpWithError() throws {
        continueAfterFailure = false
        app = XCUIApplication()
        // テスト用の環境変数でモックサーバーを起動
        app.launchEnvironment["USE_MOCK_SERVER"] = "true"
        app.launchEnvironment["RESET_STATE"] = "true"
        app.launch()
    }
 
    func testLoginWithValidCredentials() throws {
        // ログイン画面に遷移
        let loginButton = app.buttons["nav_login_button"]
        XCTAssertTrue(loginButton.waitForExistence(timeout: 5))
        loginButton.tap()
 
        // メールアドレス入力
        let emailField = app.textFields["login_email_field"]
        XCTAssertTrue(emailField.waitForExistence(timeout: 3))
        emailField.tap()
        emailField.typeText("test@example.com")
 
        // パスワード入力
        let passwordField = app.secureTextFields["login_password_field"]
        passwordField.tap()
        passwordField.typeText("TestPassword123!")
 
        // ログインボタンをタップ
        app.buttons["login_submit_button"].tap()
 
        // ホーム画面への遷移を確認
        let homeTitle = app.navigationBars["home_nav_bar"]
        XCTAssertTrue(homeTitle.waitForExistence(timeout: 10),
                      "ログイン後にホーム画面が表示されるべき")
    }
 
    func testLoginWithInvalidPassword() throws {
        let loginButton = app.buttons["nav_login_button"]
        loginButton.tap()
 
        app.textFields["login_email_field"].tap()
        app.textFields["login_email_field"].typeText("test@example.com")
        app.secureTextFields["login_password_field"].tap()
        app.secureTextFields["login_password_field"].typeText("wrongpassword")
        app.buttons["login_submit_button"].tap()
 
        // エラーメッセージの表示を確認
        let errorMessage = app.staticTexts["login_error_message"]
        XCTAssertTrue(errorMessage.waitForExistence(timeout: 5))
    }
}

claude "Sources/Features/Login/ フォルダ配下の SwiftUI ビューに、
UIテスト用のアクセシビリティIDを追加してください。
命名規則: {画面名}_{要素タイプ}_{連番} 例: login_email_field, login_submit_button
変更後のファイルを上書きして、追加した ID の一覧をリストアップしてください"

# ターミナルからカバレッジ付きでテストを実行
xcodebuild test \
  -project MyApp.xcodeproj \
  -scheme MyApp \
  -destination 'platform=iOS Simulator,name=iPhone 16' \
  -enableCodeCoverage YES \
  -resultBundlePath ./TestResults.xcresult
 
# カバレッジレポートを JSON で出力
xcrun xccov view --report --json TestResults.xcresult > coverage.json

claude "coverage.json を分析して、
カバレッジが60%未満のファイルをリストアップし、
各ファイルについてカバーされていないコードパスのテストケースを提案してください。
優先順位はビジネスロジックを含むファイル（ViewModel, Service, Repository）を高く設定してください"

#!/bin/bash
# scripts/check_coverage.sh
# PR マージ前にカバレッジが閾値を下回っていないかチェック
 
THRESHOLD=80
COVERAGE=$(xcrun xccov view --report --json TestResults.xcresult | \
  python3 -c "import json,sys; d=json.load(sys.stdin); \
  print(round(d['lineCoverage'] * 100, 1))")
 
echo "Current coverage: ${COVERAGE}%"
 
if (( $(echo "$COVERAGE < $THRESHOLD" | bc -l) )); then
  echo "❌ Coverage ${COVERAGE}% is below threshold ${THRESHOLD}%"
  exit 1
fi
 
echo "✅ Coverage check passed"

claude "Xcode Cloudのci_post_xcodebuild.sh スクリプトを作成してください。
要件:
- テスト失敗時にSlackへ通知（Webhook URL は環境変数 SLACK_WEBHOOK_URL）
- カバレッジレポートを DerivedData 配下にテキストで書き出す"

#!/bin/sh
# ci_post_xcodebuild.sh
set -e
 
# テスト結果の確認
if [ "$CI_XCODEBUILD_EXIT_CODE" -ne 0 ]; then
    echo "❌ Build or tests failed"
 
    # Slack通知
    if [ -n "$SLACK_WEBHOOK_URL" ]; then
        curl -s -X POST "$SLACK_WEBHOOK_URL" \
            -H 'Content-type: application/json' \
            --data "{
                \"text\": \"❌ *$CI_WORKFLOW_NAME* failed on branch \`$CI_BRANCH\`\",
                \"attachments\": [{
                    \"color\": \"danger\",
                    \"fields\": [{
                        \"title\": \"Commit\",
                        \"value\": \"$CI_COMMIT\"
                    }]
                }]
            }"
    fi
    exit 1
fi
 
echo "✅ All tests passed"
 
# カバレッジレポートの保存
if [ -d "$CI_RESULT_BUNDLE_PATH" ]; then
    xcrun xccov view --report "$CI_RESULT_BUNDLE_PATH" > "$CI_DERIVED_DATA_PATH/coverage_report.txt"
    echo "Coverage report saved"
fi

# .github/workflows/ios-tests.yml
name: iOS Tests
 
on:
  pull_request:
    branches: [main, develop]
 
jobs:
  test:
    runs-on: macos-15
    steps:
      - uses: actions/checkout@v4
 
      - name: Select Xcode
        run: sudo xcode-select -s /Applications/Xcode_16.3.app
 
      - name: Run Tests
        run: |
          set -o pipefail
          xcodebuild test \
            -project MyApp.xcodeproj \
            -scheme MyApp \
            -destination 'platform=iOS Simulator,name=iPhone 16,OS=18.4' \
            -enableCodeCoverage YES \
            -resultBundlePath ./TestResults.xcresult \
            | xcbeautify
 
      - name: Coverage Check
        run: bash scripts/check_coverage.sh
 
      - name: Upload Test Results
        if: always()
        uses: actions/upload-artifact@v4
        with:
          name: test-results
          path: TestResults.xcresult

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/xctest-feedback.sh"
          }
        ]
      }
    ]
  }
}

#!/bin/bash
# .claude/hooks/xctest-feedback.sh
# PostToolUse(Bash) で呼ばれ、xcodebuild test の失敗だけを Claude に返す
set -u
INPUT="$(cat)"
CMD="$(printf '%s' "$INPUT" | jq -r '.tool_input.command // ""')"
 
# テスト以外の Bash 実行には反応しない
case "$CMD" in
  *xcodebuild*test*) ;;
  *) exit 0 ;;
esac
 
# tool_response は形が変わりうるため、stdout / stderr があれば連結し、なければ丸ごと文字列にする
OUT="$(printf '%s' "$INPUT" | jq -r '
  .tool_response
  | if type == "object" then ([.stdout, .stderr] | map(select(. != null)) | join("\n"))
    else tostring end')"
 
COUNT_FILE="${CLAUDE_PROJECT_DIR:-.}/.claude/.xctest_fail_count"
PATTERN='\*\* TEST FAILED \*\*|Test Case .* failed|✘ Test'
 
if printf '%s' "$OUT" | grep -qE "$PATTERN"; then
  N=$(( $(cat "$COUNT_FILE" 2>/dev/null || echo 0) + 1 ))
  echo "$N" > "$COUNT_FILE"
  if [ "$N" -ge 3 ]; then
    echo "テストが ${N} 回続けて失敗しました。修正を止め、失敗したテスト名と原因の仮説だけを報告してください。" >&2
    rm -f "$COUNT_FILE"
    exit 2
  fi
  {
    echo "テストが失敗しています（${N} 回目）。実装側を直してください。テストの期待値は変更しないでください。"
    printf '%s' "$OUT" | grep -E "$PATTERN|error:" | head -30
  } >&2
  exit 2
fi
 
rm -f "$COUNT_FILE"
exit 0

// SwiftData テスト用ヘルパー
import SwiftData
import Testing
@testable import MyApp
 
@Suite("Article Persistence Tests")
struct ArticlePersistenceTests {
 
    // テストごとにクリーンなコンテナを使用
    var container: ModelContainer
 
    init() throws {
        let config = ModelConfiguration(isStoredInMemoryOnly: true)
        container = try ModelContainer(for: Article.self, configurations: config)
    }
 
    @Test("記事をCRUD操作できる")
    func articleCRUD() throws {
        let context = ModelContext(container)
 
        // Create
        let article = Article(title: "テスト記事", slug: "test-article")
        context.insert(article)
        try context.save()
 
        // Read
        let descriptor = FetchDescriptor<Article>()
        let articles = try context.fetch(descriptor)
        #expect(articles.count == 1)
        #expect(articles.first?.title == "テスト記事")
 
        // Update
        articles.first?.title = "更新された記事"
        try context.save()
 
        let updated = try context.fetch(descriptor)
        #expect(updated.first?.title == "更新された記事")
 
        // Delete
        if let toDelete = updated.first {
            context.delete(toDelete)
            try context.save()
        }
 
        let remaining = try context.fetch(descriptor)
        #expect(remaining.isEmpty)
    }
}

claude "Sources/Models/Article.swift の SwiftData モデル定義を読んで、
インメモリコンテナを使ったCRUDテストを ArticlePersistenceTests.swift として生成してください。
リレーション（Article → Tag の多対多）のテストも含めてください"

// パフォーマンステストの例
import XCTest
@testable import MyApp
 
final class ImageProcessingPerformanceTests: XCTestCase {
 
    func testImageFilterPerformance() throws {
        let image = UIImage(named: "test_image_2048x2048", in: Bundle(for: type(of: self)), with: nil)!
 
        measure(metrics: [XCTClockMetric(), XCTMemoryMetric()]) {
            // 計測したい処理
            _ = ImageProcessor.applyVintageFilter(to: image)
        }
    }
 
    func testArticleListRenderPerformance() throws {
        let articles = Article.generateLargeDataset(count: 1000)
 
        measure {
            // ViewModelのフィルタリング処理を計測
            let viewModel = ArticleListViewModel(articles: articles)
            viewModel.filter(by: "swift")
        }
    }
}

claude "Sources/Services/ImageProcessor.swift のフィルター処理が
最近のリファクタリング後に遅くなった気がします。
XCTestのパフォーマンステストを作成して、処理時間の計測ベースラインを設定してください"

// ArticleBuilder.swift — テスト用ビルダー
@testable import MyApp
 
struct ArticleBuilder {
    private var title: String = "テスト記事"
    private var slug: String = "test-article"
    private var category: String = "tech"
    private var isPremium: Bool = false
    private var publishedAt: Date = Date()
 
    func title(_ value: String) -> Self {
        var copy = self
        copy.title = value
        return copy
    }
 
    func slug(_ value: String) -> Self {
        var copy = self
        copy.slug = value
        return copy
    }
 
    func premium() -> Self {
        var copy = self
        copy.isPremium = true
        return copy
    }
 
    func publishedDaysAgo(_ days: Int) -> Self {
        var copy = self
        copy.publishedAt = Calendar.current.date(byAdding: .day, value: -days, to: Date())!
        return copy
    }
 
    func build() -> Article {
        Article(
            title: title,
            slug: slug,
            category: category,
            isPremium: isPremium,
            publishedAt: publishedAt
        )
    }
}
 
// 使用例
@Test("プレミアム記事のみフィルタリングされる")
func filterPremiumArticles() {
    let articles = [
        ArticleBuilder().build(),                      // 無料記事
        ArticleBuilder().premium().build(),            // プレミアム記事
        ArticleBuilder().premium().title("別のプレミアム記事").build()
    ]
    let viewModel = ArticleListViewModel(articles: articles)
    viewModel.showPremiumOnly()
    #expect(viewModel.filteredArticles.count == 2)
}

claude "Sources/Models/ フォルダ内の全 SwiftData モデルに対して、
テスト用の Builder クラスを Tests/Builders/ に生成してください。
既存の Article モデルの ArticleBuilder を参考パターンとして使用してください"

claude "ArticleFilter サービスに以下の振る舞いが必要です:
- filterByCategory(category: String): 指定カテゴリの記事のみ返す
- filterByLevel(level: Level): beginner/intermediate/advanced でフィルタ
- 複数条件はAND条件（カテゴリ AND レベルが一致するもののみ）
- 結果が0件の場合は空配列を返す（エラーをスローしない）
まずSwift Testingでテストだけ書いてください。実装はまだ不要です。"

claude "ArticleFilterTests.swift の全テストが通るように
ArticleFilter.swift を実装してください。
ViewModelへの依存注入ができるようにプロトコルベースで設計してください"

// アナリティクスを抽象化するプロトコル
protocol AnalyticsTracking {
    func track(event: String, parameters: [String: Any])
}
 
// テスト用モック：実際のSDKを呼ばずに記録だけする
final class MockAnalyticsTracker: AnalyticsTracking {
    var trackedEvents: [(name: String, params: [String: Any])] = []
 
    func track(event: String, parameters: [String: Any]) {
        trackedEvents.append((name: event, params: parameters))
    }
}
 
// テスト
@Test("記事閲覧時にアナリティクスイベントが送信される")
func articleViewTracksEvent() async throws {
    let mockTracker = MockAnalyticsTracker()
    let viewModel = ArticleViewModel(analytics: mockTracker)
 
    await viewModel.markAsViewed(articleId: "article-123")
 
    #expect(mockTracker.trackedEvents.count == 1)
    #expect(mockTracker.trackedEvents.first?.name == "article_viewed")
}

claude "Sources/ 配下でテストされていないアナリティクス呼び出しを全て特定してください。
ファイル名と行番号のリストを出力し、プロトコルインジェクションで
テスト可能にする方法を提案してください"

// ❌ 悪い例: sleep で待機
func testAsyncOperation() async throws {
    viewModel.startFetch()
    try await Task.sleep(nanoseconds: 2_000_000_000) // 2秒待機
    XCTAssertTrue(viewModel.isLoaded) // 不安定
}
 
// ✅ 良い例: confirmation で明示的に待機
@Test func testAsyncOperation() async throws {
    await confirmation("データが読み込まれる") { confirm in
        viewModel.onLoadComplete = { confirm() }
        await viewModel.startFetch()
    }
    #expect(viewModel.isLoaded)
}

// ❌ Actor の状態にメインスレッド外からアクセス
@Test func testActorState() async throws {
    let actor = MyActor()
    await actor.performWork()
    XCTAssertEqual(actor.state, .completed) // ❌ Isolation violation
}
 
// ✅ await でアクセス
@Test func testActorState() async throws {
    let actor = MyActor()
    await actor.performWork()
    let state = await actor.state // ✅ 
    #expect(state == .completed)
}

# Claude Code に診断を依頼
claude "XCUITest で 'login_submit_button' が見つからないエラーが発生しています。
LoginView.swift のアクセシビリティID設定と、
UIテストの waitForExistence タイムアウト設定を確認して修正案を提示してください"