用途:编写、审查或改进 SwiftUI 代码,覆盖状态管理、视图组合、性能、macOS 专用 API 及 iOS 26+ Liquid Glass 等主题。
主要能力:提供按主题划分的参考文件路由,包括状态管理、视图结构、性能模式、列表与 ForEach、布局、Sheet 与导航、ScrollView、动画(基础/过渡/高级)、可访问性、Swift Charts 及其可访问性、图片优化、Liquid Glass、macOS 场景/窗口样式/视图,以及弃用 API 查询。
使用方式:每个任务开始时先查阅 references/latest-apis.md 以避免弃用 API;按任务相关主题查阅对应参考文件;审查代码时标记弃用 API、验证 #available 门控与回退路径;改进代码时替换弃用 API、重构热路径、抽取复杂视图体;实现新功能时先设计数据流、优化 diff、应用动画模式、使用 Button 并添加可访问性标签。
硬性规则:@State 属性为 private;@Binding 仅用于子视图修改父状态;传入值不得声明为 @State 或 @StateObject;视图自有对象用 @StateObject,注入用 @ObservedObject;iOS 17+ 用 @State 配合 @Observable,注入的可观察对象需要绑定时用 @Bindable;ForEach 使用稳定标识,动态内容不用 .indices;每个 ForEach 元素视图数量恒定;.animation(_:value:) 必须包含 value 参数;iOS 26+ API 用 #available 门控并提供回退;使用图表类型的文件需 import Charts。
限制:不强制特定架构(MVVM、VIPER 等);仅在用户明确要求时采用 Liquid Glass;性能优化以建议而非要求形式呈现;鼓励但不强制将业务逻辑与视图分离。具体安装命令与平台支持信息暂未提供。