用途:为设计系统定义“命名值”及其命名语法,包括基础尺度(primitive)、其上的语义层(semantic)、主题化与项目实际消费的导出格式。它决定值叫什么、放在哪里,不决定美学表达。
主要能力:覆盖颜色、间距、字体、圆角、阴影/高度等尺度的生成规则;语义角色目录与交换格式;暗色模式、高对比度与多品牌主题(主题重映射语义,绝不反转 primitive);CSS、Tailwind、Style Dictionary、Swift、Kotlin 等导出目标;已有代码库迁移到令牌或退役旧值。
使用方式:工作分阶段 AUDIT → GRAMMAR → PRIMITIVES → SEMANTICS → THEMES → EXPORT。开始前先统计现有硬编码值数量,并寻找仓库中已有语法(若已有则优先沿用);按 T0/T1/T2 规模判断流程,T0 无需 brief/交接。需求形状不唯一、含无达成条件的词(如 modern、premium)或替换用户已选之物时,先对话并确定“standard”,excludes 不得为空,open_questions 为空才执行。每个字面值必须注明依据:token、threshold、measured、derived、platform、brief 之一;无依据记为 ARBITRARY 并在交接中命名。
限制与规则:始终三级 primitive→semantic→component,组件只消费语义;语义按职责命名而非外观;每个承载文本的语义对记录计算出的对比度;被替换令牌给出弃用路径而非静默改名。绝不按色相命名语义令牌、不在两个层级各存一份值、不反转浅色调色板生成暗色模式、不用内联值或 !important 补缺失令牌、不发布对比度不达标的令牌。验证按比例计算与主题解析,覆盖需计数(发现、覆盖、退役三者相加);结论标注 measured/inspected/asserted,无法测量的值估算属 asserted。完成后输出一句话状态与残余项。当前资料未提供具体版本、价格、依赖安装命令或官方仓库地址等细节。