swift-ui-best-practices

用途：该技能用于在编写、审查或重构 SwiftUI 代码时，参考 Apple 设计模式以构建原生质感的 iOS 界面，包含 9 大类共 51 条规则，按影响优先级排序，供自动化重构与代码生成参考。使用场景包括：构建新的 SwiftUI 视图与屏幕、实现导航流程与模态呈现、添加动画/触感反馈/过渡、确保无障碍合规（VoiceOver、Dynamic Type）、为 120fps 滚动优化性能。规则分类及优先级为：数据流与状态管理（CRITICAL，state- 前缀）、视觉设计系统（CRITICAL，design-）、组件选择（HIGH，comp-）、导航模式（HIGH，nav-）、视图组合（HIGH，view-）、动画与触感（MEDIUM-HIGH，anim-）、无障碍（MEDIUM-HIGH，acc-）、列表与滚动性能（MEDIUM，perf-）、平台集成（MEDIUM，platform-）。示例规则包括使用 @Observable 管理模型类、使用 @State 管理视图局部值类型、使用 @Binding 支持子视图修改、避免在视图 body 内创建状态、使用系统排版样式与语义颜色、支持深色模式、使用 NavigationStack、避免 AnyView、使用弹簧动画、添加无障碍标签与支持 Dynamic Type、使用惰性容器与 AsyncImage、使用 SF Symbols 与 AppStorage 等。用法：查阅各参考文件获取详细说明与代码示例，完整编译文档见 AGENTS.md，另有 references/_sections.md（分类定义与排序）、assets/templates/_template.md（新规则模板）、metadata.json（版本与参考信息）。限制：资料未提供具体规则代码内容、适用 Swift/iOS 版本、依赖条件及使用前置要求。