SuperAPI AI 工具集

token-architecture

设计与创作

查看项目

更新于 10-16 03:14

技能介绍

用途:设计令牌是视觉决策的单一事实来源,连接设计意图与代码。本技能用于规范令牌的命名、分层与分发。适用时机包括:启动新设计系统;design-system-alignment 发现不一致时;新增主题(深色模式、品牌变体)时;需要跨 Web、iOS、Android 交付时。

三层模型:第一层全局令牌是原始值,按“是什么”而非“做什么”命名,例如 --color-green-500: #2D6B4F、--space-4: 16px、--radius-md: 12px,这些不出现在组件 CSS 中。第二层语义令牌把全局令牌映射到角色,按用途命名,例如 --color-surface: var(--color-green-100)、--color-text-primary: var(--color-green-900)、--color-accent: var(--color-green-500);主题化在此发生,深色模式替换的是语义映射而非全局值。第三层组件令牌把语义令牌映射到组件上下文,如 --button-bg: var(--color-accent)、--card-bg: var(--color-surface),可选但在规模较大时很有价值。

命名规范:--{category}-{property}-{variant}-{state},类别包括 color、space、font、radius、shadow、motion;名称中不得使用十六进制值或含糊缩写。

主题化:深色模式是语义令牌的重新映射,例如 [data-theme="dark"] 下把 --color-surface 指向 --color-grey-900、--color-text-primary 指向 --color-grey-100;全局令牌不变,语义令牌替换,组件令牌继承。

无障碍:前景/背景必须成对定义并验证 AA 对比度;动效令牌必须包含 --motion-duration-none: 0ms 以支持 reduced-motion。

交付物:包含全部三层的令牌文件(CSS 自定义属性、JSON 或两者)、命名规范文档、适用时的主题变体。本技能受 design-lead、ui-composition 影响,并输出给 design-builder、design-system-alignment。安装命令与具体平台实现细节暂未提供。