关于 hig-technologies
hig-technologies 是为应用集成 Apple 技术提供 HIG 指引的技能,涵盖实现注意事项、隐私、用户流程和测试,涉及 HealthKit、Siri、iCloud 等技术。
主要功能
- 01Apple 技术集成指引
- 02隐私与权限注意事项
- 03实现清单及功能要求
- 04用户流程和测试指导
- 05按 Apple 技术分类的参考资料
适用场景
- 01规划应用对某项 Apple 技术的使用
- 02检查权限及面向用户的流程
- 03准备实现步骤和边缘情况测试
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ raintree-technology/ hig-doctor --skill hig-technologies安装后在 Claude Code 中输入/hig-technologies确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/airplay.mdalways-on.mdapple-pay.mdaugmented-reality.mdcarekit.mdcarplay.mdgame-center.mdgenerative-ai.mdhealthkit.mdhomekit.mdicloud.mdid-verifier.mdimessage-apps-and-stickers.mdin-app-purchase.mdlive-photos.mdmac-catalyst.mdmachine-learning.mdmaps.mdnfc.mdphoto-editing.mdresearchkit.mdshareplay.mdshazamkit.mdsign-in-with-apple.mdsiri.mdtap-to-pay-on-iphone.mdvoiceover.mdwallet.md详细介绍
Apple HIG:技术
提问前,请先检查 .claude/apple-design-context.md。使用现有上下文,只询问其中尚未涵盖的信息。
核心原则
-
Apple 技术通过系统集成扩展 App 的功能。 每项技术都有成熟的面向用户的交互模式;偏离这些模式会造成困惑并损害信任。
-
隐私和用户控制至关重要。 尤其是健康、支付和身份技术。只请求必需的数据,说明请求原因,并尊重用户的选择。
-
Siri:自然、可预测、可恢复。 使用清晰的对话意图短语,快速完成任务并确认结果。支持 App Shortcuts,提供主动建议。出现错误时提供明确的备用方案。
-
支付:透明、顺畅。 使用标准的 Apple Pay 按钮样式。Apple Pay 可用时,绝不要求用户提供银行卡信息。清楚说明用户购买的内容、价格,以及这是一次性购买还是订阅。
-
健康数据高度私密。 请求访问权限前,先说明健康益处。CareKit 任务应提供鼓励。ResearchKit 同意流程必须全面、易读,并尊重用户自主权。
-
HomeKit:简单、可靠。 控制设备时立即响应。清楚显示设备状态。妥善处理连接问题。
-
AR:创造真正的价值,而非噱头。 仅在空间环境有助于提升理解时使用 AR。引导用户完成设置(表面、光线、空间)。提供明确的退出方式,返回标准交互模式。
-
ML 和生成式 AI:提升体验,但不带来意外。 提供智能建议、图像识别和文本预测。明确标注 AI 生成的内容。提供编辑、重新生成或关闭内容的控件。允许用户纠正错误。
-
将通过 Apple 登录作为首选项。 使用标准按钮样式。尊重用户隐藏电子邮件的偏好。ID Verifier:提供引导式流程,除验证所需内容外,不存储敏感数据。
-
iCloud:同步应无感且可靠。 数据无需手动操作即可显示在所有设备上。妥善处理冲突。绝不丢失数据。
-
SharePlay:支持实时参与。 支持多位参与者,显示参与者状态,并处理延迟。AirPlay:提供适当的“正在播放”元数据。
-
CarPlay:优先保障驾驶安全。 尽量简化交互,使用较大的触控目标,不显示分散注意力的内容。仅允许以下类型的 App:音频、信息、EV 充电、导航、停车、快速订餐。
-
无障碍功能是基本要求。 每个元素都应具有有意义的 VoiceOver 标签、特征和操作。支持 Dynamic Type、Switch Control 等辅助技术。全程启用 VoiceOver 进行测试。
参考索引
| 参考 | 主题 | 关键内容 |
|---|---|---|
| siri.md | Siri | 意图、快捷指令、语音交互、App Shortcuts |
| apple-pay.md | Apple Pay | 支付按钮、结账流程、安全性 |
| tap-to-pay-on-iphone.md | Tap to Pay | 商户流程、非接触式支付 |
| in-app-purchase.md | App 内购买 | 订阅、一次性购买、透明度 |
| healthkit.md | HealthKit | 健康数据访问、隐私、权限 |
| carekit.md | CareKit | 护理计划、任务、健康管理 |
| researchkit.md | ResearchKit | 研究、知情同意、数据收集 |
| homekit.md | HomeKit | 智能家居控制、设备状态、场景 |
| augmented-reality.md | ARKit | 空间上下文、表面检测、设置 |
| machine-learning.md | Core ML | 预测、智能功能、置信度处理 |
| generative-ai.md | 生成式 AI | 归属、编辑、负责任的 AI、不确定性 |
| icloud.md | iCloud | CloudKit、跨设备同步、冲突解决 |
| sign-in-with-apple.md | 通过 Apple 登录 | 身份验证、隐私、按钮样式 |
| id-verifier.md | ID Verifier | 身份验证、证件扫描 |
| shareplay.md | SharePlay | 共享体验、参与者状态 |
| airplay.md | AirPlay | 媒体串流、正在播放、无线显示 |
| carplay.md | CarPlay | 驾驶安全、允许的应用类型、大型触控目标 |
| game-center.md | Game Center | 成就、排行榜、多人游戏 |
| voiceover.md | VoiceOver | 屏幕阅读器、标签、特征、无障碍功能 |
| wallet.md | Wallet | 凭证、票券、会员卡 |
| nfc.md | NFC | 标签读取、快速交互、App Clips |
| maps.md | 地图 | 位置显示、标注、路线 |
| mac-catalyst.md | Mac Catalyst | 从 iPad 迁移到 Mac、菜单栏、键盘、指针 |
| live-photos.md | Live Photos | 动态捕捉、播放、编辑 |
| imessage-apps-and-stickers.md | iMessage 应用 | Messages 扩展、贴纸、紧凑界面 |
| shazamkit.md | ShazamKit | 音频识别、音乐识别 |
| always-on.md | 全天候显示 | 调暗状态、能效、减少更新 |
| photo-editing.md | 照片编辑 | 系统照片编辑器、滤镜、调整 |
输出格式
- 实现检查清单 —— 按步骤列出符合 Apple 指南的要求。
- 审核所需与可选功能。
- 隐私与权限要求 —— 数据访问、用途说明。
- 面向用户的流程,从权限提示到任务完成。
- 测试指南 —— 包括边缘情况在内的关键场景。
要询问的问题
- 使用哪种 Apple 技术?
- 核心使用场景是什么?
- 适用于哪些平台?
- 是否已审核 API 要求和授权?
- 需要哪些数据或权限?
相关技能
- hig-inputs —— 与技术交互的输入方式(Siri 的语音、AR 的 Pencil、地图的手势)
- hig-components-system —— 展示技术数据的小组件、复杂功能、实时活动
- hig-components-status —— 技术操作的进度指示器(同步、支付、AR 加载)
由 Raintree Technology 构建 · 更多开发者工具