dickwu/apple-design-skill

Apple Design Skill – 面向 Apple HIG 的 AI 驱动 UI 审查器

它是什么

• 一个可重用的 技能，可添加到 AI 编码助手（Claude Code、Cursor、Codex 等）中。
• 该技能使助手能够充当设计审查器，根据 Apple 的《人机界面指南》(HIG) 检查移动端和桌面端 UI 代码。

工作原理

• 该仓库包含 123 个 Markdown 文件，它们是 HIG 页面的直接副本（另附一份精选的“Liquid Glass”指南）。每个文件都保留了 Apple 的措辞、标题、表格和变更日志信息。
• 一个小型 Node 脚本 (scripts/pull-hig.mjs) 可以从 developer.apple.com 重新下载最新的 HIG 页面，使参考集保持最新。
• 当代理收到类似 “根据 Apple 的指南审查我的 Flutter 屏幕” 的请求时，该技能会加载相关的 HIG Markdown，然后生成结构化的审查：
  1. Apple 的八项设计原则
  2. 可访问性检查（文本缩放、对比度、控件大小等）
  3. 平台惯例（标签栏、菜单、安全区域等）
  4. 视觉设计与工艺
  5. 交互模式
  6. 内容与写作风格
• 每条发现都包含 What（内容）、Why（引用确切的 HIG 标题）以及使用你正在使用的框架（Flutter、React Native、Tauri、Electron、SwiftUI、UIKit、AppKit）编写的 Fix（修复）。
• 特殊模式可处理应用图标审查、深色模式检查、iPhone Duo 双屏布局、Liquid Glass 效果以及生成式 AI 生成的 UI 组件。

安装

• 首选方法是通用的 skills CLI：

  npx skills add dickwu/apple-design-skill   # 添加到所有受支持的代理
  

• 你可以指定单个代理（-a claude-code、-a cursor、-a codex）。
• 对于 Claude Code，你还可以将仓库克隆到 ~/.claude/skills/apple-design。
• Cursor 和其他代理会读取仓库附带的相同 .cursorrules / .windsurfrules 文件。

典型用法

向你的代理提问：
- “根据 Apple 的指南审查我的 Flutter 应用主屏幕”
- “审计这个 Tauri 应用的可访问性”
- “这个设置屏幕是否符合 macOS 惯例？”
- “我的应用是否为 iPhone Duo 的双显示屏做好了准备？”
- “在不破坏 iOS 模式的前提下，给这个通用 UI 一个观点”

代理会以项目符号列表的形式回复审查，每项都会解释问题、HIG 参考以及所选框架的具体代码级修复。

关键组件

• SKILL.md – 定义技能的立场、视角、报告格式和改进工作流程。
• AGENTS.md – 为贡献者和每个受支持的 AI 代理提供的说明。
• scripts/pull-hig.mjs – 零依赖 Node 脚本，爬取 Apple 的 JSON API，将 123 个 HIG 页面渲染到 references/hig/*.md，并更新路由表。
• references/ – 生成的 HIG Markdown 文件以及跨平台转换表（cross-platform.md）。

为何重要

• 通过自动化检查 UI 是否符合 Apple 不断变化的指南这一繁琐且细节密集的过程，为开发人员节省时间。
• 弥合了以 Apple 为中心的设计语言与跨平台 UI 工具包（Flutter、React Native、Tauri、Electron 等）之间的差距。
• 通过简单的 node scripts/pull-hig.mjs 命令保持参考材料的新鲜度。

许可与出处

• 指南文本复制自 Apple 的公开《人机界面指南》，并非本项目所有。技能、脚本和精选指南均按仓库许可证“按原样”提供，并附有免责声明，即本项目与 Apple 无关联。

支持

• 作者欢迎通过 GitHub Sponsors 进行赞助，以帮助维护 HIG 拉取脚本并保持技能的最新状态。