hig-foundations

hig-foundations 概览

hig-foundations 是 Apple Human Interface Guidelines 的基础决策技能，专门用于影响清晰度、可访问性和系统适配性的早期设计判断。 当你需要在颜色、字体、符号、材质、动效、隐私、布局、RTL 或 Apple 平台上的包容性设计方面获得实用指导时，就该使用 hig-foundations skill。 它最适合 UI 设计师、产品团队，以及需要把粗略的界面想法转化为符合 Apple 设计原则的决策、但又不想靠猜的 agents。

hig-foundations 用来解决什么问题

这个 skill 主要帮助你在进入具体页面、组件或平台模式之前，先回答“它应该看起来和感觉起来怎样？” 当问题本质上是基础层面的，比如深色模式对比度、Dynamic Type 支持、系统颜色的使用、字体选择，或者图标如何更像原生，这个 skill 尤其有用。 如果你的目标是让某个功能对齐 Apple HIG，而不是自己发明一套定制视觉语言，那么 hig-foundations 就是合适的起点。

什么时候最适合用

当你需要的是适用于整个 App 的 UI Design 决策，而不是只针对某一个页面时，hig-foundations 最有价值。 它适合 Apple 设备上的品牌风格设定、以可访问性优先的视觉系统，以及用于产品规格或设计提示的基础评审。 如果你已经需要的是某个具体交互模式，或者平台实现层面的细节，它就不那么合适了。

主要差异点

hig-foundations 的价值在于，它会把你引向系统默认值和兼顾可访问性的选择，而不是停留在装饰性设计猜测上。 这个 skill 还会通过交叉引用把你带到相关的 HIG 主题，方便你从基础层继续进入平台、模式或组件，而不用从头再来。 这让 hig-foundations 指南比一个泛泛的“按 Apple 风格来”提示更实用。

如何使用 hig-foundations skill

安装并准备 skill

使用 npx skills add raintree-technology/apple-hig-skills --skill hig-foundations 安装。 为了获得更好的结果，最好把它放在一个工作流里：让 agent 先检查 skill 文件和附近上下文，再开始起草建议。 当你提前准备好产品目标、目标平台和可访问性约束时，hig-foundations 的安装效果最好。

给 skill 正确的输入

弱提示会说：“让这个看起来更像 Apple。” 更强的提示会说：“把 hig-foundations 应用到这个 iOS onboarding 页面：使用系统颜色，支持 Dynamic Type，尽量减少动效，并让 CTA 在深色模式下依然清晰可读。” 需要把平台、受众、现有设计约束，以及已知问题——比如对比度、图标不一致或 RTL 布局——都写进去。 当前状态越具体，skill 需要自行推断的内容就越少。

按这个顺序阅读源内容

先看 SKILL.md，因为里面包含核心决策规则和交叉引用。 然后再检查 skill 中提到的仓库上下文，尤其是 README.md、AGENTS.md、metadata.json，以及如果存在的话，相关支持目录。 在这个 repository 里，最关键的实用信号其实就在 SKILL.md 本身，所以先快速浏览这一文件，通常就能判断 hig-foundations 的用法是否匹配你的任务。

能产出更好结果的工作流

把这个 skill 分成三步使用：先定义 UI 问题，再用平台与可访问性要求加以约束，最后请求建议或改写。 例如："Review this iPad settings page against hig-foundations and suggest changes for color, hierarchy, and touch target clarity." 这样模型就有了一个具体的设计表面可以评估，而不是被迫凭空发明。 如果你手头是文案或 wireframe，最好两者都提供；当文本和布局一起评审时，基础层指导通常效果更好。

hig-foundations skill 常见问题

hig-foundations 只适合设计师吗？

不是。 hig-foundations skill 对设计师、PM、前端工程师，以及需要 Apple 对齐 UI 指引的 agents 都有帮助。 如果你是在写实现任务单，或者在审核界面文案，它同样有用，因为很多基础层问题对代码和视觉的影响一样大。

它和通用提示词有什么区别？

通用提示词可能会提到 Apple 风格，但 hig-foundations 会给你一套可复用的基础决策框架，比如系统颜色、可访问性和视觉层级。 这通常能减少空泛输出，也让 hig-foundations 指南在跨页面、跨功能重复使用时更可靠。 它仍然不能替代产品上下文，但比用普通语言简单地要求“设计得更好”要严谨得多。

什么时候不该用这个 skill？

如果你需要的是非常具体的交互模式、组件库决策，或者深入的平台实现说明，就不要用 hig-foundations。 这类场景下，更聚焦的 skill 或直接的平台指南会更快。 如果设计已经遵循 Apple 规范，你只是想做少量文案修改，也没必要用它。

对初学者友好吗？

友好，只要你能描述产品页面和想解决的问题就行。 你不需要提前掌握所有 HIG 术语。 hig-foundations 最好的用法，是用简单、明确的提示词说清楚设备、问题和约束条件。

如何改进 hig-foundations skill

给出更尖锐的设计约束

质量提升最大的地方，在于明确哪些东西不能变：品牌色、现有布局、支持语言，或最低可访问性目标。 例如可以直接说：“保留现有结构，但让层级更像 Apple，保留品牌强调色，并通过深色模式对比度要求。” 这样 skill 就能把注意力放在取舍上，而不是重复显而易见的建议。

要求做决定，不要只要原则

当你让 hig-foundations 去“选择”时，它的表现最好。 与其问“解释可访问性”，不如直接问“这个状态卡适合哪种系统颜色？” 或“这个动效应该减弱还是移除？” 具体决策能产出你可以立刻应用、也能快速复核的结果。

用第一版继续迭代

拿到第一轮回复后，把范围收窄到最弱的部分：字体、对比度、图标设计，或者布局密度。 把具体问题反馈回去，比如“CTA 显得太突出”或者“内容对 Dynamic Type 来说还是太拥挤”。 hig-foundations 很适合迭代，因为基础问题通常可以一层一层修正，而不是一次性全部推倒重来。