用途:在 Figma 设计稿中提取元素使用了哪些 vapor 令牌,并验证其使用是否恰当。当出现 Figma URL 且涉及令牌、颜色、字体、样式使用的问题时使用。
主要能力:验证分四轴。1) raw/绑定:boundVariables 为空即未绑定,判为 high。2) 语义含义:do-not-use、schema 键缺失(拼写错误或未注册)、role 不匹配判为 high;结合 when/avoid 判断上下文适配性(如 danger 与 success 误用)。3) 排版层级:Text Style 未绑定(appliedStatus==='raw')判为 high;正文误用 heading、层级颠倒。4) 背景-前景搭配:前景 gradeRules 中 fg-100 用于非纯白背景判为 high,背景不明确判为 info。不计算 WCAG 明度比,仅按背景为纯白(#ffffff)/透明/其他三分法判断。
使用方式:先确认 Figma MCP 已连接,调用 get_metadata 轻量验证,失败则提示“Figma MCP가 연결돼 있지 않습니다. 연결 후 다시 시도해 주세요.”并中止。输入格式为 /figma-token-review {Figma URL},从 URL 提取 fileKey、nodeId,将 node-id 的 - 转为 :(如 32842-2107 → 32842:2107)。可选指定“仅颜色”“仅 typography”“仅字体”模式,未指定则两者都查。URL 后的自然语言为设计意图,有意图则据此判断,无意图则用截图与节点推断角色,并在报告头部标注“의도 미제공 → 역할 추론(신뢰도 낮음)”。执行分四步:加载 /figma-use 后读取 scripts/extract.figma.js,仅替换 ROOT_ID、MODE 常量,以只读方式传给 use_figma,禁止即席重写逻辑;将返回对象写入文件(如 /tmp/token-review-extract.json);运行 node scripts/evaluate.mjs <추출파일> 做颜色确定性检查,运行 node scripts/typography-evaluate.mjs <추출파일> 做排版检查;再以脚本输出的 rubric 子集做语义判定,输出 PASS/FAIL、confidence 与依据,低置信度标为“需复核”。get_screenshot 仅在 typography 模式或需推断角色时调用。
适用场景:设计稿令牌合规审查、颜色与字体使用检查、设计系统一致性验证。
限制:背景识别存在确定性局限,不计算 WCAG 对比度,不支持 CI,LLM 判定具非确定性,详见 references/limitations.md;未检查项不应误认为通过。无版本管理,schema 仅保留“当前”一套。