用途:这是一个面向 Swift 代码质量的技能,适用于编写、审查或搭建 macOS/iOS 应用的代码规范工具链。资料显示其模式来自对 CotEditor、realm/SwiftLint、AeroSpace、Gifski、stats、swift-composable-architecture 等 75+ 个高星开源 Swift 项目的分析。
主要能力:按任务路由到不同参考文件。shared-swift.md 始终先读,涵盖命名、并发、错误处理、泛型、内存管理、Codable、@Observable。airbnb-style-rules.md 提供完整 Airbnb 风格规则、正反例、文件组织、SwiftUI 模式、测试规则,以及可直接复制的 SwiftLint/SwiftFormat 配置。此外还按平台提供 macOS(AppKit、菜单栏应用、IOKit/SMC、Sparkle、沙盒、分发)与 iOS(SwiftUI 导航、SwiftData、StoreKit 2、WidgetKit、推送、后台任务、无障碍)模式参考,以及架构(TCA、MVVM+@Observable、swift-dependencies、模块结构)、工具链搭建(SwiftLint/SwiftFormat 配置、periphery 死代码检测、GitHub Actions CI)、测试(XCTest、Swift Testing、快照测试、mockolo/@Spyable、TCA TestStore)。
使用方式:先确定平台(macOS、iOS 或两者),再按任务只读取所需参考文件,应用其中的模式。资料给出若干快速决策:项目搭建优先 SwiftLint+SwiftFormat、SwiftPM 而非 CocoaPods、CI 用 periphery;小应用用 MVVM+@Observable,中型加 Coordinator 与依赖注入,大型用 TCA。
通用原则与限制:优先值类型、用 Swift 并发替代 GCD/Combine、让非法状态不可表示、面向协议、最小化可选值、默认 private、类默认 final、生产环境不用 print()。反模式包括巨型视图控制器、强制解包、字符串硬编码、忽略错误、上帝对象、过早抽象。资料未提供版本、收费、安装命令或效果数据,暂未提供。