SuperAPI AI 工具集

swiftui-expert-skill

编程与开发

查看项目

更新于 10-15 17:22

技能介绍

用途:在编写、审查或重构 iOS/macOS 的 SwiftUI 代码时提供专家级指导,覆盖状态管理、视图组合、布局、性能、动画、无障碍与 Instruments 性能追踪等主题。

主要能力:以视图为失效边界组织数据流;按主题路由查阅参考文档(状态管理、环境与 @Entry、视图结构、修饰符与身份、性能、列表与 ForEach、可调整布局、折叠屏、Sheet 与导航、滚动、焦点、动画基础/转场/进阶、无障碍、Swift Charts、图片优化、工具栏、文档应用、WebKit、样式化文本编辑、Liquid Glass、macOS 场景与窗口、文本、本地化、废弃 API 查询、软废弃处理、预览、Instruments 追踪录制与分析)。可查询最新 API、替换硬废弃 API、标记软废弃 API、用 #available 做版本门控并提供回退、审查正确性清单,以及录制与分析 Instruments .trace 文件。

使用方式:审查代码时先阅读代码并确定适用主题,再按主题路由查阅参考文档;实现新功能时先设计数据流(区分自有与注入状态),再构建视图并应用动画与无障碍处理。录制追踪使用脚本命令,例如 python3 "${SKILL_DIR}/scripts/record_trace.py" --list-devices,以及带 --device、--attach、--stop-file、--output 的录制命令;分析追踪使用 python3 "${SKILL_DIR}/scripts/analyze_trace.py" --trace <path> --json-only --top 10,可用 --window、--list-logs、--list-signposts、--fanin-for 等参数。

限制:不强制特定架构(MVVM、VIPER 等);性能优化仅作建议;仅在用户明确要求时采用 Liquid Glass;模拟器上 SwiftUI 模板的 SwiftUI 泳道为空,需改用 Time Profiler 模板;版本相关 API 需做 #available 门控。