统一设计令牌系统
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/design-tokens。
技能介绍
多端设计变量失同步的痛点
在跨平台项目开发中,设计师与开发者常常面临变量管理混乱的问题。直接在代码中硬编码色值、字号等样式属性,会导致主题切换(如暗色模式)成本高昂,且 iOS、Android 和 Web 端难以保持视觉一致性。当设计规范发生调整时,开发者需要在多个代码库中手动查找并替换,极易引入视觉回归缺陷。
结构化的 Token 工作流
该技能通过标准化的设计令牌(Design Tokens)工作流来解决上述问题。其核心步骤包括:
- 定义 Token 层级:将令牌分为 Tier1 原子层(如
color-blue-500)、Tier2 语义层(如color-bg-primary)和 Tier3 组件层(如button-bg-primary)。 - 规范命名:采用
{category}-{property}-{variant}的结构化命名约定,确保团队理解一致。 - 多平台输出:将统一的令牌源文件转换为
CSS、SCSS、JSON、AndroidXML以及 iOSSwift等各端可用的格式。 - 暗色模式映射:建立明暗主题的语义映射关系,实现一键切换主题。
适用边界与落地建议
该技能主要提供体系化的分析与模板指导,输出结构化的报告和可执行步骤。它适用于需要建立或重构设计令牌系统的项目。需要注意的是,它不适用于超出设计变量管理范围的场景,实际落地时仍需结合具体的业务约束和现有的前端架构进行调整。
使用场景
- 跨 Web、iOS、Android 三端交付时,需要统一管理颜色与字号,避免各端硬编码导致样式不一致。
- 产品要上线暗色模式,需要将现有语义化颜色令牌映射到深色主题并保证各端同步。
- 团队准备重构设计变量,需要一套命名规范与分层模板,把原子令牌升级到组件令牌。
- 设计规范调整后,需要批量更新各平台代码中的样式值,减少人工查找和替换的工作量。
适合人员
- 前端工程师,需要在 Web 项目中落地结构化的 CSS/SCSS 变量体系,替代散落的硬编码样式。
- 移动端开发者,同时维护 Android XML 和 iOS Swift 两套样式,希望统一令牌源避免两端不一致。
- 设计系统负责人,负责制定团队的 Token 分层与命名规范,需要可直接套用的模板和清单。
- UI 设计师,与开发协作交付设计变量,希望明确原子、语义、组件三层的输出物与映射关系。