用途:编写、审查或改进 SwiftUI 功能,关注正确的状态管理、现代 API、Swift 并发、视图组合、性能与 iOS 26+ Liquid Glass 样式。
主要能力:提供状态管理选择指南(新代码优先 @Observable 而非 ObservableObject,@State/@StateObject 需 private,@Binding 仅用于子视图修改父状态,@Bindable 用于注入的 @Observable);现代 API 替换清单(foregroundStyle() 替代 foregroundColor()、clipShape(.rect(cornerRadius:)) 替代 cornerRadius()、Tab API 替代 tabItem()、Button 替代 onTapGesture()、NavigationStack 替代 NavigationView、navigationDestination(for:) 类型安全导航、.sheet(item:) 模型驱动弹窗、ScrollViewReader 程序化滚动、避免 UIScreen.main.bounds 与滥用 GeometryReader);视图组合与性能建议(提取子视图、保持 body 简单纯粹、ForEach 使用稳定标识、避免行内过滤与 AnyView、LazyVStack/LazyHStack、减少冗余状态更新、Self.printChanges() 调试);动画规范(.animation(:value:)、withAnimation、转场需配合条件结构外的动画、phaseAnimator/keyframeAnimator、完成回调需 .transaction(value:));Liquid Glass 仅在用户明确要求时采用,使用 glassEffect、GlassEffectContainer、glass 按钮样式,并用 #available(iOS 26, *) 提供回退。
使用方式:按决策树选择审查现有代码、改进现有代码或实现新功能;参考 references 目录下的 state-management、modern-apis、view-structure、performance-patterns、list-patterns、animation-*、sheet-navigation-patterns、scroll-patterns、text-formatting、image-optimization、liquid-glass 等文档。
适用场景:SwiftUI 代码评审、重构、新功能实现与性能调优。
限制:不强制 MVVM、VIPER 等架构;Liquid Glass 需用户明确请求;具体安装命令与收费信息暂未提供。