SuperAPI AI 工具集

token-lint

前端与建站

查看项目

更新于 10-15 21:54

技能介绍

用途:在把 Figma 设计转成代码后,检查所有 var(--vapor-...) 引用是否指向真实存在的 vapor 设计令牌,主要捕捉转录过程中的拼写错误。它假定 Figma 侧的语义检查已完成,不判断令牌是否在语义上合适。

主要能力:脚本 scripts/lint.mjs 从 assets/ 的 DTCG JSON 快照构建正式 CSS 变量名集合;遍历目标路径,筛选 .css/.scss/.sass/.less/.ts/.tsx/.js/.jsx 文件,跳过 node_modules、dist、build、.next、.turbo、coverage、.git、.venv、pycache、.cache、out;用正则提取 var(--vapor-...) 引用(支持多行调用,不把未闭合的字符串前缀当作引用);对未注册名称用分段对齐的 Damerau-Levenshtein 给出最多 3 个候选,并标注距离提示;输出按用例分块,末尾附汇总行。无论是否发现错误均 exit 0,调用错误才 exit 2。

使用方式:node <skill-dir>/scripts/lint.mjs <path>。<skill-dir> 为技能 base directory 的绝对路径,不要硬编码;<path> 可为目录或单文件,直接使用用户给出的路径,不要 cd。执行后原样输出 stdout,不要改写、重排或加解释。

适用场景:设计令牌刚落地到代码、需要快速排查 --vapor- 拼写错误时。

限制:基于整文件正则扫描、冻结的目录快照和分段对齐编辑距离,因此干净退出不代表全部正确。若涉及动态拼接令牌名、helper 组装、用户自定义 --vapor- 前缀扩展,或需要类型适配性与废弃令牌检测,应参考 references/limitations.md 的对应说明。其余事实资料未提供。