关于 apple-hig
用于将 Apple Human Interface Guidelines 应用于设计、实现、评审和平台适配的可移植技能包。路由器和主题指南将产品任务对应到相关规范，并明确来源快照的时效与平台限制。
主要功能
- 01将任务路由到相关 HIG 主题
- 02包含 13 个主题族路由和 158 项主题技能
- 03指导设计、实现、评审和适配
- 04查阅配套文章参考
- 05说明来源快照和覆盖范围限制
适用场景
- 01将产品需求转化为设计决策
- 02依据相关指南评审界面
- 03将界面适配到其他 Apple 平台
- 04核查平台支持和组件限制
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/apple-hig确认已加载。
详细介绍
Apple Human Interface Guidelines（Apple 人机界面指南）
使用相关 Apple 指南，做出具体的设计决策。本软件包包含一个路由器、13 个类别路由、158 个操作主题技能，以及配套的文章级参考资料。本软件包独立于 Apple。资料来源是一份带日期的英文 HIG 快照；如果任务依赖较新的版本或存在争议的细节，请查阅官方来源。
路由任务
- 根据请求或项目，确定目标平台、设备场景和用户任务。只有当平台会实质性影响答案，且无法推断时，才询问平台。保留用户对框架和产品的要求。
- 选择下方相关类别，并阅读该类别的
SKILL.md。按照其中的链接，找到.topics/下对应的具体主题操作指南，并阅读该指南的SKILL.md。遵循其中的决策流程，然后查阅配套文章，了解事实和平台限制。主题技能通过已安装的文件路径明确读取；无需自动发现嵌套内容。 对于平台支持、产品可行性或平台适配，先阅读每个相关平台的入门指南，再阅读具体组件或技术指南。检查平台模型和界面的支持限制。 - 确定路由前，请在完整主题索引中搜索任务相关概念，以及组件或框架名称。索引中的触发描述将日常产品需求与 Apple 的主题名称关联起来；用户无需提及 Apple 框架。查阅所属类别和匹配的主题操作指南，然后再看配套参考资料。针对范围较窄的问题，请搜索相关条目，而不是加载整个语料库。 如果任务涉及特定屏幕截图或动画示例，也请在可用时查阅其原始视觉说明。
- 应用通用指南以及目标平台已记录的差异。缺少某个平台的子章节，表示没有说明额外规则；这并不能证明该平台支持、不适用，或在各个平台上的行为完全一致。
- 如果任务涉及多个类别，请综合相关指南：一个组件也可能需要无障碍、排版、本地化、输入或系统体验方面的指导。将需求中的重要决策对应到所属主题。对于明确提出的关注点（例如隐私或无障碍），以及受影响的组件，都要阅读其所属操作指南；仅依赖相邻指南中的提醒是不够的。如有需要，请使用平台与任务路由。 进行评审时，即使缺少标记语言或行为信息，也要将提供的每个控件对应到候选组件操作指南。以此组织检查问题；缺少证据既不能证明存在缺陷，也不能将该控件排除在评审范围之外。
所有路径均相对于此已安装软件包，而非 shell 的当前目录。读取这些指南不需要 Python、网络、同级技能安装或作者缓存。
| 任务 | 阅读此主题技能 |
|---|---|
| 平台惯例、设计原则、游戏、设备适配 | 入门 |
| 辅助功能、排版、颜色、材质、布局、本地化、隐私 | 基础 |
| 引导、加载、搜索、共享、帐户、反馈、媒体、设置 | 模式 |
| 图表、图像、文本视图、嵌入式网页内容 | 内容 |
| 列表、集合、分栏视图、标签页视图、披露与分组 | 布局与组织 |
| 按钮、菜单、工具栏、菜单栏、装饰元素与操作 | 菜单与操作 |
| 侧边栏、标签栏、搜索字段、标记与路径控件 | 导航与搜索 |
| 警告框、工作表、弹出框、面板、滚动与窗口 | 呈现 |
| 文本字段、选择器、滑块、切换开关、选择控件 | 选择与输入 |
| 进度、活动、仪表与评分 | 状态 |
| 小组件、实时活动、通知、Siri 摘要与系统界面 | 系统体验 |
| 触控、键盘、指针、焦点、眼动、手势、控制器与传感器 | 输入方式 |
| Apple Pay、购买、Siri、VoiceOver、AI、CarPlay 与集成 | 技术 |
执行所请求的工作
在判断问题或选择框架之前，先检查提供的简报、流程、代码、规范或图像。 按照用户要求的模式操作：
- 设计： 根据主题的决策流程，产出可实施的规范或交互／状态模型，明确列出 具体转换和验收检查。将选择与用户的任务和目标平台联系起来。
- 实现： 如果项目的原生系统组件能提供所需行为，优先使用这些组件。HIG 说明了体验要求；请通过相应 SDK 文档核实 API 名称、可用性和代码。使用现有技术栈进行授权范围内的修改；仅提供文字说明 并不能完成实现请求。
- 审查： 描述观察到的问题、其影响、相关 HIG 规则以及具体的修正方案。将有来源支持的发现与 你提出的改进建议区分开来。检查证据前，不要臆造违规问题。
- 适配： 在应用目标平台的交互模型时，保留产品任务、数据和有用状态。修补提供的产物，或在用户 请求设计规范时，明确说明前后对照约定。
主题流程不依赖特定框架。已完成的示例和伪代码旨在指导决策，并不要求替换项目的技术。 只有在某项决策确实依赖相关流程时，才加载这些流程。
完成主题中可观察的检查，并分别报告已通过、未通过和未执行的项目。阅读文件、引用 Apple 资料或提出测试， 都不能证明运行时行为。静态代码或屏幕截图无法证明辅助技术的朗读顺序、原生渲染、实际使用舒适度、触觉反馈或 SDK 编译情况。
对于重要建议，请附上官方文章／章节链接。保留“考虑”“优先”和“避免”等限定措辞；不要把设计建议变成臆造的普遍要求。 数值规范应保留单位和平台适用范围。如果源材料中的段落互相冲突，应描述冲突并说明保守的应用方式，而不是悄然更改原文。
来源边界
这是全面的本地指南，并非 Apple 手册的逐字版本或 SDK API 参考。原始媒体说明是对文章引用的补充；源页面仍适用于展示视觉示例。源快照和审核状态记录在仓库的覆盖报告中，不属于常规技能加载内容。不要仅因本地文件存在，就推断其来源已经过独立审核。
历史上的 navigation-bars 链接现已指向当前的 Toolbars 指南；in-app-purchase 链接指向 Apple In-App Purchase。此快照中，旧版 Touch Bar 和 Messages for Business HIG 页面无法访问。不要臆造它们当前的规则。翻译版本、存档页面，以及完整的 SDK/WWDC 资料库均不在来源边界内。