用途:帮助建立一致、可维护、可扩展的 UI 基础,适用于 Web 与移动端的设计系统建设。
主要能力: 1)设计令牌:分层为原始令牌(原始色值、尺寸、字体)、语义令牌(text-primary、surface-elevated 等上下文语义)、组件令牌(button-bg、card-border 等具体用途);包含命名约定、组织方式与多平台令牌生成(CSS、iOS、Android)。 2)主题基础设施:CSS 自定义属性架构、React 主题上下文 Provider、动态主题切换、系统偏好检测(prefers-color-scheme)、主题持久化存储,以及减少动画和高对比度模式。 3)组件架构:复合组件模式、多态组件(as prop)、变体与尺寸系统、基于插槽的组合、无头 UI 模式、样式属性与响应式变体。 4)令牌流水线:Figma 到代码同步、Style Dictionary 配置、令牌转换与格式化、CI/CD 集成。
使用方式:资料给出令牌三层结构示例(原始、语义、组件),React ThemeProvider 与 useTheme 的主题切换实现,基于 class-variance-authority 的变体按钮,以及 Style Dictionary 输出 CSS/SCSS/iOS/Android 的配置。最佳实践包括按用途命名令牌(text-primary 而非 dark-gray)、保持原始>语义>组件的层级、记录令牌用法、用 semver 对令牌变更做版本管理、测试主题与组件组合、自动化 Figma 到代码的流水线、为废弃令牌提供迁移路径。
适用场景:创建设计令牌、实现明暗主题切换、构建多品牌主题、设计组件库 API、建立 Figma 令牌到代码的工作流、定义语义令牌层级、编写设计系统文档与规范。
常见问题:令牌泛滥缺乏层级、命名不一致(camelCase 与 kebab-case 混用)、缺失暗色模式适配、硬编码值代替令牌、循环引用、部分平台缺少令牌。
限制:资料未提供该技能的安装命令、收费方式、支持平台或版本信息,暂未提供相关内容。