Agent skill · software engineering · affaan-m
swift-protocol-di-testing
基于协议的依赖注入，用于可测试的Swift代码——使用聚焦协议和Swift Testing模拟文件系统、网络和外部API。
Why this skill is useful
Provides domain-specific patterns for dependency injection and testing in Swift that the AI wouldn't reliably 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. 定义小型、专注的协议 每个协议仅处理一个外部关注点。 2. 创建默认（生产）实现 3. 创建用于测试的模拟实现 4. 使用默认参数注入依赖项 生产代码使用默认值；测试注入模拟对象。 5. 使用 Swift Testing 编写测试 最佳实践 单一职责：每个协议应处理一个关注点——不要创建包含许多方法的“上帝协议” 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--58e4ba