用途:校验设计 token 文件是否符合其声称的结构格式,尽早发现会导致构建失败、静默失效或输出错误的结构问题。不评估命名质量、token 架构或代码中的使用情况。
主要能力:按目标格式逐项检查。DTCG 2025.10 检查 $value 与 $type 可解析、13 种合法类型、别名 {group.token} 语法与目标存在性、无循环别名、六种复合 token 结构、2025.10 中 color/dimension/duration 的对象值形态与单位、非规范属性不得用 $ 前缀、命名规则、$deprecated 等;对 *.resolver.json 校验 version 为 "2025.10"、sets/modifiers/contexts、default、resolutionOrder 及别名解析顺序。Style Dictionary v3 检查 value、引用语法与保留属性;v4/v5 校验 DTCG 兼容与格式一致性;Tokens Studio 检查分组层级、类型集合、数学表达式、引用语法与主题映射。支持跨格式一致性检查与迁移就绪度。
使用方式:先确认文件路径、目标格式与严格度(strict/lenient),再解析盘点,按格式校验,输出报告。仓库已有工具优先运行:Style Dictionary 用 npx style-dictionary build --config [path],Terrazzo 用 npx terrazzo lint 和 npx terrazzo build;技能自身检查与工具报错分别标注来源。可按需输出机器可读 JSON 结果。
适用场景:token 文件进入构建管线前的结构防线,格式迁移(如 v3 到 DTCG)期间的合规核查,多格式并存系统的盘点。
限制:仅做结构校验;格式不可识别时需用户先确认;未提供 token 文件则无法校验;自定义 schema 需用户给出 schema 或结构描述。资料未提供收费、价格、平台支持等信息。