macos-design-guidelines

macos-design-guidelines 技能概览

macos-design-guidelines 是一份实用指南，用于按照 Apple 的 Human Interface Guidelines 设计和审查 Mac 应用，重点关注会直接影响上线质量的关键决策：菜单栏、键盘控制、窗口行为、工具栏、无障碍和系统集成。它最适合使用 SwiftUI、AppKit、Mac Catalyst 开发，或把 iPad 体验移植到 Mac 的团队。

这个 macos-design-guidelines 技能适合做什么

当你需要的不只是泛泛的 UI 建议，而是会改变实现选择的 Mac 专属规则时，就应该使用这个 macos-design-guidelines 技能。它能帮你发现诸如缺少标准菜单、快捷键覆盖不足、窗口状态无法持久化，或者控件不符合桌面端惯例之类的问题。

谁应该安装它

如果你是开发者、设计师或评审人员，正在处理一个 macOS 产品，而且键盘优先工作流、多窗口行为、以及基于菜单的命令发现方式很重要，那么就应该安装它。它也适合需要判断某个 Mac 功能是否已经以符合用户预期的方式“做完了”的智能体。

它为什么与众不同

macos-design-guidelines 技能围绕可执行规则组织，而不是空泛原则，因此在实现和代码审查阶段都更容易直接应用。它最有价值的部分集中在几个关键章节：菜单栏、窗口、键盘和无障碍。这些领域一旦做错，最容易直接阻碍产品被接受。

如何使用 macos-design-guidelines 技能

安装并定位源文件

先运行这个 repo 的 macos-design-guidelines 安装命令，然后从 SKILL.md 和 AGENTS.md 开始看。为了更快建立整体印象，也建议在通读完整规则文本之前先看 metadata.json 和 rules/_sections.md。

把模糊需求改写成有用的提示词

像“让这个 app 更像 Mac”这种提示太笼统。更好的 macos-design-guidelines 使用方式，是明确你在做什么、使用什么框架，以及哪些界面最关键：

• “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.”

按正确顺序阅读仓库

对大多数任务来说，最佳阅读路径是先看 SKILL.md，再看 rules/_sections.md 了解分类地图，然后再进入 SKILL.md 中相关的规则章节。如果你想一次性掌握决策优先级，就读 AGENTS.md。按这个顺序可以避免过度阅读，也能把注意力集中在最可能影响实现的规则上。

能提升输出质量的工作流建议

把 macos-design-guidelines 指南当作检查清单，而不是要模仿的行文。开头就说明 app 类型、目标用户和交互模型。把重要约束也一并写明，例如“单窗口工具”“基于文档的 app”或“Catalyst 移植”，因为这些条件会改变规则优先级，也能避免得到过于泛化的建议。

macos-design-guidelines 技能 FAQ

macos-design-guidelines 只适用于 SwiftUI 应用吗？

不是。macos-design-guidelines 技能覆盖 SwiftUI 和 AppKit，在产品需要表现得像真正 Mac 应用时，它对 Mac Catalyst 和 Designed for iPad 工作流也同样适用。

什么时候不该用它？

如果是仅面向 iOS 的 UI 决策、没有桌面交互的视觉品牌工作，或者不影响 macOS 行为的功能点，就不该依赖它。若你的 app 本来就不打算遵循 Mac 惯例，这个技能反而可能引入不必要的约束。

它和普通提示词有什么区别？

普通提示词可以建议“像 Mac 一样”去实现，但 macos-design-guidelines 提供的是一套带优先级、且对实现有明确预期的结构化规则。这让它更适合评审、QA 和设计决策，因为漏掉一个桌面端惯例就可能造成糟糕的用户体验。

它适合新手吗？

适合，只要你能清楚描述这个 app。这个技能对新手尤其有帮助，因为它会把用户默认期待的 Mac 行为显性化，比如菜单栏、快捷键和窗口处理，而不是把这些选择留在隐含层面。

如何改进 macos-design-guidelines 技能

提供技能无法自行推断的应用背景

最大的改进来自于明确说明 app 是基于文档、偏工具型，还是内容型，以及它是 SwiftUI、AppKit 还是 Catalyst。这些信息会影响命令结构、窗口行为，以及 app 应该暴露多少系统级 chrome。

要求基于规则审查，而不只是要点子

想更好地使用 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，就直接贴出相关界面说明或代码片段，这样技能才能识别缺失的 Mac 惯例，而不是靠猜。

先迭代最有风险的缺口

拿到第一轮结果后，先修关键失败项，再去打磨细节。实际操作里，这通常意味着先处理标准菜单、快捷键覆盖、窗口状态和无障碍。随后用更新后的设计或代码重新运行这个技能，确认 macos-design-guidelines 指南是否被一致地落实，而不是只停留在表面。