Platform Design Skills（各平台设计规范技能包）

# Platform Design Skills：安装说明

这个工具包里是 Mindket 写的安装说明，不包含这八个技能、它们的规则索引，也不包含仓库里那份 Apple HIG PDF。这些要从 ehmo 的仓库安装：https://github.com/ehmo/platform-design-skills

许可证：MIT。仓库的 LICENSE 在年份 2026 后面没有写版权人的名字。全文见 https://github.com/ehmo/platform-design-skills/blob/main/LICENSE

Platform Design Skills 是 ehmo 的社区项目，并非 Apple、Google、W3C 或 Anthropic 制作或背书。它把这些机构公开的指南提炼成给编程智能体用的规则，指南本身仍归它们所有。

这些说明的来源：README（https://github.com/ehmo/platform-design-skills/blob/main/README.md），仓库的 AGENTS.md 和 CHANGELOG.md，以及 https://github.com/ehmo/platform-design-skills/tree/main/skills 下的八个 SKILL.md。安装器的说明出自 README 里提到的 skills 命令行工具，也就是 Vercel Labs 的 skills 仓库（https://github.com/vercel-labs/skills）的 README，以及它的 docs/commands.md 和 docs/agents.md。Claude Code 从哪里加载技能，出自 Claude Code 自己的技能页面（https://code.claude.com/docs/en/skills）。所有命令都由 Mindket 照抄，一条也没有运行过。

## 它是什么

给编程智能体用的八个技能，每个平台一个。每个技能都有编了号或代码的规则，并附有该平台语言的代码，智能体可以用它们检查一个界面，或照着规则写出新界面。README 说总共有 450 多条规则。

| 技能名称 | 平台 | 依据的指南 |
|---|---|---|
| ios-design-guidelines | iPhone | Apple Human Interface Guidelines |
| ipados-design-guidelines | iPad | Apple Human Interface Guidelines |
| macos-design-guidelines | Mac | Apple Human Interface Guidelines |
| watchos-design-guidelines | Apple Watch | Apple Human Interface Guidelines |
| visionos-design-guidelines | Apple Vision Pro | Apple Human Interface Guidelines |
| tvos-design-guidelines | Apple TV | Apple Human Interface Guidelines |
| android-design-guidelines | Android | Material Design 3 |
| web-design-guidelines | 网页 | WCAG 2.2 和 MDN |

来源：仓库 AGENTS.md 里的表格，以及每个 SKILL.md 开头的 name 一行。README 把这些文件夹叫作 ios、ipados、macos、watchos、visionos、tvos、android 和 web。

## 谁做什么

- 你：运行安装命令，然后用平常的话请 Claude 搭建或审查一个界面。
- 安装器：把技能文件夹放到你的智能体读取的位置，可以是指向同一份正本的链接，也可以是各自独立的副本。它是另一个程序，不是作者的。
- Claude（或其他智能体）：你的请求和某个技能的描述对得上时，读取这个技能，然后用其中的规则检查你的代码，或者照着规则写新代码。规则都是文本，所以这套技能里没有任何东西会替你运行代码或检查屏幕。

## 工具包里的文件

- setup/skills-cli.md：README 唯一的安装命令，安装器会问什么，以及怎么选技能、范围和智能体
- setup/claude-code.md：为 Claude Code 安装、技能装到哪里，以及怎么确认
- setup/other-agents.md：Codex、Cursor、Gemini CLI、GitHub Copilot，以及安装器列出的其他智能体
- setup/first-run.md：README 的示例提示词、每个技能涵盖什么，以及哪些地方要再核对

## 先准备好这些

- 一个能读取 Agent Skills 的智能体，比如 Claude Code、Codex、Cursor 或 Gemini CLI。
- Node.js 22.20 或更新版本，因为安装器的 README 这样要求。安装命令通过 npx 运行。
- 如果只想装到一个项目里，需要一个 git 项目或普通文件夹。全局安装不需要。
- 这套技能不需要账号、API 密钥或其他软件。

## 装到哪里

- 项目安装，安装器的默认方式：技能文件夹放在你的项目里，也就是智能体自己的技能文件夹。Claude Code 的是 .claude/skills/。
- 全局安装，加 -g 选项：文件夹放在你的用户主目录里。Claude Code 的是 ~/.claude/skills/。
- 每个技能文件夹里有一个写着规则的 SKILL.md、一个 metadata.json、一个 AGENTS.md 和一个 rules 文件夹。仓库的 AGENTS.md 说，这个文件夹里是 _sections.md，一份按类别整理的规则索引。

## 你的数据

这些技能是文本。它们告诉智能体指南里写了什么，不会把任何东西发到别处。安装器会从 GitHub 下载仓库。它的 README 说它会收集匿名使用数据，设置 DISABLE_TELEMETRY=1 或 DO_NOT_TRACK=1 可以关掉。你交给 Claude 的内容，比如你的代码和截图，会像其他 Claude 工作一样发给 Claude。

## 更新和卸载

作者的 README 没有给出更新或卸载的步骤。安装器的 README 给出了 npx skills update 和 npx skills remove，见 setup/skills-cli.md。

README.md  5 KB
setup/claude-code.md  3 KB
setup/first-run.md  4 KB
setup/other-agents.md  2 KB
setup/skills-cli.md  3 KB