swiftui-expert-skill

SwiftUI 專家技能作為您 AI 代理中的資深工程師，專注於現代化 Apple 框架開發。它旨在為需要構建、審查或優化高效能 SwiftUI 應用程式的開發人員、團隊及技術人員提供協助。透過直接整合儲存庫的內部參考文檔與 CLI 工具，它能針對狀態管理、視圖生命週期及佈局效能提供精確指導。此技能擅長將過時的 API 遷移至現代標準，在用戶請求時實作 iOS 26+ Liquid Glass 特效，並嚴格執行 Apple 的人機介面規範 (HIG)。

• 執行全面的代碼審查，針對狀態管理反模式、低效的視圖組合及不當的數據流進行檢查。

• 分析 Xcode Instruments .trace 文件，識別卡頓、CPU 熱點及動畫停滯，並深入了解 SwiftUI 依賴圖的根本原因。

• 使用內建腳本自動化記錄效能分析會話，透過連接運行中的應用程式或捕捉從模擬器及實體設備上的新啟動過程。

• 根據 swiftui-causes 數據分析，為優化熱路徑 (hot-path) 視圖更新及減少結構性失效 Bug 提供可操作的建議。

• 建議現代併發模式，確保執行緒安全的狀態處理，並為特定版本功能提供適當的 #available 防護。

• 務必參考 references/latest-apis.md 以確保代碼面向未來，並在非必要時避免使用已棄用的 API 或 UIKit/AppKit 橋接層。

• 在進行效能診斷時，請遵循結構化工作流：將分析範圍限定於特定時間窗口，識別昂貴的視圖，並使用扇入 (fan-in) 分析將失效問題追蹤至其源頭。

• 使用 record_trace.py 腳本來標準化效能分析輸出，根據目標設備類型選擇正確的模板 (SwiftUI 或 Time Profiler)，以確保度量數據的準確捕捉。

• 優先使用原生 SwiftUI API 以利用框架級優化，而非依賴 MVVM 或 VIPER 等未被強制要求的特定架構模式。

• 透過將複雜視圖主體重構為更小的子視圖來保持可擴展性，這不僅能提高代碼可讀性，還能提升 SwiftUI 差分引擎的執行效率。