swift-style

swift-style 技能提供了一套完整的架構，用於編寫高品質、專業的 Swift 程式碼。它強調清晰、簡潔與一致性的核心原則，確保程式碼庫在長生命週期中具有良好的可讀性與可維護性。此技能對於致力於現代化 iOS 與 macOS 開發的開發者至關重要，特別是希望遵循工業級格式、命名慣例與 Swift 慣用模式的人員。它涵蓋了結構組織、存取控制、記憶體管理與現代語法糖，確保程式碼符合 Swift 6.2 標準與嚴格的併發要求。

• 標準化型別、協定與變數的命名慣例，使用 UpperCamelCase 與 lowerCamelCase 以確保團隊間的一致性。

• 透過提倡提早返回與 guard 語句來執行「黃金路徑」(Golden Path) 架構，減少程式碼嵌套並提升可讀性。

• 提供程式碼組織指南，包括使用 extensions、MARK 註解以及明確的存取控制關鍵字（如 private 與 public）。

• 推廣記憶體管理最佳實踐，例如在閉包中正確使用 weak self，以及在編譯器未強制要求時省略 self。

• 提供關於現代 Swift 特性的建議，包括集合型別推論、計算屬性，以及使用列舉來進行常數命名空間管理。

• 透過強調諸如過於泛型的型別名稱或不一致的 self 使用等常見錯誤，促進更有效的程式碼審查。

• 在編寫或重構程式碼過程中運用此技能，以驗證您的實作是否符合專業的 Swift 風格指南。

• 非常適合用於建立專案風格規範，或確保新加入的貢獻者能維持既有的架構完整性。

• 輸入通常涉及特定的程式碼區塊或模組；輸出則提供關於格式、命名與結構改善的建議。

• 限制條件包括保持左側邊距清空以呈現快樂路徑，並在確保程式碼編譯無警告的前提下，將清晰度置於簡潔度之上。