mcpField
H
hig-technologies

hig-technologies

github.com/raintree-technology设计与 UI148635 次安装6 天前更新
代码仓库

关于 hig-technologies

hig-technologies 是为应用集成 Apple 技术提供 HIG 指引的技能,涵盖实现注意事项、隐私、用户流程和测试,涉及 HealthKit、Siri、iCloud 等技术。

主要功能

  1. 01Apple 技术集成指引
  2. 02隐私与权限注意事项
  3. 03实现清单及功能要求
  4. 04用户流程和测试指导
  5. 05按 Apple 技术分类的参考资料

适用场景

  1. 01规划应用对某项 Apple 技术的使用
  2. 02检查权限及面向用户的流程
  3. 03准备实现步骤和边缘情况测试

安装

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

$npx skills add https://github.com/raintree-technology/hig-doctor --skill hig-technologies

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

包含的文件

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

references/
airplay.md
always-on.md
apple-pay.md
augmented-reality.md
carekit.md
carplay.md
game-center.md
generative-ai.md
healthkit.md
homekit.md
icloud.md
id-verifier.md
imessage-apps-and-stickers.md
in-app-purchase.md
live-photos.md
mac-catalyst.md
machine-learning.md
maps.md
nfc.md
photo-editing.md
researchkit.md
shareplay.md
shazamkit.md
sign-in-with-apple.md
siri.md
tap-to-pay-on-iphone.md
voiceover.md
wallet.md

详细介绍

Apple HIG:技术

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

核心原则

  1. Apple 技术通过系统集成扩展 App 的功能。 每项技术都有成熟的面向用户的交互模式;偏离这些模式会造成困惑并损害信任。

  2. 隐私和用户控制至关重要。 尤其是健康、支付和身份技术。只请求必需的数据,说明请求原因,并尊重用户的选择。

  3. Siri:自然、可预测、可恢复。 使用清晰的对话意图短语,快速完成任务并确认结果。支持 App Shortcuts,提供主动建议。出现错误时提供明确的备用方案。

  4. 支付:透明、顺畅。 使用标准的 Apple Pay 按钮样式。Apple Pay 可用时,绝不要求用户提供银行卡信息。清楚说明用户购买的内容、价格,以及这是一次性购买还是订阅。

  5. 健康数据高度私密。 请求访问权限前,先说明健康益处。CareKit 任务应提供鼓励。ResearchKit 同意流程必须全面、易读,并尊重用户自主权。

  6. HomeKit:简单、可靠。 控制设备时立即响应。清楚显示设备状态。妥善处理连接问题。

  7. AR:创造真正的价值,而非噱头。 仅在空间环境有助于提升理解时使用 AR。引导用户完成设置(表面、光线、空间)。提供明确的退出方式,返回标准交互模式。

  8. ML 和生成式 AI:提升体验,但不带来意外。 提供智能建议、图像识别和文本预测。明确标注 AI 生成的内容。提供编辑、重新生成或关闭内容的控件。允许用户纠正错误。

  9. 将通过 Apple 登录作为首选项。 使用标准按钮样式。尊重用户隐藏电子邮件的偏好。ID Verifier:提供引导式流程,除验证所需内容外,不存储敏感数据。

  10. iCloud:同步应无感且可靠。 数据无需手动操作即可显示在所有设备上。妥善处理冲突。绝不丢失数据。

  11. SharePlay:支持实时参与。 支持多位参与者,显示参与者状态,并处理延迟。AirPlay:提供适当的“正在播放”元数据。

  12. CarPlay:优先保障驾驶安全。 尽量简化交互,使用较大的触控目标,不显示分散注意力的内容。仅允许以下类型的 App:音频、信息、EV 充电、导航、停车、快速订餐。

  13. 无障碍功能是基本要求。 每个元素都应具有有意义的 VoiceOver 标签、特征和操作。支持 Dynamic Type、Switch Control 等辅助技术。全程启用 VoiceOver 进行测试。

参考索引

参考主题关键内容
siri.mdSiri意图、快捷指令、语音交互、App Shortcuts
apple-pay.mdApple Pay支付按钮、结账流程、安全性
tap-to-pay-on-iphone.mdTap to Pay商户流程、非接触式支付
in-app-purchase.mdApp 内购买订阅、一次性购买、透明度
healthkit.mdHealthKit健康数据访问、隐私、权限
carekit.mdCareKit护理计划、任务、健康管理
researchkit.mdResearchKit研究、知情同意、数据收集
homekit.mdHomeKit智能家居控制、设备状态、场景
augmented-reality.mdARKit空间上下文、表面检测、设置
machine-learning.mdCore ML预测、智能功能、置信度处理
generative-ai.md生成式 AI归属、编辑、负责任的 AI、不确定性
icloud.mdiCloudCloudKit、跨设备同步、冲突解决
sign-in-with-apple.md通过 Apple 登录身份验证、隐私、按钮样式
id-verifier.mdID Verifier身份验证、证件扫描
shareplay.mdSharePlay共享体验、参与者状态
airplay.mdAirPlay媒体串流、正在播放、无线显示
carplay.mdCarPlay驾驶安全、允许的应用类型、大型触控目标
game-center.mdGame Center成就、排行榜、多人游戏
voiceover.mdVoiceOver屏幕阅读器、标签、特征、无障碍功能
wallet.mdWallet凭证、票券、会员卡
nfc.mdNFC标签读取、快速交互、App Clips
maps.md地图位置显示、标注、路线
mac-catalyst.mdMac Catalyst从 iPad 迁移到 Mac、菜单栏、键盘、指针
live-photos.mdLive Photos动态捕捉、播放、编辑
imessage-apps-and-stickers.mdiMessage 应用Messages 扩展、贴纸、紧凑界面
shazamkit.mdShazamKit音频识别、音乐识别
always-on.md全天候显示调暗状态、能效、减少更新
photo-editing.md照片编辑系统照片编辑器、滤镜、调整

输出格式

  1. 实现检查清单 —— 按步骤列出符合 Apple 指南的要求。
  2. 审核所需与可选功能。
  3. 隐私与权限要求 —— 数据访问、用途说明。
  4. 面向用户的流程,从权限提示到任务完成。
  5. 测试指南 —— 包括边缘情况在内的关键场景。

要询问的问题

  1. 使用哪种 Apple 技术?
  2. 核心使用场景是什么?
  3. 适用于哪些平台?
  4. 是否已审核 API 要求和授权?
  5. 需要哪些数据或权限?

相关技能

  • hig-inputs —— 与技术交互的输入方式(Siri 的语音、AR 的 Pencil、地图的手势)
  • hig-components-system —— 展示技术数据的小组件、复杂功能、实时活动
  • hig-components-status —— 技术操作的进度指示器(同步、支付、AR 加载)

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

评论

支持 Markdown