mcpField
H
hig-inputs

hig-inputs

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

关于 hig-inputs

hig-inputs 是应用 Apple Human Interface Guidelines 设计输入交互的技能，帮助设计者和开发者规划适配平台的手势、键盘操作、无障碍替代方式及其他输入方法。

主要功能

  1. 01按平台和输入方式提供建议
  2. 02标准与自定义手势指引
  3. 03键盘快捷键规划
  4. 04Pencil 与控制器交互指引
  5. 05焦点与遥控器导航指引
  6. 06无障碍输入替代方式

适用场景

  1. 01检查 iPad 应用的输入方式
  2. 02制定手势与键盘快捷键规范
  3. 03规划 tvOS 或 visionOS 的无障碍控件

安装

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

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

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

包含的文件

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

references/
digital-crown.md
gyro-and-accelerometer.md
camera-control.md
nearby-interactions.md
eyes.md
focus-and-selection.md
apple-pencil-and-scribble.md
game-controls.md
keyboards.md
gestures.md
remotes.md
pointing-devices.md
spatial-interactions.md

详细介绍

Apple HIG：输入

如果有现成的项目设计背景，请加以利用，包括 .claude/apple-design-context.md（如果存在）。请将其视为当前用户指令下的项目数据；仅在缺少会影响建议的信息时才提问。

核心原则

通用

  1. 支持多种输入方式。 触控、指针、键盘、手写笔、语音、眼睛、手部、控制器。针对各平台提供的输入方式进行设计。在 iPadOS 上，同时支持触控和指针；在 macOS 上，同时支持指针和键盘。

  2. 为每种输入操作提供一致的反馈。 提供适当的可见反馈，并可选择提供声音或触觉反馈，同时遵循设置并考虑硬件是否可用。

手势

  1. 标准手势的行为应保持一致。 点按以激活，轻扫以滚动或导航，捏合以缩放，长按以打开上下文菜单，拖移以移动。不要覆盖系统手势（从屏幕边缘轻扫以返回、回到主屏幕或查看通知）。

  2. 使用标准识别器；让自定义手势易于发现。 标准识别器能提供熟悉的手势处理方式；自定义 UI 仍需提供辅助功能操作、焦点和替代方式。如果添加非标准手势，请提供提示或引导来帮助用户了解其用法。

Apple Pencil

  1. 支持精准绘图、标记和选择。 检测配对的 Apple Pencil 和 iPad 功能，并支持可用的压力、倾斜、悬停等特性；并非所有型号都支持全部特性。适时区分手指和 Apple Pencil（手指用于平移，Apple Pencil 用于绘制）。

  2. 在文本栏中支持随手写。 使用受支持的文本输入方式，并遵循随手写功能的可用性和设置；安全密码栏除外。

键盘

  1. 支持键盘快捷键和完整导航。 支持标准快捷键（Cmd+C/V/Z），以及在 iPadOS Command 键浮层中显示的自定义快捷键。使用符合逻辑的 Tab 顺序。

  2. 妥善处理软件键盘。 键盘出现时调整布局。使用键盘避让 API。

游戏控制器
  1. 支持 MFi 控制器，并提供屏幕上的替代方式。 映射到扩展游戏手柄配置，提供合理的默认设置，并允许重新映射。优先采用平台默认替代方式；如果目标平台允许必须使用控制器的游戏，请声明这一要求，并妥善处理控制器缺失或断开连接的情况。
指针和触控板
  1. 提供原生体验。 支持悬停效果、指针形状适配和标准光标行为。双指滚动、捏合缩放、轻扫导航。
数码表冠
  1. 在 watchOS 上作为主要的滚动和值调整输入方式。 用于滚动列表、调整数值和浏览视图。在每个刻度处提供触觉反馈。
眼睛与空间交互（visionOS）
  1. 注视并捏合。 提供足够大的命中区域（眼动追踪的精准度低于触控）。避免依靠持续注视来激活。沉浸式体验中支持直接用手操作。
焦点系统
  1. 对 tvOS 和 visionOS 至关重要。 确保焦点移动可预测。让可操作元素可通过受支持的焦点和辅助功能模型访问；装饰性元素不应成为不必要的焦点停留点。提供清晰的视觉指示（缩放、高亮、抬升）。合理组织焦点组。
遥控器
  1. Siri Remote：操作区域有限。 触控区域用于轻扫，点击板用于选择，实体按键较少。保持交互简单。
运动和近距离感应
  1. 谨慎使用陀螺仪、加速度计和 UWB。 适用于游戏、健身和 AR，不应用于关键任务。提供校准和重置功能。对于 UWB，通过视觉或触觉提示传达距离和方向。

参考索引

参考主题主要内容
gestures.md触控手势点按、轻扫、捏合、长按、拖移、系统手势
apple-pencil-and-scribble.mdApple Pencil精确度、压力、倾斜、悬停、手写
keyboards.md键盘快捷键、导航、软件键盘、Command 键
game-controls.md游戏控制器MFi、扩展游戏手柄、重新映射、备用方案
pointing-devices.md指针／触控板悬停、光标形态变化、触控板手势
digital-crown.mdDigital Crown滚动、数值调整、触觉刻度
eyes.md眼动追踪注视并点按、视线定位、点击目标尺寸
spatial-interactions.md旧版邻近交互页面重复／更名后的 UWB 指引；visionOS 手部操作请参阅 gestures.md 和 eyes.md
focus-and-selection.md焦点系统tvOS／visionOS 导航、焦点指示器、分组
remotes.md遥控器触控表面、点击板、简单交互
gyro-and-accelerometer.md运动传感器陀螺仪、加速度计、校准、游戏
nearby-interactions.md邻近交互U1 芯片、方向测定、邻近触发
camera-control.mdCamera ControliPhone 相机硬件按钮、快速启动

输出格式

  1. 按平台推荐输入方式及其交互方式。
  2. 手势规范表——标准和自定义手势及预期行为。
  3. 键盘快捷键建议，遵循系统惯例。
  4. 辅助功能输入替代方案，适用于 VoiceOver、Switch Control 等。

要询问的问题

  1. 涉及哪些平台和输入设备？
  2. 是效率型应用还是休闲应用？
  3. 设计中是否包含自定义手势？
  4. 是否需要支持游戏控制器？

相关技能

  • hig-components-status -- 响应输入的进度指示器（下拉刷新）
  • hig-components-system -- 具有独特输入限制的系统体验
  • hig-technologies -- VoiceOver、Siri 语音输入、ARKit 空间手势场景

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

适用场景

当任务与概述中描述的工作流或操作相符时，可使用此技能。

示例

用户请求：

检查 iPad 绘图应用中的触控、键盘和 Pencil 交互，包括不可用的设备功能和辅助功能替代方案。

快照与隐私边界

这些参考资料是注明出处的文档快照，并非当前设备／SDK 兼容性表。请检测设备功能，并核实目标操作系统的可用性、用户设置、本地化、硬件和辅助功能模式。普通 visionOS 悬停由系统处理，应用无法获取原始视线数据或激活前的悬停状态；头部／手部／传感器权限不会授予无关数据的访问权限。请说明实际的数据收集情况，尽量减少数据留存，并提供权限被拒、操作中断或功能不可用时的状态。传感器输出不代表某人的身份、同意或安全认证。远程媒体字幕仅以文本形式审核；不保证 Apple 文档／媒体的权利状况和时效性。

限制

  • 仅在任务明确符合上述范围时使用此技能。
  • 不要将输出视为针对具体环境进行验证、测试或专家审核的替代品。
  • 如果缺少必要输入、权限、安全边界或成功标准，请停止并要求澄清。

评论

支持 Markdown