简诗 Apple HIG 审查

它解决什么问题

原生 App 团队在 iOS、macOS、watchOS、visionOS 之间迁移设计时，常把某一平台的交互习惯直接搬到另一平台：iOS 上塞满侧边栏、watchOS 不做一眼可读的纵向布局、visionOS 忽略注视状态。与此同时，Apple HIG 随每个系统版本演进——WWDC25 公布的 Liquid Glass 已于 2025 年 9 月随 iOS 26、macOS Tahoe 等全平台落地，很多团队手里的规范文档已经过期。靠人肉对照官方页面做合规审计，成本高且容易漏项。

核心能力与工作方式

技能先读取已有的 product-context.md 或 ios-design-context.md，再确认三件事：目标平台、是新设计还是审计现有稿、应用类别。之后分两种模式：

• 从零设计：先定平台导航范式与布局原语，再应用排版与语义色，参考 references/platform-specifics.md 与 references/visual-design.md。
• HIG 合规审计：填写 templates/hig-audit-template.md，对每个可度量元素运行 scripts/hig_checker.py（纯标准库实现，支持批量输入），输出打分报告。

评分规则是百分制起扣：每项不通过扣 10 分，90–100 可发布，70–80 修复后发布，低于 70 需系统性返工。工具覆盖对比度、控件尺寸等可度量项；VoiceOver 标签、Dynamic Type、Reduce Transparency 等无法自动测量的项目由人工评估，并标注置信度（🟢 工具验证 / 🟡 需真机测试 / 🔴 假设）。

三条设计原则贯穿始终：Liquid Glass 的半透明材质层级（SwiftUI 中通过 glassEffect 修饰符应用）、无障碍优先（44×44 pt 最小点按区域、正文 4.5:1 对比度）、平台人体工学（iOS 拇指可达性、macOS 侧边栏与菜单栏、visionOS 注视状态）。还有一批主动触发项：半透明层上的低对比度、小于 44 pt 的可交互元素、无无障碍标签的图标按钮等，无需用户追问就会指出。

适用边界与注意点

• HIG 内容随系统版本演进，涉及具体规范断言时需对照 references/ 引用的官方页面核实，不要把它当成冻结的规则快照。
• 半透明图层上的浅色文字（如 #8E8E93）需在"最繁忙"的背景区域上复测对比度，并开启 Reduce Transparency 验证。
• 它输出审计结论与修复建议（What + Why + How），不直接改代码；命令默认仅作参考，需用户明确要求且目标范围清楚才可执行。
• 不安装依赖、不改系统权限、不创建持久化任务；涉及发送、发布、付款等外部写入操作前，先展示目标与影响并取得确认。