hig-components-menus
作者 raintree-technologyhig-components-menus 是一项面向菜单和按钮驱动命令界面的 Apple HIG 指导技能。 当你需要关于菜单、上下文菜单、工具栏、菜单栏以及相关控件的 UI 设计决策，并希望获得 Apple 风格的命令放置、分组和行为指导时，可使用 hig-components-menus 技能。
这项技能得分为 82/100，说明它是一个相当可靠的目录条目，适合需要 Apple HIG 菜单与按钮指导的用户。它提供了清晰的触发范围、具体的决策线索，以及足够结构化的参考材料，能比通用提示更少依赖猜测；不过它更像一份指导索引，而不是可直接执行的逐步工作流。
- 触发条件明确：描述中列出了许多清晰的用户意图和组件类型，便于代理准确调用。
- 覆盖有据可依：正文将菜单、上下文菜单、编辑菜单、菜单栏、工具栏、操作按钮、弹出/下拉按钮、展开控件和标准按钮连接起来。
- 交叉引用和来源标注有帮助：11 个参考文件指向 Apple HIG 的权威页面，提升了可信度和导航效率。
- 偏轻量化：仓库主要是整理好的参考内容，没有脚本或安装命令来支持流程化执行。
- 广度大于深度：虽然描述范围很广，但可见正文摘录显示其指导更偏高层，可能需要代理跨多个参考材料进行综合。
hig-components-menus 技能概览
hig-components-menus 是一项面向 Apple HIG 的指导型技能，用于设计 Apple 各平台上的菜单和由按钮驱动的命令界面。需要关于菜单、上下文菜单、Dock 菜单、编辑菜单、菜单栏、工具栏、操作按钮、弹出按钮、下拉按钮、展开控制或标准按钮的实用建议时，就可以使用 hig-components-menus 技能。
这项技能最适合 UI 设计师、产品设计师、前端工程师，以及需要生成 Apple 风格界面指导的 AI agent。它真正解决的并不是“什么是菜单”，而是“这里该放哪种控件、里面该包含什么，以及它应该如何表现，才能符合 Apple 习惯并保持可预期”。
它能帮你判断什么
hig-components-menus 指南适合处理命令放置，而不只是视觉润色。它能帮助你在工具栏操作、菜单栏命令、上下文菜单和内联控件之间做选择；避免把低价值条目塞进菜单；并让标签、排序和分组方式符合平台预期。
值得安装的原因
和通用 prompt 相比，hig-components-menus 提供了结构化的 HIG 覆盖，并且能交叉关联到按钮、上下文菜单、编辑菜单和工具栏等相邻主题。这让它在需要判断组件边界和交互行为时更有用，尤其适合追求 Apple 特有一致性、而不是泛泛 UI 建议的场景。
最适合与不适合的场景
如果你是在为 Apple 平台设计，或者把产品意图翻译成符合 Apple HIG 的 UI，就应该安装 hig-components-menus。如果你需要的是框架代码、组件实现细节，或者非 Apple 的设计系统，就不适合用它；这项技能提供的是设计指导和交互选择，而不是 SDK API。
如何使用 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 的使用效果最好的是，你描述的是屏幕、平台和用户目标，而不是抽象的设计建议。好的输入会写清命令来源、上下文和约束：
- “为一个 macOS 文档编辑器设计命令界面，包含 8 个高频操作和 12 个低频操作。”
- “在 iPadOS 上，删除、复制和分享应该放在工具栏、上下文菜单还是菜单栏？”
- “Apple 风格的上下文菜单在选中文本和选中文件项时，应该有什么不同？”
如果你只说“帮我设计菜单”，技能就只能猜交互模型，效果会差很多。
按决策顺序阅读参考资料
一份实用的 hig-components-menus 指南通常先从主组件入手，再收窄到特殊情况。先读 references/menus.md 了解标签和组织规则，再看 references/context-menus.md 了解相关性和条目数量，决定哪些内容必须始终可见时再读 references/toolbars.md。涉及 macOS 命令架构时使用 references/the-menu-bar.md，涉及文本编辑时则看 references/edit-menus.md。
采用先决策、后展开的工作流
可以先让技能输出控件选择，再输出内容，最后输出排序。一个比较好的 prompt 格式是：
- 平台：macOS、iPadOS、iOS 或 visionOS
- 对象：选区、文档、消息、文件或应用级命令
- 动作集合：主要、次要、破坏性和不可用操作
- 约束：空间、可发现性、键盘支持或一致性
这种结构能帮助 hig-components-menus 更准确地回答命令该放哪里，以及哪些内容应该隐藏、分组或提升优先级。
hig-components-menus 技能常见问题
hig-components-menus 只适用于菜单吗？
不是。hig-components-menus 技能覆盖菜单以及控制命令入口的相邻按钮模式，包括操作按钮、弹出按钮、下拉按钮、展开控制、工具栏和标准按钮。这个更大的范围很有用，因为很多 Apple UI 决策都取决于动作是以按钮、菜单项，还是两者兼有的方式呈现。
什么情况下不该用这项技能？
如果你的问题主要是视觉品牌、定制动效或组件代码，就不该用 hig-components-menus。如果你设计的不是 Apple 生态，而且也不需要 Apple HIG 行为，它同样不是合适的选择。涉及实现细节时，应该配合框架文档一起使用。
它和普通 prompt 有什么不同？
普通 prompt 可能也能建议一个菜单结构，但 hig-components-menus 技能是围绕 Apple 特有的权衡而调优的：命令层级、平台习惯、菜单密度，以及什么时候该优先显示动作、什么时候该隐藏起来。这通常意味着，当你需要一个在 Apple 设备上更有原生感的 UI 时，猜测会更少。
适合新手吗？
适合，只要你能描述屏幕和相关操作即可。开始使用 hig-components-menus 不需要很深的 HIG 知识，但你需要提供足够的上下文，让技能知道用户在做什么、有哪些命令可用。场景描述越完整，给出的指导就越好。
如何改进 hig-components-menus 技能
提供操作清单，而不只是目标
最大的质量提升来自列出真实动作。不要只说“让它更容易用”，而是把命令集列出来，并标注哪些是高频、低频、破坏性还是上下文相关的。这样 hig-components-menus 才能判断工具栏、菜单还是上下文菜单是否合适，以及某个条目该隐藏还是该直接展示。
明确说明平台和触发方式
适合 macOS 的菜单模式，在 iOS 或 iPadOS 上可能就是错的。请明确用户是通过点击、右键、长按、键盘还是菜单栏导航来触发命令。这个信息很关键，因为 hig-components-menus 指南对平台特定的交互路径很敏感，尤其是上下文菜单和编辑菜单。
追问权衡，不要只要最终答案
如果第一轮回答太泛，就继续问：为什么某个命令应该放在这里而不是那里。比如：“哪些项目应该从上下文菜单移到工具栏，它们的可发现性代价是什么？” 这样能让 hig-components-menus 的使用更有价值，因为输出会变成决策支持，而不只是清单。
留意常见失败模式
常见问题是菜单塞得太满、重复命令没有明确优先级，以及把核心操作藏在次级手势后面。可以用这项技能尽早检查这些问题。如果第一次输出看起来过于拥挤，就要求减少高价值条目，并更严格地区分主要操作和次要操作。