SuperAPI AI 工具集

swiftui-ui-patterns

智能体与模型

查看项目

更新于 10-15 17:29

技能介绍

用途:为 AI 代理提供 SwiftUI 界面开发的可复用模式,用于在既有项目或新项目中按约定搭建视图、导航、表单与状态管理。

主要能力:

  • 快速上手:既有项目可先用 rg "TabView(" 等搜索近似示例,套用本地约定;新项目从 TabView + NavigationStack + sheets 起步,按骨架添加 AppTab 与 RouterPath。
  • 一般规则:使用 @State、@Binding、@Observable、@Environment 等现代状态,避免不必要的 view model;偏好组合、拆小视图;用 async/await 与 .task 并显式表达加载/错误状态;仅在编辑旧文件时保留旧模式;遵循项目格式化与风格。
  • 新视图工作流:定义状态及归属、确定 @Environment 依赖、勾画视图层级并抽取子视图、实现异步加载、交互元素添加无障碍标签或标识、构建验证并更新调用点。
  • 架构模式:Tab 导航(AppTab 枚举与 TabView 选择)、Router 模式(Route 枚举、@Observable Router、NavigationPath、navigationDestination、environment 注入)、Sheet 管理(Identifiable Sheet 枚举、.sheet(item:))。
  • 组件模式:列表加载状态(LoadingState 枚举、ProgressView、错误重试)、搜索防抖(.searchable、onChange 取消 Task、300 毫秒延迟)、下拉刷新(.refreshable)、滑动操作(swipeActions)、上下文菜单(contextMenu)。
  • 表单模式:校验表单(邮箱、密码、确认密码校验与禁用提交)、设置表单(@AppStorage 的 Toggle、Slider、重置默认值)。
  • 无障碍:accessibilityLabel、accessibilityHint、accessibilityElement(children: .combine)。

使用方式:作为可安装技能加载后,按目标选择既有项目轨道或新项目脚手架轨道,参考文中规则与代码骨架落地。必要命令保持原样,如 rg "TabView("。

适用场景:SwiftUI 视图搭建、导航与路由、弹窗管理、异步数据展示、表单与设置页、无障碍改造。

限制与注意事项:资料未提供授权、收费、价格、支持平台版本或效果数据;应始终在多设备尺寸测试,图标尽量用 SF Symbols,优先系统颜色以自动适配深色模式,动画保持克制并尊重减弱动态效果设置。