dickwu/apple-design-skill

Apple Design Skill – 基于AI的Apple风格UI审查工具

是什么 – 适用于Claude Code、Cursor、Codex、OpenCode、Windsurf等AI编码助手的插件（称为 skill）。该技能使助手能够作为设计审查员，依据Apple的Human Interface Guidelines（HIG）检查UI。支持多种前端框架（Flutter、React Native、Tauri、Electron、SwiftUI、UIKit、AppKit），并能以所选框架的语言提出具体的修复建议。

如何工作 – 仓库包含：

• 122个从官方Apple HIG页面生成的Markdown文件（原始文字、标题、表格和变更日志均完整保留）。
• 一个小型Node脚本（scripts/pull-hig.mjs），可重新下载最新的HIG页面并重新生成这些Markdown文件。
• 一个SKILL.md，定义了代理的“立场”、审查清单、报告格式，以及可选的improvement mode（提出设计令牌系统，如调色板、排版、动效等）。
• 路由表（references/hig-lookup.md），将请求（例如 “审查我的Flutter主页”）映射到相关的HIG页面。

当代理收到设计审查提示时，该技能会加载相应的HIG Markdown文件，然后：

1. 检查Apple的八个设计原则（目的、主体性、责任感、熟悉度、灵活性、简洁性、工艺、愉悦感）。
2. 验证可访问性数值（文本缩放、对比度、控件大小、VoiceOver、键盘、动效设置）。
3. 确认平台特定的惯例（标签栏、菜单、安全区域、快捷键等）。
4. 审查视觉工艺（颜色、字体、布局、图标、动效、“视角”）。
5. 检查交互模式（加载、警告、撤销、破坏性操作）。
6. 检查内容与文案（标签、大小写、错误消息）。

每个发现均以 问题、原因（引用确切的HIG标题）和 修复方案（用开发者所用框架的语言编写）返回。专用子模式涵盖应用图标、深色模式、“Liquid Glass”效果、引导流程、权限、表单、生成式AI组件和单个UI组件。

安装 – 该技能通过通用的 skills CLI 分发：

npx skills add dickwu/apple-design-skill          # 为所有支持的代理安装
npx skills add dickwu/apple-design-skill -a claude-code   # 仅限Claude Code
npx skills add dickwu/apple-design-skill -g               # 用户级安装

对于读取本地 .claude/skills/、.cursorrules、.windsurfrules 等文件的代理，也可直接将仓库克隆到相应文件夹中。

典型用法 – 在与助手的聊天中，只需提出例如：

• “根据Apple指南审查我的Flutter应用主页。”
• “审计这个Tauri应用的可访问性。”
• “这个macOS设置窗口是否符合平台惯例？”
• “在不破坏iOS模式的前提下，为这个UI赋予一个视角。” 助手将返回结构化审查报告和具体的代码级建议。

保持数据最新 – 运行捆绑脚本：

node scripts/pull-hig.mjs   # 需要Node 18+

该脚本会向 developer.apple.com 发出约150次请求，重写 references/hig/*.md 文件，并更新查找表。该脚本是确定性的；第二次运行应无变化。

许可与来源 – 指南文本源自Apple公开的Human Interface Guidelines，并在每个生成文件中注明出处。该仓库与Apple无关联。代码和技能按仓库许可证“按原样”提供（详见仓库中的LICENSE文件）。

---

总结 – Apple Design Skill将通用LLM编码助手转变为专门的UI设计审计工具，可在多个开发框架中强制执行Apple的设计标准，提供最新参考材料和可操作的、框架特定的修复方案。