macos-design-guidelines

macos-design-guidelines skill 概觀

macos-design-guidelines 是一份實用的 macOS 設計與審查指南，協助你依照 Apple 的 Human Interface Guidelines 來評估 Mac App，重點放在真正影響發佈品質的決策：選單列、鍵盤操作、視窗行為、工具列、無障礙，以及系統整合。這個 macos-design-guidelines skill 特別適合使用 SwiftUI、AppKit、Mac Catalyst，或是將 iPad 體驗移植到 Mac 的團隊。

這個 macos-design-guidelines skill 的用途

當你需要的不只是通用 UI 建議，而是會直接改變實作選擇的 Mac 專屬規則時，就該用這個 macos-design-guidelines skill。它能幫你抓出像是缺少標準選單、快捷鍵覆蓋不足、視窗狀態不持久，或控制項不符合桌面慣例這類問題。

適合安裝的人

如果你是開發者、設計師，或正在審查 macOS 產品，而且這個產品很重視以鍵盤為主的工作流程、多視窗行為，以及透過選單來發現指令的方式，那就值得安裝。對於需要判斷某個 Mac 功能是否真的算「完成」，而且要符合使用者期待的代理或評審流程來說，也很有幫助。

它的差異在哪裡

macos-design-guidelines skill 不是用大而泛的原則來組織，而是以可直接採用的規則為主，所以在實作與 code review 時更容易落地。它最有價值的部分在關鍵章節：選單列、視窗、鍵盤、無障礙。這些地方一旦做錯，最容易直接影響採用意願。

如何使用 macos-design-guidelines skill

安裝並找到來源檔案

先針對這個 repo 執行 macos-design-guidelines 的安裝指令，接著從 SKILL.md 和 AGENTS.md 開始看。若想更快掌握全貌，在深入完整規則文字前，也先讀 metadata.json 與 rules/_sections.md。

把模糊需求轉成有用的提示詞

像「讓這個 app 更像 Mac」這種提示太空泛。更好的 macos-design-guidelines 使用提示，會明確說出你在做什麼、用哪個 framework，以及哪些介面面向最重要：

• “Review this SwiftUI document app for macOS. Check menu bar coverage, window persistence, and keyboard shortcuts.”
• “Apply macos-design-guidelines for Design Implementation to this AppKit sidebar workflow. Identify missing Mac conventions.”
• “Evaluate whether this Mac Catalyst screen should use a toolbar, context menu, or menu bar command.”

以正確順序閱讀 repository

大多數任務的最佳閱讀路徑是先看 SKILL.md，再看 rules/_sections.md 了解分類架構，最後再回到 SKILL.md 中相關的規則段落。當你想一次掌握決策優先順序時，則使用 AGENTS.md。這個順序能避免讀過頭，也能把注意力集中在最可能影響實作的規則上。

能提升輸出品質的工作流程建議

把 macos-design-guidelines 當成檢查清單來用，不要把它當成要模仿的散文。先明確交代 app 類型、目標使用者與互動模式。也要加入會影響判斷的限制，例如「單視窗工具」、「文件型 app」或「Catalyst 移植版」，因為這些條件會改變哪些規則最重要，也能避免得到過於泛化的建議。

macos-design-guidelines skill 常見問答

macos-design-guidelines 只適用於 SwiftUI app 嗎？

不是。macos-design-guidelines skill 涵蓋 SwiftUI 與 AppKit，也適用於 Mac Catalyst 與 Designed for iPad 的工作，前提是產品預期要像真正的 Mac App 一樣運作。

什麼時候不該使用它？

如果是 iOS-only 的 UI 決策、沒有桌面互動的視覺品牌工作，或是不會影響 macOS 行為的功能構想，就不建議依賴它。如果你的 app 本來就不打算遵循 Mac 慣例，這個 skill 反而可能加上不必要的限制。

這和一般提示詞有什麼不同？

一般提示詞可以提出偏 Mac 的行為建議，但 macos-design-guidelines 提供的是有優先級、且具備實作期待的結構化規則集合。這讓它更適合用在審查、QA 與設計決策，因為少掉一個桌面慣例，就可能造成很差的使用體驗。

它適合新手嗎？

適合，只要你能清楚描述 app。這個 skill 對新手尤其有幫助，因為它會把使用者理所當然會期待的 Mac 預設行為點出來，例如選單列、快捷鍵與視窗處理，而不是把這些選擇隱含掉。

如何改進 macos-design-guidelines skill

提供這個 skill 無法自行推斷的 app 背景

最大的改善來自於明確說明 app 是文件型、工具型，還是內容型，以及它是 SwiftUI、AppKit 或 Catalyst。這些資訊會影響指令結構、視窗行為，以及 app 應該暴露多少系統視窗裝飾。

要求以規則為基礎的審查，不只是靈感點子

要讓 macos-design-guidelines 的使用效果更好，請針對特定面向要求稽核：選單列、視窗、鍵盤、無障礙，或工具列行為。例如：「Review this feature against macos-design-guidelines and list only the violations that would matter to a Mac user.」

提供具體輸入，讓第一輪就有用

把目前 UI、既有指令，以及已實作的快捷鍵或視窗行為一起提供。如果你要的是 Design Implementation 協助，貼上相關畫面描述或 code excerpt，讓 skill 能找出缺少的 Mac 慣例，而不是靠猜測。

先針對風險最高的缺口反覆修正

拿到第一輪輸出後，先修正關鍵失敗項，再來處理細節潤飾。實務上，通常會先處理標準選單、快捷鍵覆蓋、視窗狀態與無障礙。接著用更新後的設計或程式碼再跑一次 skill，確認 macos-design-guidelines 的指引是否是整體一致地落實，而不只是停留在表面。