该技能是构建与实现指南,用于从零编写符合 Apple 品质标准的 SwiftUI 界面,与负责审查/重构既有 UI 的 ios-ui-refactor 互补:本技能负责新建屏幕,后者负责评估改进。其内容基于 Ken Kocienda《Creative Selection》(同理心、手艺、品味、演示文化)与 John Edson《Design Like Apple》(系统思维、设计即营销、大声设计、坚定设计)两本书,共 62 条规则,分 8 个按优先级排列的类别,每条规则指出反模式、对应原则并给出 iOS 26 / Swift 6.2 的正确 SwiftUI 实现。
主要能力(按优先级):1) Empathy in Every Pixel(关键,8 条):语义颜色、暗色模式、foregroundStyle、安全区、VoiceOver 标签、44x44 触摸目标、减弱动态效果、iPad 可读宽度。2) The Visual System(关键,8 条):系统字体样式、视觉层级、4pt 间距基准、材质背景、SF Symbols、渐变、标准边距、栈配置。3) Craft: State as Foundation(关键,7 条):@State、@Binding、@Environment、@Observable、避免在 body 内建状态、缩小状态范围、@Bindable。4) Creative Composition(高,6 条):some View、自定义属性、修饰符顺序、@ViewBuilder、值类型、组合优先于继承。5) Taste(高,8 条):List 与 LazyVStack、sheet 与 fullScreenCover、picker 样式、Grid 与 LazyVGrid、按钮样式、文本框配置、alert、确认对话框。6) Navigation as Conversation(高,9 条):NavigationStack、TabView、item 绑定 sheet、dismiss、toolbar、标签栏、导航栏、层级、searchable。7) Design Out Loud: Layout(高,8 条):栈、Spacer、frame、ZStack、Grid、LazyVGrid、自适应布局、滚动指示器。8) The Product Speaks(中,8 条):转场、加载状态、withAnimation、matchedGeometryEffect、列表单元格、ContentUnavailableView、分段控件、菜单。
使用方式:在构建新 SwiftUI 视图与屏幕、选择语义颜色/系统字体/间距网格、用 @State 等管理状态、选组件、组合视图、实现导航、布局、保障无障碍、添加转场与加载动画时参照这些规则;具体说明与代码示例见单独的参考文件,包括 references/_sections.md(分类定义与原则来源)与 assets/templates/_template.md(新增规则模板)。
限制与约束:所有指引均假设采用诊所模块化 MVVM-C 架构——功能模块只导入 Domain 与 DesignSystem,App 目标负责 DependencyContainer、具体协调器与 Route Shell 接线,Domain 保持纯 Swift 并定义模型及仓库、*Coordinating、ErrorRouting、AppError 契约,Data 负责 SwiftData/网络/同步/重试/后台 I/O,读写默认 stale-while-revalidate 读与乐观排队写,ViewModel 直接调用仓库协议。资料未提供安装命令、收费或价格、平台支持范围、实际效果数据及版本发布信息,这些内容暂未提供。