SuperAPI AI 工具集

design-tokens

设计与创作

查看项目

更新于 10-16 09:56

技能介绍

用途:在设计系统从零建立、多产品或多品牌保持一致、设计与代码共用单一数据源、主题切换(暗黑模式、品牌切换)等场景下,建立设计令牌(Design Tokens)体系。核心思路是把颜色、字体、间距、圆角、阴影、动效时长等设计决策写成 JSON,设计工具与代码读取同一份数据,改一处即可全产品同步。

主要能力:采用三层 Token 架构。全局 Token(Global/Primitive)存原始值,不带语义;语义 Token(Semantic/Alias)按用途命名并引用全局 Token;组件 Token(Component)供具体组件使用,引用语义 Token。命名遵循 DTCG 规范,格式为 [类别].[属性].[变体].[状态],如 color.text.primary、color.bg.surface.hover、button.primary.bg。覆盖颜色、间距、字体、圆角、阴影等最小 Token 集,并提供基础 Token 与暗黑模式扩展的配套模板。

使用方式:流程为收集设计需求,设计全局 Token,提炼语义 Token,为高频组件创建组件 Token,输出 JSON,同步到设计工具(如 Figma Variables),再在代码中实现(如 Tailwind config 或 CSS variables)。质量自检包括是否分三层、命名是否符合 DTCG、语义 Token 是否引用全局 Token、是否覆盖全部设计原语、是否考虑主题切换。可与视觉风格、原子设计、响应式设计等协作,输出 JSON 交给前端设计交付环节。

限制与常见坑:不要在组件中直接使用原始值;避免命名不一致(如 color.primary 与 color.brand.primary 混用);不要缺失语义层,直接用 color.blue.500 代替 color.text.link;避免 Token 只存在于设计工具导致代码不可用;避免手动维护造成设计改动与代码不同步。具体安装命令与收费信息暂未提供。