Agent skill · software engineering · affaan-m
swift-protocol-di-testing
テスト可能なSwiftコードのためのプロトコルベースの依存性注入——焦点を絞ったプロトコルとSwift Testingを使用してファイルシステム、ネットワーク、外部APIをモックする。
Why this skill is useful
Provides specific patterns and mock implementations for dependency injection in Swift that enhance testability, which the AI may not generate on its own.
What it needs
About 2k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
プロトコルベースのSwift依存性注入テスト 外部の依存関係（ファイルシステム、ネットワーク、iCloud）を小さく焦点を絞ったプロトコルとして抽象化することで、SwiftコードをテストしやすくするパターンI/Oなしの決定論的テストをサポートする。 起動条件 ファイルシステム、ネットワーク、または外部APIにアクセスするSwiftコードを書く場合 実際の障害を起こさずにエラー処理パスをテストする必要がある場合 異なる環境（アプリ、テスト、SwiftUIプレビュー）で動作するモジュールを構築する場合 Swift並行処理（Actor、Sendable）をサポートするテスト可能なアーキテクチャを設計する場合 コアパターン 1. 小さく焦点を絞ったプロトコルを定義する 各プロトコルは1つの外部関心事のみを処理する。 2. デフォルト（本番用）実装を作成する 3. テスト用のモック実装を作成する 4. デフォルトパラメーターで依存関係を注入する 本番コードはデフォルト値を使用し、テストはモックを注入する。 5. Swift Testingを使用してテストを書く ベストプラクティス 単一責任：各プロトコルは1つの関心事を処理する——多くのメソッドを持つ「ゴッドプロトコル」を作らない Sendable 一貫性：プロトコルがActor境界をまたいで使用される場合に必要 デフォルトパラメーター：本番コードは実際の実装をデフォルトで使用する。テストだけがモックを指定する必要がある エラーのモック：障害パスをテストするために設定可能なエラープロパティを持つモックを設計する 境界のみをモック：外部の依存関係（ファイルシステム、ネットワーク、API）をモックし、内部型はモックしない 避けるべきアンチパターン すべての外部アクセスをカバーする単一の大きなプロトコルを作成する 外部の依存関係を持たない内部型をモックする 適切な依存性注入の代わりに #if DEBUG 条件文を使用する Actorと組み合わせて使用する際に Sendable 一貫性を忘れる 過度な設計：型が外部の依存関係を持たない場合、プロトコルは必要ない 使用場面 ファイルシステム、ネットワーク、または外部APIに触れるあらゆるSwiftコード 実際の環境では引き起こすことが難しいエラー処理パスをテストする場合 アプリ、テスト、SwiftUIプレビューのコンテキストで動作するモジュールを構築する場合 Swift並行処理（Actor、構造化並行処理）を採用したテスト可能なアーキテクチャが必要なアプリ
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/swift-protocol-di-testing--aa942c