用途：读取 Figma 文件中的本地变量，输出设计令牌文件。规范输出为 DTCG（W3C Design Tokens Community Group JSON），CSS、Tailwind、SCSS、TS、JSON 等格式均由其派生。相比直接调用 REST API，它通过 Plugin API 的 use_figma 读取，可在所有 Figma 计划上使用，并能解析别名和多模式值。
主要能力：运行 scripts/read-variables.js 得到规范化的 collections/modes/variables 树，包含十六进制颜色、已解析的别名引用、scopes 和 code syntax。随后用 scripts/convert-tokens.mjs 进行确定性转换。
使用方式：先确认目标格式（默认 dtcg）、是否按模式/集合拆分、输出路径与文件 key。将读取结果保存为 variables.json，再执行：node scripts/convert-tokens.mjs variables.json --format dtcg --out tokens/。--format 可取 dtcg（默认）、css-vars、tailwind-v4、tailwind-v3、scss、ts-module、json-flat、json-nested、style-dictionary-v3、tokens-studio；--out 指定目录，省略则打印到 stdout；还可使用 --prefix、--modes、--collection。
限制：read-variables.js 需通过 use_figma 运行，且应先加载官方 figma-use 技能。convert-tokens.mjs 需要 Node 18+ 和终端环境（如 Claude Code、Codex、Cursor 等）；在无 shell 的桌面/网页聊天中需自行运行或仅接受 DTCG 的内联转换。style-dictionary-v3 与 tailwind-v3 仅用主模式。大型系统建议先按集合名限定读取范围。跨集合别名需一起导出才能解析。反方向（代码 → Figma 变量）应使用 import-tokens-figma 技能。