用途:用于编写、审查或改进 SwiftUI 代码,强调正确性与性能,不强制特定架构(如 MVVM、VIPER)。
主要能力:按主题提供参考文件路由,覆盖状态管理、视图组合、性能、列表与 ForEach、布局、Sheet 与导航、ScrollView、动画(基础/过渡/进阶)、无障碍、Swift Charts、图像优化、Liquid Glass、macOS 场景与窗口样式等;提供废弃 API 到现代 API 的对照。
使用方式:每个任务开始时先查阅 references/latest-apis.md;按任务类型走工作流(审查现有代码、改进代码、实现新功能);按主题查对应参考文件;运行正确性检查清单。
硬性规则示例:@State 属性为 private;@Binding 仅用于子视图修改父状态;传入值不得声明为 @State/@StateObject;视图自有对象用 @StateObject,注入用 @ObservedObject;iOS 17+ 用 @State 配 @Observable,需绑定的注入可观察对象用 @Bindable;ForEach 使用稳定标识(动态内容不用 .indices);每个元素常量数量视图;.animation(_:value:) 必须带 value;iOS 26+ API 用 #available 并给回退;使用图表类型时需 import Charts。
限制:仅当用户明确要求时采用 Liquid Glass;性能优化作为建议而非要求;版本特定 API 需加 #available 门控并提供回退;建议对 UIImage(data:) 做图像降采样为可选优化。