apple-hig

核心用法

Apple HIG Skill 是一份面向 Apple 全平台生态的设计规范知识库，旨在为开发者、设计师和产品经理提供随时可查阅的 Apple 设计准则参考。使用时，开发者可在构建 iOS、macOS、watchOS、tvOS 及 visionOS 应用时查询对应平台的设计原则、组件规范、交互模式和视觉标准。该 Skill 覆盖了从基础的 8pt 网格系统、SF Symbols 图标使用，到复杂的深度设计原则、平台特定交互（如 Digital Crown、Focus Engine）等全方位内容，支持在设计评审、原型开发、代码实现等各阶段快速获取官方设计指导。

显著优点

全平台覆盖：完整涵盖 Apple 五大操作系统的设计规范，包括最新的 visionOS 空间计算设计指南，实现了一站式跨平台设计知识整合。权威内容溯源：内容基于 Apple 官方 Human Interface Guidelines 整理，保留了 Clarity、Deference、Depth 三大核心设计原则的原意，确保设计建议与平台原生体验高度一致。实用性强：提供了具体的代码示例（如 SF Symbols 的 Swift 用法）、布局参数（安全区域、边距数值）和组件状态说明，可直接指导开发实现。无障碍优先：详细阐述了 Dynamic Type、VoiceOver、色彩对比度等无障碍设计规范，帮助应用达到 Apple 严格的可访问性标准。结构化查询：按平台、组件、主题分层组织，支持快速定位特定设计问题的解决方案。

潜在缺点与局限性

来源可信度限制：该 Skill 由个人开发者（T3 来源）整理维护，非 Apple 官方直接发布，存在内容理解偏差或更新延迟的风险。时效性挑战：Apple 设计规范随系统版本频繁更新（如 iOS 17/18 的新特性），静态文档可能无法实时同步最新变更（如新增组件或废弃模式）。纯文档限制：作为知识库型 Skill，仅提供设计指导而无自动化工具支持，无法直接生成代码、检查设计稿或自动化验证合规性。深度依赖：部分高级设计模式（如复杂的转场动画、自定义 SF Symbols）仍需参考官方完整文档或 WWDC 视频获取更深入细节。

适合的目标群体

Apple 平台开发者：SwiftUI/UIKit 开发者，需要快速查阅平台规范以确保应用符合原生体验标准。UI/UX 设计师：负责 Apple 生态应用界面设计的专业人员，需要准确掌握 Human Interface Guidelines 的具体参数。产品经理：规划 Apple 平台产品功能时，需要了解平台能力边界和设计约束。设计系统维护者：构建企业内部 Apple 平台设计系统时，作为基准参考文档。跨平台团队：需要将应用移植到 Apple 平台，理解平台差异化设计哲学的团队。

使用风险

技术风险：该 Skill 为纯 Markdown 文档，无代码执行能力，无网络通信，无文件系统操作，技术上几乎零风险。内容准确性风险：由于内容为第三方整理，建议关键设计决策前交叉验证 Apple 官方最新文档，特别是涉及 App Store 审核相关的设计规范时。版权风险：内容基于 Apple HIG 汇编，虽未涉及代码抄袭，但商业使用时建议注明设计规范来源。更新维护风险：个人维护项目存在停更可能，长期使用建议建立本地备份或关注官方文档更新渠道。