关于 hig-platforms
hig-platforms 是一项应用 Apple Human Interface Guidelines 的设计技能,面向设计师和开发者。它帮助针对不同 Apple 平台调整交互与布局,而非照搬同一设计。
主要功能
- 01各平台专属设计原则
- 02涵盖七种 Apple 平台
- 03生成平台差异对照表
- 04提供各平台实现说明
- 05优先检查现有设计上下文
适用场景
- 01将 iPhone 应用适配到 iPadOS 和 macOS
- 02为目标平台选择导航方式
- 03规划跨平台的输入与布局
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ sickn33/ agentic-awesome-skills --skill hig-platforms安装后在 Claude Code 中输入/hig-platforms确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/designing-for-games.mddesigning-for-ios.mddesigning-for-ipados.mddesigning-for-macos.mddesigning-for-tvos.mddesigning-for-visionos.mddesigning-for-watchos.md详细介绍
Apple HIG:平台设计
提问前,请先检查 .claude/apple-design-context.md。使用现有上下文,只询问其中尚未涵盖的信息。
核心原则
-
每个平台都有鲜明的身份。 将共享设计和代码适配到各个平台。遵循各个平台的惯例、交互模式和用户预期。
-
iOS:触控优先。 在手持屏幕上直接操作。针对单手使用进行优化。导航使用标签栏和推入/弹出式导航栈。
-
iPadOS:扩展画布。 支持目标操作系统和硬件提供的可调整大小窗口及多任务模式。使用侧边栏和多列布局。除了触控,也支持指针和键盘。
-
macOS:指针和键盘。 可以展示密集信息。充分使用菜单栏、工具栏和键盘快捷键。窗口可调整大小,并支持精确控制。
-
tvOS:遥控器和焦点。 面向远距离观看。针对 Siri Remote 设计基于焦点的导航。使用大字号、简洁布局和可预测的空间焦点导航。
-
visionOS:空间交互。 使用窗口、体积和空间构建 3D 环境。交互采用系统管理的注视定位和间接手势;应用不得假定可以访问原始眼动追踪数据。遵循符合人体工学的舒适区域。
-
watchOS:一目了然,简明扼要。 信息应便于快速浏览。交互应简短。使用 Digital Crown、触感反馈和复杂功能及时呈现内容。
-
游戏:自有范式。 可以自由定义游戏内交互模式,但仍须遵循系统交互(通知、辅助功能、控制器)的平台惯例。
参考索引
| 参考资料 | 主题 | 主要内容 |
|---|---|---|
| designing-for-ios.md | iOS | 触控、标签栏、导航栈、手势、屏幕尺寸、安全区域 |
| designing-for-ipados.md | iPadOS | 多任务、侧边栏、指针、键盘、Apple Pencil、Stage Manager |
| designing-for-macos.md | macOS | 菜单栏、工具栏、窗口管理、键盘快捷键、密集布局、Dock |
| designing-for-tvos.md | tvOS | 焦点引擎、Siri Remote、放松观看体验、内容优先、视差 |
| designing-for-visionos.md | visionOS | 空间计算、窗口/体积/空间、眼动追踪、手势、深度 |
| designing-for-watchos.md | watchOS | 一目了然的 UI、Digital Crown、复杂功能、通知、触感反馈 |
| designing-for-games.md | 游戏 | 控制器、沉浸式体验、平台特定惯例、辅助功能 |
决策框架
-
确定主要使用场景。 在旅途中(iOS/watchOS)、在办公桌前(macOS)、在沙发上(tvOS),还是在空间环境中(visionOS)?
-
让输入方式匹配交互。 直接操作使用触控,精确操作使用指针,空间交互使用注视+手势,快速滚动使用 Digital Crown,焦点导航使用遥控器。
-
因平台而调整,不要照搬。 根据信息层级,macOS 侧边栏在 iPhone 上可以改为标签栏或其他紧凑的导航结构。visionOS 的体积在 watchOS 上没有对应形式。转换设计意图,而非实现方式。
-
发挥平台优势。 使用 iOS 上的实时活动、macOS 上的桌面小组件、watchOS 上的复杂功能,以及 visionOS 上的沉浸式空间。
-
保持品牌一致性, 同时遵循各平台的视觉语言和交互模式。
输出格式
- 平台特定建议,并引用相关 HIG 章节。
- 平台差异表,比较导航、输入、布局和惯例。
- 各平台的实现说明,包括推荐的 API 和适配策略。
需要询问的问题
- 你面向哪些平台?
- 是开发新应用,还是改造现有应用?如果是现有应用,它基于哪个平台?
- 使用 SwiftUI 还是 UIKit/AppKit?
- 需要支持较旧的操作系统版本吗?
- 主要使用场景是什么?(外出时、办公桌前、沙发上、空间环境中,还是快速浏览?)
相关技能
- hig-foundations —— 适用于各平台的通用原则(颜色、排版、无障碍设计、布局)
- hig-patterns —— 在不同平台上呈现方式各异的交互模式
- hig-components-layout —— 因平台而异的导航结构(标签栏、边栏、分栏视图)
- hig-components-content —— 能适配各平台的内容展示方式
由 Raintree Technology 构建 · 更多开发者工具
何时使用
当需要执行概述中描述的工作流或操作时,可使用此技能。
示例
用户请求:
此任务请使用 @hig-platforms:Apple 人机界面指南中的平台专属设计。
局限性
- 参考页面是快照。选择特定操作系统功能前,请检查 API 的可用性、设备支持情况以及 Apple 当前的指导;传感器、全天候显示、多任务处理和输入方式因硬件和版本而异。
- 平台设计指南并不授权收集个人、相机、位置、健康或追踪数据。只申请功能所需的权限,并只收集所需的数据。
- 仅当任务明确符合上述范围时才使用此技能。
- 请勿将输出视为环境专属验证、测试或专家审查的替代品。
- 如果缺少必要输入、权限、安全边界或成功标准,请暂停并请求澄清。