swiftui-patterns
作者 affaan-mswiftui-patterns 是一份適用於 Apple 平台前端開發的實用指南。它涵蓋 SwiftUI 狀態管理、NavigationStack 流程、view 組合與效能建議，協助你在真實的 app 程式碼中選對模式。當你要重構或建立需要清楚權責分工、並盡量減少重繪的畫面時，適合使用 swiftui-patterns 技能。
這個技能的評分為 84/100，代表它很適合想要取得 SwiftUI 專門指引、而不是一般性提示的目錄使用者。這個 repository 顯示出一個真實、非模板式、以工作流程為導向的技能，具備清楚的啟用線索、詳盡的模式說明，以及足夠具體的 SwiftUI 內容，值得安裝。
- SwiftUI 工作的啟用範圍很清楚：views、state management、NavigationStack、view models、效能與 dependency injection。
- 教學內容相當充實，包含標題、表格與程式碼範例，能讓 agent 在套用技能時少很多猜測。
- 沒有模板占位或實驗性標記；技能內容篇幅充足，且聚焦於現代 Apple 平台的 SwiftUI 模式。
- 沒有安裝指令或支援參考檔，因此使用者必須主要依賴 SKILL.md 內容來判斷是否採用。
- 內容看起來偏重模式與最佳實務，對於高度特定的 app 領域或除錯工作流程，幫助可能相對有限。
swiftui-patterns skill 概覽
swiftui-patterns 是用來做什麼的
swiftui-patterns skill 幫助你用正確的 state、navigation 與 composition pattern 來打造 SwiftUI 畫面，而不是依賴泛泛的 prompt 建議。它最適合 Apple 平台上的 Frontend Development 工作，當你想在實際 app code 中，針對 @State、@Binding、@Observable、@Bindable 和 @Environment 做出實用的選擇時特別有幫助。
適合哪些人使用
如果你符合以下情況，就適合使用 swiftui-patterns skill：
- 正在建立新的 SwiftUI 功能，需要做出乾淨的架構選擇
- 正在重構一個 state 太多、或難以維護的 view
- 要加入
NavigationStack流程、列表密集型畫面，或共享依賴 - 想減少不必要的 re-render，並改善 view 效能
安裝決策上的主要價值
這個 repo 的價值在於，當你的工作不是「隨便寫出任何 SwiftUI code」，而是「讓一個 SwiftUI 畫面正確運作，並且維持容易變更」時，它就特別有用。它最強的訊號，是針對現代 SwiftUI state management 與 @Observable 的指引；這比泛用 UI prompt 更可執行，因為它會把你導向正確的 ownership model 與 render boundary。
如何使用 swiftui-patterns skill
swiftui-patterns 的安裝方式
先把 swiftui-patterns skill 安裝到你的 Claude Code skills 目錄，之後再把它用在需要架構決策的 SwiftUI 任務上。典型的安裝路徑是：
npx skills add affaan-m/everything-claude-code --skill swiftui-patterns
安裝完成後，先確認 skill 可以正常使用，再把它拿去 feature branch 或 refactor 工作上。
需要提供什麼輸入
這個 skill 在你提供具體的 SwiftUI 情境時效果最好，不要只丟一個很模糊的需求。建議包含：
- 平台目標：iOS、macOS，或兩者皆有
- 畫面類型：list、detail、form、onboarding、settings 等
- state 所屬方式：local、parent-owned、shared，或 environment-based
- navigation 形式：push、stack、sheet、split view，或 deep link
- 效能考量：大型列表、頻繁更新、昂貴 layout 等
較弱的提示是：「幫我改善這個 SwiftUI view。」
較強的提示是：「請把這個 iOS 17 的 SwiftUI list 畫面重構成使用 @Observable 管理 model state、用 NavigationStack 處理 drill-down，並在單一 item 變動時盡量降低 re-render。」
先看哪裡
要把 swiftui-patterns 用得最好，先從 SKILL.md 讀起，並聚焦在會對應你問題的章節：When to Activate、State Management、Property Wrapper Selection、以及 @Observable ViewModel。這些段落會告訴你這個 skill 何時適用，以及它預期 state 如何在 app 中流動。
實際工作流程
- 用 state 所屬與 navigation 的角度描述功能或 bug。
- 先請 model 決定 wrapper 或 pattern，再開始寫完整 code。
- 檢查結果是否使用了符合需求、且最簡單的 state model。
- 如果輸出看起來過度設計，就請它簡化 ownership 或移除不必要的 wrappers。
- 用真實更新來測試 view，不要只看靜態 rendering。
swiftui-patterns skill 常見問題
swiftui-patterns 只適合新專案嗎？
不是。swiftui-patterns skill 對既有 codebase 也很有幫助，尤其是在你想替換較舊的 ObservableObject pattern、降低 view 耦合，或在不重寫整個專案的前提下整理 navigation 與列表效能時。
它跟一般 prompt 有什麼不同？
一般 prompt 可能會產生 SwiftUI code，但 swiftui-patterns 會先提供你選 pattern 的決策框架。當主要風險不是語法，而是錯誤的 state ownership、不必要的 redraw，或脆弱的 navigation 時，這點就很重要。
對初學者友善嗎？
可以，前提是你把它當成引導式的決策工具。這個 skill 最有幫助的情況，是你手上有一個明確的畫面，想知道哪種 wrapper 或 composition approach 最適合，而不是單純背 SwiftUI 理論。
什麼情況下不該用它？
如果你的任務主要是 UIKit、server-side Swift，或非 Apple 前端，就不要依賴 swiftui-patterns。它也不適合純視覺設計工作，尤其是不牽涉 state、flow 或 rendering behavior 的情境。
如何提升 swiftui-patterns skill
把 ownership 故事講清楚
最好的結果來自於你清楚說明每一段 state 的 ownership。舉例來說，請說明某個 form field 是屬於 view 本身、某個 model 是從 parent 傳下來，或是多個畫面需要同一個 source of truth。這是拿到更好 swiftui-patterns 輸出的最快方式。
要求說明 wrapper 選擇理由
如果你想要更高品質的答案，可以要求這個 skill 說明它為什麼選擇 @State、@Binding、@Observable、@Bindable 或 @Environment。這樣可以降低 wrapper 被誤用或過度使用的機率，也能幫你在實作前先發現不匹配的地方。
注意常見失敗模式
最常見的失敗模式是過度工程化：明明 local state 就夠，卻用了 shared state 或 observable model。另一個問題是 navigation 指引太空泛，忽略了真實的 app flow。你可以透過明確指定使用者動作、目的地畫面，以及 navigation 後哪些狀態應該保留，來改善 prompt。
用具體程式碼範例反覆調整
第一次輸出後，直接貼上實際的 SwiftUI view 或 view model，請它做針對性的重寫。也可以明確說出你想改善什麼，例如更少的 recomputation、更簡單的 bindings，或更乾淨的 composition。對 Frontend Development 來說，這通常是從一般建議走到可交付 SwiftUI code 的最快路徑。