SuperAPI AI 工具集

hig-technologies

设计与创作

查看项目

更新于 10-16 02:17

技能介绍

用途

该技能用于在涉及 Apple 平台技术能力的设计与开发任务中,提供符合 Apple 人机界面指南(HIG)的规范参考。它强调在提问前先检查 .claude/apple-design-context.md,优先使用已有上下文,只询问尚未覆盖的信息,避免重复提问。

主要能力

技能按技术主题组织参考内容,涵盖:

  • Siri 与语音:意图、快捷指令、语音交互、App Shortcuts。
  • 支付与商务:Apple Pay 按钮与结账流程、Tap to Pay、App 内购买(订阅与一次性购买)。
  • 健康与健身:HealthKit 数据访问与隐私、CareKit 护理计划与任务、ResearchKit 研究与知情同意。
  • 智能家居:HomeKit 设备控制、设备状态、场景。
  • 增强现实:ARKit 空间上下文、表面检测与设置。
  • 机器学习与生成式 AI:Core ML 预测与置信度处理;生成式 AI 的归属标注、编辑、负责任 AI 与不确定性。
  • 身份与认证:Sign in with Apple、ID Verifier 身份验证与文档扫描。
  • 云与数据:iCloud、CloudKit、跨设备同步与冲突解决。
  • 共享体验:SharePlay 参与者在线状态、AirPlay 媒体串流与 Now Playing。
  • 车载:CarPlay 驾驶安全、允许的 App 类型、大触控目标。
  • 其他:Game Center、VoiceOver、Wallet、NFC、Maps、Mac Catalyst、Live Photos、iMessage 应用与贴纸、ShazamKit、常亮显示、照片编辑。

关键原则

  • 通用:Apple 技术通过系统集成扩展 App 能力,每项技术都有既定的面向用户模式,偏离会造成困惑并削弱信任。
  • 隐私与用户控制:对健康、支付、身份类技术尤为重要,只请求所需数据、说明原因、尊重用户选择。
  • Siri 与语音:自然、可预测、可恢复;清晰的对话意图短语,快速完成并确认结果;支持 App Shortcuts;错误处理要有明确回退。
  • 支付与商务:透明且无摩擦;使用标准 Apple Pay 按钮样式;有 Apple Pay 时不要索取卡信息;清楚说明购买内容、价格及一次性或订阅。
  • 健康与健身:健康数据高度个人化,请求访问前先说明健康收益;CareKit 任务应具鼓励性;ResearchKit 同意流程须详尽、可读并尊重自主权。
  • 智能家居:简单可靠,控制设备时即时响应,清晰显示设备状态,优雅处理连接问题。
  • 增强现实:提供真实价值而非噱头;空间上下文有助于理解时使用 AR;引导设置(表面、光照、空间);提供清晰退出回到标准交互。
  • 机器学习与生成式 AI:增强而不意外;智能建议、图像识别、文本预测;明确标注 AI 生成内容;提供编辑、重新生成或忽略的控制;允许用户纠正错误。
  • 身份与认证:Sign in with Apple 作为首选;标准按钮样式;尊重隐藏邮箱偏好;ID Verifier 采用引导流程,不存储超出验证所需的敏感数据。
  • 云与数据:同步应无感可靠,数据无需手动干预即出现在所有设备;优雅处理冲突;绝不丢失数据。
  • 共享体验:实时参与;SharePlay 支持多参与者、显示在线状态、处理延迟;AirPlay 提供合适的 Now Playing 元数据。
  • 车载:驾驶安全优先;最小化交互复杂度、大触控目标、无干扰内容;仅允许音频、消息、电动车充电、导航、停车、快速订餐类 App。
  • 可访问性:基线要求;每个元素都有有意义的 VoiceOver 标签、特征与操作;支持动态字体、切换控制等辅助技术;全程开启 VoiceOver 测试。

使用方式

技能以参考索引形式列出各主题对应的参考文件(如 siri.md、apple-pay.md、healthkit.md、arkit 相关 augmented-reality.md、machine-learning.md、generative-ai.md、icloud.md、sign-in-with-apple.md、id-verifier.md、shareplay.md、airplay.md、carplay.md、game-center.md、voiceover.md、wallet.md、nfc.md、maps.md、mac-catalyst.md、live-photos.md、imessage-apps-and-stickers.md、shazamkit.md、always-on.md、photo-editing.md 等),供按主题查阅。

输出格式包括:实现清单(按 Apple 指南的逐步要求)、必需与可选功能(用于审核)、隐私与权限要求(数据访问、用途说明)、从权限提示到任务完成的用户流程、测试指导(含边界情况的关键场景)。

提问清单:涉及哪项 Apple 技术?核心用例是什么?面向哪些平台?是否已审阅 API 要求与授权(entitlements)?需要哪些数据或权限?

相关技能:hig-inputs(与技术交互的输入方式,如 Siri 的语音、AR 的 Pencil、Maps 的手势)、hig-components-system(Widget、复杂功能、实时活动呈现技术数据)、hig-components-status(技术操作如同步、支付、AR 加载的进度指示)。

适用场景

当任务明确匹配上述 Apple 技术主题的设计或实现规范参考时使用。

限制

仅当任务明确匹配上述范围时使用该技能。不得将输出视为环境特定验证、测试或专家评审的替代。若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。