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+ 遷移的指南。