SwiftUI 专家 Agent Skill
为 AI 编程工具提供可执行的 SwiftUI 最佳实践指导
覆盖 SwiftUI 代码审查、现代 API、可访问性、性能与 Instruments trace 分析。
规则按主题拆分且 trace 脚本可审查，固定版本通过语法检查；缺少自动化质量测试。
核心审查只读且无主动联网；性能录制会调用 xctrace、启动或附加目标进程并生成 trace 文件。
实现与参考资料透明，但工作流主要用于发布和同步，没有公开效果基准。
入口简洁、渐进读取、脚本参数清楚，前提是 macOS 与 Xcode 环境可用。
近期有维护并跟进新 API，但主要维护者较集中，质量回归证据有限。
- SwiftUI API 会快速变化；按目标系统版本核对 Apple 官方文档并实际编译测试。
- 录制 trace 前确认设备、进程和输出目录；trace 可能包含敏感运行信息。
- 性能脚本仅适用于具备 Xcode Instruments 的 macOS 环境。
它能做什么 & 适用场景
SwiftUI Expert Skill 面向支持 Agent Skills 开放格式的 AI 编程工具，提供 SwiftUI 状态管理、视图组合、性能、导航、动画、可访问性和图像优化等方面的指导。内容覆盖 iOS 15+ 至 iOS 26+ 的 API 迁移，并包含 iOS 26+ Liquid Glass 采用建议。仓库还提供基于 Python 和 xctrace 的 Instruments trace 录制与分析工具。该 Skill 强调正确性和性能，不规定具体架构或代码风格。
它将 SwiftUI 最佳实践整理为 SKILL.md 工作流和按需加载的参考文件，帮助 AI 代理进行 SwiftUI 代码审查、重构和问题诊断。覆盖状态管理、视图结构、列表、滚动、表单与导航、Swift Charts、动画、macOS 场景、Liquid Glass、可访问性和图像优化等主题。附带的 trace 工具可录制并分析 Instruments 的 Time Profiler、Hangs、Animation Hitches、SwiftUI 更新和 cause-graph 数据。
- 审查 SwiftUI 代码中的状态管理和数据流选择。
- 重构视图层次结构，改善视图组合和身份稳定性。
- 诊断列表、滚动、动画或 SwiftUI 更新导致的性能问题。
- 迁移已弃用的 SwiftUI API，并参考 iOS 26+ Liquid Glass 使用模式。
- 检查 Swift Charts、导航、sheet、macOS 窗口和多窗口场景的实现。
- 录制或分析 .trace 文件，定位卡顿、挂起和昂贵的 SwiftUI 视图更新。
优缺点一览
- 主题覆盖面广，从状态管理和视图组合延伸到 Charts、macOS、可访问性和 Liquid Glass。
- 参考文件按需加载，README 声称可减少代理任务上下文膨胀。
- 包含面向 SwiftUI 性能诊断的 xctrace 录制、解析、跨轨道关联和 Markdown 摘要工具。
- 支持 skills.sh、Claude Code、Cursor、Codex、pi 及手动安装方式。
- MIT 许可，且仓库提供 API 指南维护工作流。
- SKILL.md 在提供的资料中未缓存，无法核实其完整 frontmatter、具体指令和实际工作流细节。
- trace 分析功能依赖 Python 3 和随 Xcode 提供的 xctrace，主要面向 Apple 开发环境。
- API 维护流程要求 Sosumi MCP；该要求针对维护技能，并非所有日常使用场景都需要。
- README 未提供可核实的具体版本兼容矩阵；“weekly installs 16.6k”来自徽章，不能替代功能或质量评估。
如何安装
使用 skills.sh：运行 npx skills add https://github.com/avdlee/swiftui-agent-skill --skill swiftui-expert-skill。Claude Code 可先运行 /plugin marketplace add AvdLee/SwiftUI-Agent-Skill，再运行 /plugin install swiftui-expert@swiftui-expert-skill。Codex 或兼容 OpenAI 的工具可将 swiftui-expert-skill/ 复制或链接到技能目录，例如 cp -R swiftui-expert-skill/ "$CODEX_HOME/skills/swiftui-expert-skill"。也可使用 pi install https://github.com/AvdLee/SwiftUI-Agent-Skill，或克隆仓库后按工具官方文档手动安装该目录。
如何使用
安装后，在 AI 代理中要求使用 swiftui expert 技能，例如：Use the swiftui expert skill and review the current SwiftUI code for state-management and performance improvements。代理应参考 swiftui-expert-skill/SKILL.md 中的工作流和检查清单，并按任务加载相关 reference 文件。分析 trace 时可提供 .trace 路径；录制或分析工具位于 scripts/record_trace.py 和 scripts/analyze_trace.py。
对比同类
与通用 SwiftUI 代码生成提示词相比，该仓库提供结构化的 Agent Skill、主题参考文件和性能 trace 工具。它明确采用非架构化、非代码风格导向，重点放在正确性和性能，而不是规定某一种项目架构。与仅提供文本建议的参考资料相比，它额外包含 xctrace 录制和分析工具；但这些工具需要 Xcode 环境。