SuperAPI AI 工具集

swift-standards

编程与开发

查看项目

更新于 10-15 23:33

技能介绍

用途:为所有 Swift 工作提供权威编码规范,适用于编写与审查 Swift/SwiftUI 代码。

主要能力:给出不可协商的规则,包括使用现代 Swift(@Observable 配合视图中的 @State,除桥接旧代码外不用 ObservableObject/@Published/@StateObject);用 actors 与 await MainActor.run {} 替代 DispatchQueue;用 async/await 替代完成回调与 Combine;视图接收数据与动作回调而非 ViewModel 大对象;在合适处使用 typed throws。并发方面要求 UI 写入仅在 MainActor,有状态服务用 actor,循环/流中检查 Task.isCancelled,SwiftData 跨 actor 传 Model.ID 并在本地 ModelContext 重新获取。响应式优先于命令式:用计算属性派生而非存储副本,无手动 notify/refresh,无状态逻辑用自由/静态函数,仅在性能分析后缓存。SwiftUI 性能规则涉及状态尽量下沉、拆分 @Observable 模型、稳定 ForEach ID、body 中不做 filter/sort 或阻塞工作、按需使用 AnyView、每个滚动层级一个惰性容器、用 Equatable 门控昂贵子树、对高频输入去抖。Apple 智能体约定含命名、@State private var、禁止强制解包、Swift Testing 与 XCUIAutomation、4 空格缩进、限制改动范围、按最省成本优先验证,以及不猜测截止日期后的 API。

使用方式:先阅读相关参考文档再动手或审查。参考文档包括 references/old-swift-patterns.md(旧模式替换表)、references/concurrency.md(严格并发规则)、references/imperative-patterns.md(响应式优先规则)、references/swiftui-performance.md(失效/标识/布局规则)、references/preview-pitfalls.md(预览)、references/apple-agent-conventions.md(约定与验证阶梯)。SDK 27 中 @State 变为宏,若视图出现相关编译错误,应先查阅 swiftui-whats-new-27 技能,而非直接重排 init 赋值。

限制:资料未提供安装命令、收费、价格、平台与效果信息。