关于 macos-app-design
macOS App Design 是面向 macOS 应用设计与开发的指南，帮助开发者规划符合系统惯例、易访问且融入 macOS 工作流的原生体验。它结合界面准则、应用类型和构建前交付清单。
主要功能
- 01遵循 macOS 系统界面惯例
- 02检查菜单、键盘与窗口设计
- 03规划侧边栏和工具栏
- 04应用 Liquid Glass 使用准则
- 05识别应用类型并规划数据模型
- 06制定无障碍设计方案
适用场景
- 01设计符合 Mac 惯例的原生应用
- 02为主要命令规划菜单和快捷键
- 03评估 VoiceOver 与键盘导航支持
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/macos-app-design确认已加载。
附带文件references/macos-design-guide.md
详细介绍
macOS 应用设计与开发
设计和实现原生体验的 macOS 应用指南，打造快速、优雅、易于访问，并与 macOS 工作流深度集成的“优秀 Mac 公民”应用。
两条优先级最高的规则
- 优先使用系统组件和惯例，而不是定制 UI——这是打造“Mac 原生体验”的最快途径
- 如果要自定义栏、背景、边框或控件外观：先停下来，说明理由
快速参考：Mac 公民检查清单
| 区域 | 要求 |
|---|---|
| 菜单栏 | 使用标准布局（App/File/Edit/View/Window/Help），设置使用 ⌘, |
| 键盘 | 所有主要命令都可通过键盘访问，标准快捷键可用 |
| 窗口 | 流畅调整大小，支持多个窗口，尊重全屏和最小化行为 |
| 侧边栏 | 用于顶层导航，条目易于浏览，内容延伸至其后方 |
| 工具栏 | 按功能或使用频率分组，将次要操作移至“更多”菜单 |
| 文本 | 使用系统文本组件和标准编辑行为 |
| 辅助功能 | 提供 VoiceOver 标签、完整键盘导航和减少动态效果支持 |
Liquid Glass 快速规则
应该：
- 用于导航和控件层（工具栏、侧边栏、各类栏）
- 让系统组件提供内置行为
不应该：
- 应用于内容层（表格、列表、文档内容）
- 叠加“玻璃效果”
应用类型
首先确定应用类型：
- 文稿类：以文件为主要单位（打开／保存／复制）
- 资料库 + 编辑器：侧边栏列出项目，主区域显示详情
- 实用工具类：单窗口，可选菜单栏
- 菜单栏应用：常驻菜单栏，界面精简
- 专业工具类：界面信息密集，面向高级用户的工作流
开始构建前的交付内容
- 应用类型已确定
- 信息架构（侧边栏结构、导航、窗口模型）
- 命令映射（为每项主要功能配置菜单和键盘快捷键）
- 状态与数据模型（持久化、撤销／重做、并发）
- 辅助功能计划（VoiceOver、键盘、对比度、减少动态效果）
完整参考
完整的设计系统详情、Icon Composer 工作流、SF Symbols 指南、评估标准和完成定义检查清单：
请参阅：references/macos-design-guide.md
常见错误
| 错误 | 修正方法 |
|---|---|
| 缺少菜单栏命令 | 将所有功能放入菜单，并配置键盘快捷键 |
| 设置不在 App 菜单中 | 始终通过 App 菜单打开设置（⌘,） |
| 使用自定义文本组件 | 使用系统文本组件，融入 Mac 编辑生态 |
| 工具栏操作过多 | 将次要操作移出工具栏，并按功能分组 |
| 在内容上使用玻璃效果 | 仅在导航层使用 Liquid Glass |
| 破坏标准快捷键 | 绝不覆盖 ⌘C、⌘V、⌘Z 等快捷键 |
| 仅支持单窗口 | 在有助于工作流时支持多个窗口 |
评论
支持 Markdown