ios-design-guidelines

ios-design-guidelines skill 概覽

ios-design-guidelines skill 能幫你在不先讀完整原始碼的情況下，檢查、調整並改寫 iPhone UI 工作內容，使其符合 Apple Human Interface Guidelines。它特別適合 SwiftUI 和 UIKit 任務，因為這類工作中，版面、導覽、可及性、Dynamic Type、Dark Mode 或系統元件的選擇，常常會直接決定成果好壞。

當你需要的是針對真實介面決策的實用指引，而不是抽象的設計理論時，就該使用這個 ios-design-guidelines skill。它很適合設計師、iOS 工程師，以及需要快速抓出可避免 HIG 錯誤的審查代理：太小的點擊範圍、不安全的版面、非標準導覽、寫死的字級，或缺少可及性支援。

這個 skill 最適合做什麼

它的核心任務，是把一個粗略的 UI 想法，轉成適合 iPhone 的實作方案或審查清單。當你想要 Apple 對齊的預設值、SwiftUI/UIKit 範例，以及具體規則檢查，而不是泛泛的「讓它更直覺」建議時，這個 skill 的效果最好。

什麼情境下最有價值

當你在常見 iOS 模式之間做選擇時，它特別有幫助：tab bar 還是自訂導覽、safe area 的處理、底部固定操作、文字縮放、語意色彩，以及系統手勢。也因此，ios-design-guidelines guide 比起快速瀏覽 repo，更偏向決策導向。

什麼情況下不適合用

如果你需要的是整體產品策略、跨平台設計建議，或 Android/web 模式，這個 skill 就不是正確的依據。對於純視覺品牌工作、且不依賴 iOS 規範的情境，它也沒那麼有用。

如何使用 ios-design-guidelines skill

安裝並檢視正確的檔案

使用 npx skills add ehmo/platform-design-skills --skill ios-design-guidelines 安裝。若要讓 ios-design-guidelines 的安裝真正發揮效益，請先讀 SKILL.md，再看 AGENTS.md、metadata.json 和 rules/_sections.md。這些檔案會說明 skill 的範圍、規則優先順序，以及你最可能實際用到的幾組規則。

把模糊目標轉成可用的 prompt

最好的 ios-design-guidelines 用法，都是從具體的介面情境開始。請加入平台、畫面類型、使用者任務與目前風險。例如：「請針對這個 iPhone 的 SwiftUI 結帳畫面做審查，重點看拇指可及區、safe areas、觸控目標與 Dynamic Type。只提出能保留現有流程的修改。」這樣 skill 才有明確可操作的內容，而不是只收到空泛的「幫我改善 app」。

什麼輸入會讓輸出品質更好

請提供相關 UI 片段、元件清單與限制條件：iPhone-only 或 universal、SwiftUI 或 UIKit、支援的 iOS 版本，以及任何必須保留的行為。如果你要的是改寫，請把目前的程式碼或畫面結構一起給出，這樣 skill 才能把規則對應到實際控制項，而不是靠猜。

建議照著走的實務流程

先做一次聚焦的審查，再針對有風險的區域做第二輪更窄的檢查：導覽、可及性或版面。舉例來說，先請它列出最優先的 HIG 違規項目，再請它只針對前三個問題提出修正版實作。這樣可以讓 ios-design-guidelines 的使用更有效率，也讓修正更容易落地。

ios-design-guidelines skill 常見問答

這個 skill 只適合 SwiftUI 嗎？

不是。ios-design-guidelines skill 同時涵蓋 SwiftUI 和 UIKit，因此不論是新專案還是舊系統重構都能用。它的用途是拿實作選擇去對照 iPhone 的慣例，而不只是幫你產生程式碼。

它跟一般 prompt 有什麼不同？

一般 prompt 常只會產出表面的 UI 建議。這個 skill 是以 Apple 專屬規則和常見失敗模式為核心，所以當你需要可審查、偏 iPhone 原生的建議，而且不想靠太多猜測時，ios-design-guidelines guide 會更合適。

需要是 iOS 專家才能用嗎？

不需要。只要把畫面描述清楚，並提供你手上的程式碼或版面，初學者也能用得很好。主要限制在輸入品質：如果 prompt 很模糊，輸出通常也會很模糊。

什麼時候應該避免使用？

非 iPhone 介面、只做品牌 mockup，或你明確想要違反標準 iOS 行為的情況，就先不要用。如果你的目標是全新的互動模式，ios-design-guidelines skill 很可能會合理地把你拉回系統慣例。

如何改進 ios-design-guidelines skill

提供 skill 需要的規則脈絡

最好的結果，來自於你先指出這個介面最可能在哪些地方不符合 HIG。請說明你最在意的是版面、導覽、排版、色彩，還是可及性，這樣 ios-design-guidelines skill 才能調整回饋重點，而不是把注意力分散得太開。

要求修改，不只是評論

如果你需要的是實作協助，請直接要求改過的畫面結構、修正後的 SwiftUI/UIKit 程式碼，或有優先順序的修正清單。當 skill 能把問題轉成明確動作時，它最有價值，例如把觸控目標放大、把主要操作移到拇指區，或恢復 safe-area 相容性。

注意常見失敗模式

最常出錯的，通常是跟 iOS 慣例對著幹的自訂導覽、無法隨字級縮放的文字，以及只靠視覺狀態提示、卻不利於可及性的設計。如果第一次回覆太過籠統，就加上像「必須保留目前導覽」或「必須支援 extra-large Dynamic Type」這類明確限制，迫使 ios-design-guidelines 的使用更精準。

用更窄的第二個 prompt 反覆修正

拿到第一輪答案後，針對最重要的風險區域重新跑一次 skill，而不是再做一次完整審查。例如：「現在只檢查 VoiceOver、Reduce Motion 和對比度的可及性。」這樣回饋會更銳利，也能讓 ios-design-guidelines 的安裝在真實專案上更有價值。