AvdLee/SwiftUI-Agent-Skill

解决的问题

本项目为 AI 编程助手提供专门的知识库和工具集，帮助开发者构建高性能、现代化的 SwiftUI 应用程序。通过提供关于状态管理、视图组合和最新 iOS API（包括 iOS 26+ Liquid Glass）的简洁且具操作性的参考资料，防止 AI 智能体提供过时或低效的 SwiftUI 代码。

工作原理

本项目采用与 Claude Code、Cursor 和 ChatGPT 等工具兼容的开放格式，封装为“Agent Skill”。它由一系列 Markdown 参考文件组成，AI 智能体可以按需加载，以避免占用过多的上下文窗口。此外，它还包含一个基于 Python 的工具链，通过封装 xctrace，允许 AI 智能体记录并分析 Instruments 追踪，帮助它们直接从追踪数据中诊断挂起（hangs）和卡顿（hitches）等性能问题。

适用对象

• 希望确保其 AI 编程工具遵循现代最佳实践的 SwiftUI 开发者和团队。
• 需要通过 AI 智能体使用 Instruments 对应用性能进行分析和剖析的 iOS/macOS 开发者。
• 正在将旧版 SwiftUI 代码重构为现代 API 的开发者。

亮点

• 按需参考库：涵盖从 @Observable 和 NavigationStack 到 Swift Charts 和辅助功能的所有内容。
• 自动化性能分析：包含用于记录和解析 xctrace 文件的脚本，允许智能体识别挂起是 CPU 密集型还是由 I/O 阻塞引起的。
• 广泛的工具兼容性：支持包括 Claude Code、Cursor、Codex 和 ChatGPT 在内的多种 AI 客户端。
• 现代 API 覆盖：包括针对 iOS 26+ Liquid Glass 的特定指南以及从 iOS 15+ 迁移的指南。