用途:这是一套 SwiftUI 界面开发最佳实践指南,内容提取自 Apple 官方 Develop in Swift 教程和 SwiftUI Concepts,用于在构建、审查或重构 SwiftUI 视图与界面时作为参考。共含 10 个类别、49 条规则,按影响程度划分优先级。
主要能力与规则分类:视图组合(CRITICAL,前缀 comp-,如从 body 返回 some View、抽取子视图、正确排列修饰符顺序、用 #Preview 预览);布局与尺寸(CRITICAL,layout-,如 frame() 尺寸约束、Grid 表格、LazyVGrid 可滚动网格、Spacer、栈对齐间距、ZStack 分层);样式与主题(HIGH,style-,如语义字体、foregroundStyle、渐变、SF Symbols、系统颜色适配深色模式);状态与数据流(HIGH,state-,如 @Bindable、@Binding、@Environment、@Observable、@State 标记为 private 及用于视图本地值类型);导航与呈现(HIGH,nav-,如 NavigationStack、path 绑定、sheets、TabView、toolbar);列表与动态内容(MEDIUM-HIGH,list-,如 ForEach、Identifiable 数据、searchable、swipe actions);用户输入与交互(MEDIUM-HIGH,input-,如 Button 动作闭包、Picker、TextField 绑定、Toggle 与 Form);无障碍与自适应(MEDIUM,access-,如无障碍标签、Dynamic Type、@ScaledMetric、ViewThatFits);测试与调试(MEDIUM,test-,如断点、带样例数据的预览、Swift Testing);应用打磨(LOW,polish-,如包容性功能、过渡效果、withAnimation)。
使用方式:在构建新 SwiftUI 视图与屏幕、用栈/网格/自定义布局组合视图、用 @State/@Binding/@Observable/@Environment 管理状态、用 NavigationStack/TabView/sheets 实现导航、添加无障碍与 Dynamic Type 特性时参考这些规则;可阅读各参考文件获取详细说明与代码示例,包括分类结构说明、新规则模板,完整合订指南见 AGENTS.md,另含 references/_sections.md、assets/templates/_template.md、metadata.json。
限制:资料未说明该技能的安装、收费、平台支持或具体运行步骤,暂未提供;具体规则细节需查阅对应参考文件。