用途:在编写或审查 iOS、macOS 项目的 Swift 代码时应用现代 Swift 最佳实践,重点为 Swift 6+ 特性、并发安全、API 设计原则与代码质量,目标平台为 macOS 15.7+。
主要能力:提供 Swift 6 并发模型指导(async/await、actor、@MainActor、Sendable 与隔离、区域隔离 SE-0414);API 设计规范(命名、参数标签、副作用命名、文档要求);Swift 6 破坏性变更说明(SE-0401 需显式标注 @MainActor、SE-0412 全局变量并发安全、@main 替代旧入口、any 存在类型等);可用性标注模式(@available、#available、#unavailable、deprecated/obsoleted/unavailable 区别);常见陷阱(勿滥用 async、勿用 DispatchSemaphore 配 async/await、避免无状态 actor、检查任务取消等)。
使用方式:编写代码时按角色命名、选择合适隔离、正确实现 async/await 与取消处理、遵循 Swift 6 并发模型并记录公共 API;审查代码时检查并发安全、隔离与 Sendable、取消处理、命名与可用性标注。需要深入信息时可加载 references/ 下的 api-design.md、concurrency.md、swift6-features.md、availability-patterns.md。
适用场景:新写 Swift 代码、代码审查、实现并发特性、设计公共 API、从 Swift 5 迁移到 6、处理并发警告与数据竞争、使用 Swift 6/6.2 新特性。
限制:需 Swift 6.0+ 编译器,InlineArray 与增强并发需 Swift 6.2+,需 macOS 15.7+ SDK,最新平台特性需 iOS 18+;运行时用 #available 检测,API 标注用 @available。资料未提供安装命令、收费与价格信息。