setup-design-tokens-figma

setup-design-tokens-figma — 原子化令牌系统初始化

在一次 use_figma 调用中创建变量集合、模式和所有变量。这是搭建新令牌系统（或在现有系统中创建新集合）最快的方式。由于它作为一个原子脚本运行，要么全部创建成功，要么什么都不创建（脚本失败时不会应用任何更改）。

技能边界

• use_figma 规则——首先加载官方 figma-use 技能；它是完整的 Figma Plugin API 参考。这些脚本依赖的要点：使用带顶层 await 和 return 的纯 JS（不要用 IIFE 或 figma.closePlugin()；console.log 不会作为返回值返回），在每个脚本顶部以内联 const 声明输入，颜色值范围为 0–1，在任何文本操作前加载字体，使用 await figma.getNodeByIdAsync(...)，以及原子错误处理（脚本失败时不会应用任何更改——读取错误、修复并重试）。
• 对现有系统进行增量 CRUD／批量编辑 → manage-variables-figma。
• 从代码令牌文件同步 → import-tokens-figma。

工作流

1. 确定 v1 范围。 列出集合名称、模式（第一个为默认模式），以及包含各模式对应值的完整令牌集。编写前先敲定这些内容——之后再编辑成本会高得多。
2. 在 scripts/setup-tokens.js 中填写常量：COLLECTION_NAME、MODES、TOKENS（按模式名称指定值），以及可选的每个变量对应的 SCOPES。
3. 通过 use_figma 运行（skillNames: "setup-design-tokens-figma"）。它会返回 { collectionId, modes, created, errors }。
4. 使用 get_variable_defs 或 export-tokens-figma 读取脚本进行验证；如果还创建了色板，则截图确认。

注意事项

• 双层系统：使用此技能创建原始令牌（原始值），然后使用 import-tokens-figma（包含别名处理步骤）或 manage-variables-figma 创建指向它们的语义令牌。原始令牌应仅使用单一模式，将主题设置放在语义层。
• 设置作用范围：默认的 ALL_SCOPES 会让每个属性选择器都变得杂乱。为每个令牌所属的界面元素传入 SCOPES（背景使用 FRAME_FILL／SHAPE_FILL，文本使用 TEXT_FILL，间距使用 GAP，圆角使用 CORNER_RADIUS，尺寸使用 WIDTH_HEIGHT）。
• 每个集合只进行一次初始化。多个集合需要多次运行。