用途:针对以 Figma 变量为令牌唯一来源的团队,审计变量集合是否符合三层令牌架构(基础层编码原始值、语义层表达意图、组件层映射到具体 UI 场景),产出结构化报告与按优先级排列的整改清单。
主要能力:
- 层级映射:将各变量集合归入基础、语义、组件层,标记无法归类和混合层级的集合。
- 命名审计:检查分层命名(Figma 用 / 分组,对应代码中的 .)、语义层意图命名、保留词、命名一致性与歧义,并给出重命名建议。
- 别名链审计:检查引用方向(组件应引用语义而非直接引用基础层)、语义到语义跳转、向上引用、链长(超过 3 跳标记)及断链。
- 模式与主题覆盖:列出集合的全部模式,识别非默认模式中取值与默认模式相同的语义和组件变量。
- 与代码令牌交叉比对(如配置了代码令牌来源):名称归一化后比对、值对齐、覆盖缺口。
- 孤立变量与重复值:基于依赖与使用信息识别无消费者变量、重复值与样式重叠。
- DTCG 2025.10 就绪评估:类型推导、复合类型、resolver 导出与迁移工作量。
使用方式:确认 frontmatter 中 references 路径存在,否则安装可能不完整,应按 1-INSTALL.md 重装并运行 verify-install.sh。存在 .ds-ops-config.yml 时读取 severity、integrations.figma、integrations.code_tokens、recurring 配置。先检查 Figma 访问能力:官方 Figma MCP 只能读取选中节点的变量,无法列出整个集合;Figma REST Variables API 仅限 Enterprise;完整审计需要 Figma Console MCP(Desktop Bridge 插件)。随后提供文件 URL、file key 或 node ID,分批读取变量(summary 获取清单,filtered 分页读取并保留变量 id,孤立变量分析需 enrich、include_usage、include_dependencies 标志),再逐步执行层级映射、命名、别名链、模式、代码比对、孤立与重复、DTCG 就绪检查,最后输出报告。可原地修复需 Figma Console MCP。
适用场景:设计系统团队、变量库维护者、准备 DTCG 迁移的团队。
限制:无法读取集合时不得静默失败或循环重试,应说明并给出替代方案(导出变量 JSON 或改用代码令牌审计);published library 的孤立变量只能说“本文件内无消费者”,除非检查了其他消费文件或库分析;官方 Figma MCP 与非 Enterprise 计划下审计不完整。价格、平台支持范围等资料暂未提供。