用途:作为 SwiftUI 日常开发参考的核心编码规范技能,覆盖 iOS、iPadOS、macOS、watchOS、tvOS、visionOS 的 SwiftUI 与 Swift 应用开发。适合在实现 View、处理状态、导航、表单与列表等场景时查阅。
主要能力:技能目录包含 SKILL.md 及 references/ 下的 best-practices.md(最佳实践)、patterns-list.md(1-x 列表与数据展示)、patterns-navigation.md(2-x 导航与页面跳转)、patterns-forms.md(3-x 表单与输入)、patterns-views.md(4-x View 构建与布局)、anti-patterns.md(反模式)。
涵盖主题:状态管理中的属性包装器(如 @State、@Binding、@StateObject 等);性能优化(View 结构、Lazy 栈与 Grid、Equatable);组件设计(职责分离、Root Views 与 Content Views、ViewModifier);异步处理(.task 修饰符、async/await、@MainActor);导航(NavigationStack,iOS 16+、类型安全路由);Layout 协议(作为 GeometryReader 替代,iOS 16+);Preview 驱动开发(多状态预览)。
模式清单:1-1 无限滚动 Pagination、1-2 下拉刷新、1-3 过滤与排序、1-4 滑动操作、1-5 上下文菜单;2-1 标签视图、2-2 NavigationStack 导航、2-3 模态展示(Sheet / FullScreenCover)、2-4 警告与对话框;3-1 带防抖的搜索、3-2 带校验的表单输入、3-3 认证界面(登录/注册/OTP);4-1 带缓存的 AsyncImage、4-2 空状态与错误状态、4-3 动画、4-4 View 叠加(ZStack / overlay / background)、4-5 ContentUnavailableView(iOS 17+)。
使用方式:新实现时先查阅对应 patterns-*.md 确认实现模式,再用 best-practices.md 核对相关最佳实践,并用 anti-patterns.md 检查应避免的写法;排查问题时先在 anti-patterns.md 检索对应模式,再在 best-practices.md 确认推荐实现。
重要原则:状态最小化,不保留可推导状态;职责分离,Root Views 负责逻辑、Content Views 负责 UI;性能上合理使用 Lazy、Equatable 与异步处理;View 身份使用稳定 ID,禁止在 ForEach 中用索引;间距由父级管理,子组件不用 padding 制造空间。
关联技能:swiftui-ssot(状态管理 SSOT 详细设计)、swiftui-code-review-checklist(PR 评审清单)、swift-ios-migration(iOS 17/18、Swift 6 迁移)、swiftui-accessibility(无障碍支持)。
限制:相关安装命令、版本号、价格与平台支持细节暂未提供。