mcpField
H
hig-platforms

hig-platforms

github.com/sickn33设计与 UI48.7k61 次安装1 天前更新
代码仓库

关于 hig-platforms

hig-platforms 是一项应用 Apple Human Interface Guidelines 的设计技能,面向设计师和开发者。它帮助针对不同 Apple 平台调整交互与布局,而非照搬同一设计。

主要功能

  1. 01各平台专属设计原则
  2. 02涵盖七种 Apple 平台
  3. 03生成平台差异对照表
  4. 04提供各平台实现说明
  5. 05优先检查现有设计上下文

适用场景

  1. 01将 iPhone 应用适配到 iPadOS 和 macOS
  2. 02为目标平台选择导航方式
  3. 03规划跨平台的输入与布局

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/sickn33/agentic-awesome-skills --skill hig-platforms

安装后在 Claude Code 中输入/hig-platforms确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
designing-for-games.md
designing-for-ios.md
designing-for-ipados.md
designing-for-macos.md
designing-for-tvos.md
designing-for-visionos.md
designing-for-watchos.md

详细介绍

Apple HIG:平台设计

提问前,请先检查 .claude/apple-design-context.md。使用现有上下文,只询问其中尚未涵盖的信息。

核心原则

  1. 每个平台都有鲜明的身份。 将共享设计和代码适配到各个平台。遵循各个平台的惯例、交互模式和用户预期。

  2. iOS:触控优先。 在手持屏幕上直接操作。针对单手使用进行优化。导航使用标签栏和推入/弹出式导航栈。

  3. iPadOS:扩展画布。 支持目标操作系统和硬件提供的可调整大小窗口及多任务模式。使用侧边栏和多列布局。除了触控,也支持指针和键盘。

  4. macOS:指针和键盘。 可以展示密集信息。充分使用菜单栏、工具栏和键盘快捷键。窗口可调整大小,并支持精确控制。

  5. tvOS:遥控器和焦点。 面向远距离观看。针对 Siri Remote 设计基于焦点的导航。使用大字号、简洁布局和可预测的空间焦点导航。

  6. visionOS:空间交互。 使用窗口、体积和空间构建 3D 环境。交互采用系统管理的注视定位和间接手势;应用不得假定可以访问原始眼动追踪数据。遵循符合人体工学的舒适区域。

  7. watchOS:一目了然,简明扼要。 信息应便于快速浏览。交互应简短。使用 Digital Crown、触感反馈和复杂功能及时呈现内容。

  8. 游戏:自有范式。 可以自由定义游戏内交互模式,但仍须遵循系统交互(通知、辅助功能、控制器)的平台惯例。

参考索引

参考资料主题主要内容
designing-for-ios.mdiOS触控、标签栏、导航栈、手势、屏幕尺寸、安全区域
designing-for-ipados.mdiPadOS多任务、侧边栏、指针、键盘、Apple Pencil、Stage Manager
designing-for-macos.mdmacOS菜单栏、工具栏、窗口管理、键盘快捷键、密集布局、Dock
designing-for-tvos.mdtvOS焦点引擎、Siri Remote、放松观看体验、内容优先、视差
designing-for-visionos.mdvisionOS空间计算、窗口/体积/空间、眼动追踪、手势、深度
designing-for-watchos.mdwatchOS一目了然的 UI、Digital Crown、复杂功能、通知、触感反馈
designing-for-games.md游戏控制器、沉浸式体验、平台特定惯例、辅助功能

决策框架

  1. 确定主要使用场景。 在旅途中(iOS/watchOS)、在办公桌前(macOS)、在沙发上(tvOS),还是在空间环境中(visionOS)?

  2. 让输入方式匹配交互。 直接操作使用触控,精确操作使用指针,空间交互使用注视+手势,快速滚动使用 Digital Crown,焦点导航使用遥控器。

  3. 因平台而调整,不要照搬。 根据信息层级,macOS 侧边栏在 iPhone 上可以改为标签栏或其他紧凑的导航结构。visionOS 的体积在 watchOS 上没有对应形式。转换设计意图,而非实现方式。

  4. 发挥平台优势。 使用 iOS 上的实时活动、macOS 上的桌面小组件、watchOS 上的复杂功能,以及 visionOS 上的沉浸式空间。

  5. 保持品牌一致性, 同时遵循各平台的视觉语言和交互模式。

输出格式

  1. 平台特定建议,并引用相关 HIG 章节。
  2. 平台差异表,比较导航、输入、布局和惯例。
  3. 各平台的实现说明,包括推荐的 API 和适配策略。

需要询问的问题

  1. 你面向哪些平台?
  2. 是开发新应用,还是改造现有应用?如果是现有应用,它基于哪个平台?
  3. 使用 SwiftUI 还是 UIKit/AppKit?
  4. 需要支持较旧的操作系统版本吗?
  5. 主要使用场景是什么?(外出时、办公桌前、沙发上、空间环境中,还是快速浏览?)

相关技能

  • hig-foundations —— 适用于各平台的通用原则(颜色、排版、无障碍设计、布局)
  • hig-patterns —— 在不同平台上呈现方式各异的交互模式
  • hig-components-layout —— 因平台而异的导航结构(标签栏、边栏、分栏视图)
  • hig-components-content —— 能适配各平台的内容展示方式

由 Raintree Technology 构建 · 更多开发者工具

何时使用

当需要执行概述中描述的工作流或操作时,可使用此技能。

示例

用户请求:

此任务请使用 @hig-platforms:Apple 人机界面指南中的平台专属设计。

局限性

  • 参考页面是快照。选择特定操作系统功能前,请检查 API 的可用性、设备支持情况以及 Apple 当前的指导;传感器、全天候显示、多任务处理和输入方式因硬件和版本而异。
  • 平台设计指南并不授权收集个人、相机、位置、健康或追踪数据。只申请功能所需的权限,并只收集所需的数据。
  • 仅当任务明确符合上述范围时才使用此技能。
  • 请勿将输出视为环境专属验证、测试或专家审查的替代品。
  • 如果缺少必要输入、权限、安全边界或成功标准,请暂停并请求澄清。

评论

支持 Markdown