token-mapping 是一个设计 token 映射检查技能,用于报告页面、文件或 diff 中的硬编码样式值(如十六进制颜色、像素值、阴影)如何对应到项目已有的设计 token 列表,判断顺序为先用途、后数值。
主要能力:加载映射规则、AGENTS.md 或 CLAUDE.md、决策文档;读取 token 列表并记录其名称、格式、位置、读取方式与时间;将别名解析为各模式下的最终值;按属性逐行收集位置、类别与用途;对两侧做归一化(颜色用代码转换);分类候选 token,语义 token 优先于原始 token,每行每模式一个类别并附原因与数值差异;统计并给出差距阈值、按角色的 Consistency、Summary 与 Source。
使用方式:从请求给出的线索出发,例如“检查设置页的 token”即可,自行查找数值与列表。默认值来源依次为指定对象、分支 diff、产品代码;模式取列表默认模式;rem 根值默认 16px。输出为七部分:Summary、Mapping、Do not use、Ambiguous、Gaps、For a person to decide、Source。直接运行时聊天回复给出 Summary 答案及数值、各命令退出码、最多三个带默认值的问题,以及 Next 提示。
限制:不得使用未在已读取列表中出现的 token 名;差距不得新建名称;不得先按数值匹配再考虑用途;语义 token 可覆盖时不得用原始 token;读取失败后不得凭记忆填写;不得用公共系统(含 Geist)的 token 名代替团队列表;不得修改仓库。遇到无列表、同一模式一名两值、两来源冲突且无优先级规则时停止并报告。无 token 集时返回构建 token 的基础工作。