hig-components-menus

hig-components-menus 技能概覽

hig-components-menus 是一個 Apple HIG 指引技能，用來設計 Apple 各平台上的選單與以按鈕驅動的命令介面。當你需要針對選單、Context Menu、Dock 選單、編輯選單、選單列、工具列、動作按鈕、彈出式按鈕、下拉按鈕、展開控制項或標準按鈕取得實際可操作的方向時，就適合使用 hig-components-menus 技能。

這個技能最適合 UI 設計師、產品設計師、前端工程師，以及產出 Apple 風格介面建議的 AI 代理。它真正要解決的，不是「什麼是選單？」而是「這裡該放哪種控制項、裡面該包含什麼、又該怎麼運作，才符合 Apple 慣例並維持可預期性。」

它能幫你判斷什麼

hig-components-menus 指南特別適合用在設計問題屬於「命令要放哪裡」，而不只是視覺打磨的情況。它能協助你在工具列動作、選單列命令、Context Menu 與內嵌控制項之間做取捨；避免把低價值項目塞進選單；並讓標籤、排序與分組方式符合平台預期。

為什麼值得安裝

和一般性的提示詞相比，hig-components-menus 提供了有結構的 HIG 覆蓋範圍，並且能交叉參照 buttons、context menus、edit menus 和 toolbars 等鄰近主題。這讓它在依賴元件邊界與行為的決策上更有用，尤其當你需要的是 Apple 式一致性，而不是泛用 UI 建議時。

最適合與不適合的情境

如果你正在為 Apple 平台設計，或要把產品意圖轉成符合 Apple HIG 的介面，就適合安裝 hig-components-menus。若你需要的是 framework 程式碼、元件實作細節，或非 Apple 設計系統，這個技能就不太適合；它提供的是設計指引與互動選擇，而不是 SDK APIs。

如何使用 hig-components-menus 技能

安裝後先打開正確的入口檔

先使用目錄中的 hig-components-menus 安裝路徑，然後從 SKILL.md 開始。最有價值的輔助檔案是 references/ 頁面，因為它們把主要元件家族拆成更容易閱讀的片段。若要快速判斷，建議先看 references/menus.md、references/buttons.md、references/context-menus.md 和 references/toolbars.md。

提供具體的 UI 問題給技能

hig-components-menus 的使用效果最好，是你描述畫面、平台與使用者目標，而不是要求抽象的設計建議。高品質的輸入會清楚指出命令來源、情境與限制：

• “Design the command surface for a macOS document editor with 8 frequent actions and 12 occasional actions.”
• “Should delete, duplicate, and share live in the toolbar, context menu, or menu bar for iPadOS?”
• “How should an Apple-style context menu differ for selected text versus a file item?”

如果你只說「幫我設計選單」，這個技能就必須猜互動模型，實用性會明顯下降。

依照決策順序閱讀 references

實務上的 hig-components-menus 指南，通常會先從主要元件下手，再逐步縮小到特殊情境。先讀 references/menus.md 了解標籤與組織規則，再看 references/context-menus.md 理解相關性與項目數量的取捨；當你在判斷哪些內容應該一直可見時，再看 references/toolbars.md。如果是 macOS 命令架構，使用 references/the-menu-bar.md；涉及文字編輯時，則看 references/edit-menus.md。

採用先決策、再內容、後排序的工作流程

請先讓技能輸出控制項選擇，再決定內容，最後才處理排序。好的提示詞格式如下：

1. Platform: macOS, iPadOS, iOS, or visionOS
2. Object: selection, document, message, file, or app-wide command
3. Action set: primary, secondary, destructive, and unavailable actions
4. Constraint: space, discoverability, keyboard support, or consistency

這種結構能幫助 hig-components-menus 更精準地回答命令該放哪裡，以及哪些項目應該隱藏、分組或提升優先級。

hig-components-menus 技能 FAQ

hig-components-menus 只適用於選單嗎？

不是。hig-components-menus 技能涵蓋選單，以及控制命令存取的相鄰按鈕模式，包括動作按鈕、彈出式按鈕、下拉按鈕、展開控制項、工具列與標準按鈕。這個更大的範圍很重要，因為許多 Apple UI 決策都取決於動作是以按鈕、選單項目，或兩者兼具的形式呈現。

什麼情況下不該使用這個技能？

如果你的問題主要是視覺品牌、特殊動效，或元件程式碼，就不該用 hig-components-menus。若你是為非 Apple 生態系設計，且不需要 Apple HIG 的行為規範，這也不是最合適的工具。若要處理實作細節，請搭配 framework 文件一起使用。

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

一般提示詞可能會建議一個選單結構，但 hig-components-menus 技能是針對 Apple 特有的取捨所調校：命令層級、平台慣例、選單密度，以及何時應優先顯示動作而不是藏起來。當你需要的是在 Apple 裝置上看起來更原生的 UI，這通常能減少猜測。

這個技能適合新手嗎？

適合，只要你能描述畫面和相關動作即可。開始使用 hig-components-menus 不需要很深的 HIG 知識，但你仍需要足夠的情境，讓技能知道使用者正在做什麼，以及有哪些可用命令。情境提供得越好，得到的建議就越準確。

如何改進 hig-components-menus 技能

提供動作清單，不只是目標

品質提升最大的關鍵，是把實際動作列出來。不要只說「讓這個更容易」，而是把命令集合告訴技能，並標示哪些動作是高頻、低頻、破壞性或情境性。這樣 hig-components-menus 才能判斷工具列、選單或 Context Menu 是否合適，以及某個項目該隱藏還是直接顯示。

明確說明平台與觸發方式

適用於 macOS 的選單模式，到了 iOS 或 iPadOS 可能就不對。請明確說明使用者是透過 click、right-click、touch and hold、keyboard，還是 menu bar navigation 來呼叫命令。這一點很重要，因為 hig-components-menus 指南對平台特定的互動路徑很敏感，尤其是在 Context Menu 與 edit menus 上。

要求取捨分析，不要只要最後答案

如果第一個答案太籠統，就進一步追問：為什麼某個命令要放在這裡，而不是那裡？例如：「哪些項目應該從 context menu 移到 toolbar，這樣做的可發現性代價是什麼？」這會讓 hig-components-menus 的輸出更有決策支援價值，而不只是列清單。

注意常見失敗模式

最常見的問題是選單過度擁擠、沒有清楚優先順序的重複命令，以及把核心動作藏在次要手勢之下。可以用這個技能提早檢查這些問題。如果第一次的輸出看起來太密集，就要求縮減為高價值項目，並更嚴格地區分主要與次要動作。