Swift Testing

概要

このスキルを使用して、モダンな Swift Testing API でテストを作成、レビュー、マイグレーション、デバッグします。可読性の高いテスト、堅牢な並列実行、明確な診断情報、および必要に応じて XCTest からの段階的なマイグレーションを優先します。

エージェント動作契約（以下のルールに従う）

1. Swift の単体テストと統合テストでは Swift Testing を優先しますが、UI オートメーション（XCUIApplication）、パフォーマンスメトリクス（XCTMetric）、Objective-C のみのテストコードについては XCTest を保持します。
2. #expect をデフォルトのアサーションとして扱い、後続行が前提条件の値に依存する場合は #require を使用します。
3. デフォルトで並列実行セーフなガイダンスを提供します。テストが分離されていない場合は、.serialized を適用する前に、まず共有状態の修正を提案します。
4. 命名規則やアドホックなコメントではなく、動作とメタデータのためにトレイット（.enabled、.disabled、.timeLimit、.bug、タグ）を使用することを優先します。
5. 複数のテストがロジックを共有し、入力値のみが異なる場合は、パラメータ化されたテストを推奨します。
6. OS 条件付き動作には、テスト本体内でランタイムの #available チェックを使用する代わりに、テスト関数に @available を使用します。スイート型に @available を注釈付けしないでください。
7. マイグレーションアドバイスは段階的に保ちます。まずアサーションを変換し、次にスイートを整理し、その後でパラメータ化やトレイトを導入します。
8. Testing をインポートするのはテストターゲットのみで、アプリ/ライブラリ/バイナリターゲットには一切インポートしません。

最初の 60 秒（トリアージテンプレート）

• 目標を明確にします。新規テスト、マイグレーション、不安定なテスト、パフォーマンス、CI フィルタリング、またはasync待機です。
• 最小限の事実を収集します。
  • Xcode/Swift バージョンとプラットフォームターゲット
  • テストが現在 XCTest、Swift Testing、またはその両方を使用しているかどうか
  • テストの失敗が決定的か不確定的か
  • テストが共有リソース（データベース、ファイル、ネットワーク、グローバル状態）にアクセスするかどうか
• すばやく分岐します。
  • 繰り返しテスト → パラメータ化されたテスト
  • ノイズが多い、または不安定な失敗 → 既知の問題の処理とテスト分離
  • マイグレーション質問 → XCTest マッピングと共存戦略
  • async コールバックの複雑さ → 継続/await パターン

ルーティングマップ（参照をすばやく読む）

• テストの構成要素とスイート組織 → references/fundamentals.md
• #expect、#require、スロー期待値 → references/expectations.md
• トレイト、タグ、Xcode テストプランフィルタリング → references/traits-and-tags.md
• パラメータ化されたテスト設計と組み合わせ論 → references/parameterized-testing.md
• デフォルト並列実行、.serialized、分離戦略 → references/parallelization-and-isolation.md
• テスト速度、決定論的挙動、不安定性の防止 → references/performance-and-best-practices.md
• Async 待機とコールバックブリッジング → references/async-testing-and-waiting.md
• XCTest 共存とマイグレーションワークフロー → references/migration-from-xctest.md
• テストナビゲーター/レポートワークフローと診断 → references/xcode-workflows.md
• インデックスとクイックナビゲーション → references/_index.md

よくある落とし穴 → 次の最善のアクション

• 繰り返される testFooCaseA/testFooCaseB/... メソッド → 1 つのパラメータ化された @Test(arguments:) に置き換えます。
• 後続のアサーション内で隠された失敗する前提条件 → try #require(...) してから、アンラップされた値に対してアサートします。
• 共有データベース上の不安定な統合テスト → 依存関係をインメモリリポジトリに分離します。.serialized は遷移ステップとしてのみ使用します。
• サイレントに腐敗している無効化されたテスト → 信号を保持するために、一時的な既知の失敗に対して withKnownIssue を優先します。
• 複雑な型の曖昧な失敗値 → 型に CustomTestStringConvertible を適合させて、焦点を絞ったテスト診断を実現します。
• テストプラン名でのインクルード/除外 → タグとタグベースのフィルターを代わりに使用します。

検証チェックリスト

• 各テストが単一の明確な動作を持ち、必要に応じて表現的な表示名を持っていることを確認します。
• 前提条件が #require を使用しており、失敗時にテストを停止すべき場所で使用されていることを確認します。
• 繰り返されたロジックが重複しているのではなくパラメータ化されていることを確認します。
• テストが並列実行セーフであるか、意図的に根拠を示して .serialized されていることを確認します。
• 非同期コードが待機され、コールバック API が安全にブリッジングされていることを確認します。
• マイグレーションがサポートされていない XCTest のみシナリオを XCTest に保持していることを確認します。

References

• references/_index.md
• references/fundamentals.md
• references/expectations.md
• references/traits-and-tags.md
• references/parameterized-testing.md
• references/parallelization-and-isolation.md
• references/performance-and-best-practices.md
• references/async-testing-and-waiting.md
• references/migration-from-xctest.md
• references/xcode-workflows.md