SwiftUI 专家技能
为 AI 编程工具提供 SwiftUI 状态管理、性能优化和现代 API 的实用指导。
这个 Skill 能做什么，适合哪些场景？
这是一个遵循 Agent Skills 开放格式的 SwiftUI 指导技能，面向代码编写、审查和重构。内容覆盖状态管理、视图组合、列表、导航、动画、Swift Charts、macOS、可访问性、图像优化和 iOS 26+ Liquid Glass。参考文件按需加载，以减少任务上下文负担。技能还包含基于 Python 和 xctrace 的 Instruments 轨迹录制与分析工具。
提供 SKILL.md 工作流和按主题组织的 Markdown 参考文件；指导 AI 处理 SwiftUI 状态、视图结构、性能、列表、导航、动画、图表、macOS 和可访问性等问题；通过 scripts/record_trace.py 调用 xctrace 录制轨迹；通过 scripts/analyze_trace.py 分析 Time Profiler、Hangs、Animation Hitches、SwiftUI 更新和原因图，并输出 JSON 与 Markdown；提供 agents/openai.yaml 清单和多种安装配置示例。
- 团队采用现代 SwiftUI API，需要统一的代码审查默认实践。
- 开发者重构 SwiftUI 视图和数据流，需要检查状态管理与视图组合。
- 应用包含高性能列表、滚动、sheet 或导航，需要定位性能问题。
- 开发者已有 .trace 文件，需要分析卡顿、挂起或昂贵的 SwiftUI 更新。
- 应用需要采用 Swift Charts、可访问性支持或 iOS 26+ Liquid Glass。
这个 Skill 有哪些优点和局限？
- 覆盖 SwiftUI 开发、审查和性能诊断的多个常见领域。
- 参考文件按需加载，减少一次性上下文负担。
- 包含可录制和分析 Instruments 轨迹的 Python 工具链。
- 采用 MIT License，并支持多种 Agent Skills 工具。
- 提供的源材料未包含 SKILL.md 正文，因此无法独立核验其 frontmatter 和完整工作流。
- 轨迹录制与分析依赖 macOS 环境中的 xctrace 和 Xcode。
- 维护技能要求可用的 Sosumi MCP；该依赖不是所有环境都具备。
- 仓库描述未提供主题列表，实际覆盖范围主要依据 README。
如何安装这个 Skill？
使用 skills.sh：运行 npx skills add https://github.com/avdlee/swiftui-agent-skill --skill swiftui-expert-skill。使用 Codex/OpenAI 兼容工具时，将 swiftui-expert-skill/ 复制或链接到 $CODEX_HOME/skills/swiftui-expert-skill。也可按 README 提供的 Claude Code、Cursor、pi 或手动安装方式部署；具体保存位置应遵循目标工具的官方文档。
如何使用这个 Skill？
在支持 Agent Skills 的工具中请求使用 swiftui-expert，例如：Use the swiftui expert skill and review the current SwiftUI code for state-management and performance improvements。出现 .trace 路径时可请求分析轨迹；需要采样时可请求录制新的 Instruments 轨迹。