SuperAPI AI 工具集

swiftui-expert-skill

编程与开发

查看项目

更新于 10-15 19:57

技能介绍

用途:该技能用于构建、审查或改进 SwiftUI 功能,强调正确状态管理、视图组合、性能意识、原生 API 与 Apple 设计规范,不强制特定架构模式。

主要能力:提供三条工作流决策树——审查现有代码、改进现有代码、实现新功能。审查时对照最新 API 清单排除废弃 API,检查属性包装器、视图抽取、性能模式、列表稳定标识、动画、无障碍、图表、macOS 专用 API 与 Liquid Glass 用法。改进时替换废弃 API、审计状态管理、抽取子视图、优化热路径、改进动画与无障碍。实现新功能时先设计数据流,再按目标部署版本选用 API。

核心准则:@State 必须为 private;@Binding 仅用于子视图修改父状态;@StateObject 用于视图创建对象,@ObservedObject 用于注入;iOS 17+ 用 @State 配合 @Observable,注入的可观察对象用 @Bindable。视图组合上优先用修饰符而非条件视图,复杂视图抽取为子视图,业务逻辑放在服务与模型中。性能上只传必要值、减少依赖、列表用稳定标识、避免 AnyView、大列表用 LazyVStack/LazyHStack。动画使用 .animation(_:value:)、withAnimation,优先变换而非布局变化。无障碍优先用 Button 而非 onTapGesture,用 @ScaledMetric 支持动态字体。Liquid Glass 仅在用户明确要求时采用,用 glassEffect、GlassEffectContainer 与玻璃按钮样式,并用 #available 做回退。

使用方式:按工作流查阅 references 目录下的参考文档,如 latest-apis.md、state-management.md、view-structure.md、performance-patterns.md、list-patterns.md、animation-basics.md、charts.md、macos-scenes.md、liquid-glass.md 等。

适用场景:SwiftUI 代码审查、重构、新功能实现,含 iOS 与 macOS 目标。

限制:资料未提供安装命令、收费信息或具体平台支持范围;Liquid Glass 需 iOS 26+ 且仅在明确要求时使用。