SuperAPI AI 工具集

manage-variables-figma

设计与创作

查看项目

更新于 10-16 01:49

技能介绍

用途:对 Figma 变量系统做增量、精细的编辑,包括创建单个或多个变量、批量更新值、重命名、设置作用域与代码语法、添加或重命名模式以及删除,均通过 use_figma 执行,适用于任意套餐。

主要能力:变量、集合、模式的增删改查;批量创建与批量更新(scripts/batch-update-variables.js 比逐值调用快 10–50 倍);设置作用域;设置代码语法(setVariableCodeSyntax('WEB', '--token-name'));通过 createVariableAlias 建立变量别名绑定。

使用方式:先加载官方 figma-use 技能作为 Figma Plugin API 参考。脚本需用普通 JS,顶层 await 加 return,不用 IIFE,不调用 figma.closePlugin(),console.log 不会返回;输入以 const 内联在脚本顶部;颜色为 0–1 范围,十六进制输入用 hexToRgb;文本操作前先加载字体;用 await figma.getNodeByIdAsync(...);脚本出错为原子性,失败不应用任何更改,读错误后修正重试。多数操作需要 ID,可从 export-tokens-figma 读取脚本或 get_variable_defs 获取 variableId、modeId、collectionId,集合也可在脚本内按名称查找。操作清单见 references/variable-ops.md,含每个操作的完整可复制 use_figma 片段。运行方式为 use_figma(skillNames: "manage-variables-figma")。完成后用 get_variable_defs 读回验证。

适用场景:需要以脚本方式批量维护设计令牌、统一设计到代码命名、调整变量作用域或模式时。

限制:删除具有破坏性,删除集合会同时删除其全部变量并解绑所有引用,删除前需与用户确认;重命名安全,会保留值与已有绑定;新建变量务必设置作用域,默认 ALL_SCOPES 会污染所有选择器。从零搭建请用 setup-design-tokens-figma,代码同步请用 import-tokens-figma / export-tokens-figma。