hig-foundations

Name: hig-foundations
Author: raintree-technology

github.com/raintree-technology设计与 UI148746 次安装6 天前更新

代码仓库

关于 hig-foundations

一项运用 Apple Human Interface Guidelines 设计基础的技能，为开发者提供无障碍、视觉语言、隐私和平台惯例方面的指导，并附有实现参考。

主要功能

01无障碍优先的设计指导
02系统颜色、字体与图标
03隐私与国际化原则
04动效及减少动态效果指导
05涵盖多类设计主题的参考索引

适用场景

01审查应用的视觉基础
02规划无障碍界面
03适配浅色与深色模式

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/raintree-technology/hig-doctor --skill hig-foundations

安装后在 Claude Code 中输入/hig-foundations确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/

accessibility.md

app-icons.md

branding.md

color.md

dark-mode.md

icons.md

images.md

immersive-experiences.md

inclusion.md

layout.md

materials.md

motion.md

privacy.md

right-to-left.md

sf-symbols.md

spatial-layout.md

typography.md

writing.md

详细介绍

Apple HIG：设计基础

在提问前先检查 .claude/apple-design-context.md。使用已有上下文，只询问尚未涵盖的信息。

核心原则

内容优先于装饰。 减少视觉杂乱。使用系统提供的材质和细微的分隔线，而不是厚重的边框和背景。
从一开始就内置无障碍支持。 从第一天起就为 VoiceOver、动态字体、减弱动态效果、增强对比度和切换控制进行设计。每个交互元素都需要一个无障碍标签。
使用系统颜色和材质。 系统颜色会适应浅色/深色模式、增强对比度和通透效果。优先使用语义化颜色（label、secondaryLabel、systemBackground），而不是硬编码的值。
使用平台字体和图标。 默认使用 SF Pro、SF Compact、SF Mono。衬线字体使用 New York。遵循推荐字号下的字体层级。图标使用 SF Symbols。
符合平台惯例。 使外观和行为与系统标准保持一致。为每个操作提供直接、响应灵敏的操作方式和清晰的反馈。
尊重隐私。 仅在需要时请求权限，清楚地解释原因，在索取数据之前先提供价值。以最小化数据收集为设计原则。
支持国际化。 适应文本扩展、从右到左的文字以及不同的日期/数字格式。使用 Auto Layout 实现动态内容尺寸调整。
有目的地使用动效。 动画应传达含义和空间关系。通过提供交叉淡化替代方案来遵循减弱动态效果设置。

参考索引

参考	主题	关键内容
accessibility.md	无障碍	VoiceOver、动态字体、色彩对比度、运动无障碍、切换控制、音频描述
app-icons.md	App 图标	图标网格、平台特定尺寸、单一视觉焦点、不使用透明度
branding.md	品牌	在 Apple 设计语言中融入品牌标识、克制的品牌呈现、自定义色调
color.md	颜色	系统颜色、动态颜色、语义颜色、自定义调色板、对比度
dark-mode.md	深色模式	抬升表面、语义颜色、适配调色板、通透感、在两种模式下测试
icons.md	图标	字形图标、SF Symbols 集成、自定义图标设计、图标字重、视觉对齐
images.md	图像	图像分辨率、@2x/@3x 资源、矢量资源、图像无障碍
immersive-experiences.md	沉浸式体验	AR/VR 设计、空间沉浸感、舒适区、渐进式沉浸层级
inclusion.md	包容性	多元化呈现、非性别化语言、文化敏感性、包容性默认设置
layout.md	布局	边距、间距、对齐、安全区域、自适应布局、可读内容参考线
materials.md	材质	通透感、模糊、半透明、系统材质、材质厚度
motion.md	动效	动画曲线、过渡、连续性、减弱动态效果支持、基于物理的动效
privacy.md	隐私	权限请求、用途描述、隐私营养标签、最少数据收集
right-to-left.md	从右到左	RTL 布局镜像、双向文本、需要翻转的图标、例外情况
sf-symbols.md	SF Symbols	符号类别、渲染模式、可变颜色、自定义符号、字重匹配
spatial-layout.md	空间布局	visionOS 窗口放置、深度、人体工学区域、Z 轴设计
typography.md	字体排印	SF Pro、动态字体尺寸、文本样式、自定义字体、字重层级、行距
writing.md	文案	UI 文案指南、语气、大小写规则、错误信息、按钮标签、简洁性

综合运用各项基础

思考各项原则如何相互作用：

颜色 + 深色模式 + 无障碍 -- 自定义调色板必须在两种模式下都可用，同时保持 WCAG 对比度。从系统语义颜色开始。
字体排印 + 无障碍 + 布局 -- 动态字体必须能够缩放而不破坏布局。使用文本样式和 Auto Layout 来支持全部字体尺寸范围。
图标 + 品牌 + SF Symbols -- 自定义图标应匹配 SF Symbols 的字重和视觉尺寸。品牌元素应融入其中，而不是覆盖系统惯例。
动效 + 无障碍 + 反馈 -- 每个动画都必须有减弱动态效果的替代方案。动效应强化空间关系，而非仅作装饰。
隐私 + 文案 + 引导 -- 权限请求需要清晰、具体的用途描述。将其安排在用户能够理解其好处的时候。

输出格式

引用具体的 HIG 基础，注明文件和章节。
说明平台差异，针对用户的目标平台。
提供具体的代码模式（SwiftUI/UIKit/AppKit）。
解释无障碍影响（对比度、动态字体缩放、VoiceOver 行为）。

要询问的问题

你面向哪些平台？
你是否已有品牌指南？
你希望达到什么无障碍级别？（WCAG AA、AAA、Apple 基准？）
使用系统颜色还是自定义颜色？