用途:从 component-contracts 的 token 文件构建或更新 Figma 变量集,生成 Primitives(原始值)与 Semantic(语义别名)两个集合,供组件绑定。
主要能力:读取 W3C DTCG 格式 token 文件(primitive 下含 color、motion、shape、space、typography,semantic 含 semantic.tokens.json);按 / 分组命名变量;按语义角色分配 VariableScope(禁止 ALL_SCOPES);为每个变量设置 WEB code syntax(var(--ds-...) 形式);Semantic 变量通过 createVariableAlias 引用 Primitives。
必要用法:先读取项目根目录 .component-contracts 获取 FIGMA_ACCESS_TOKEN、FIGMA_FILE_KEY、TOKENS_DIR、CONTRACTS_DIR,切勿输出令牌值;缺少该文件时提示用户复制示例文件填写。调用 use_figma 时传入 skillNames: "cc-figma-tokens",并先加载 figma-use 与 figma-generate-library。默认模式下展示 Phase 0 计划待批准后顺序执行 Phase 1–4;含“debug mode”时逐阶段等待确认。每个集合的所有变量须在单次 use_figma 调用中批量创建,超过约 80 个变量时按类别拆分。
适用场景:需要在 Figma 中建立设计令牌体系并与组件契约同步时。
限制:图中字母间距无法存为变量,仅能通过文本样式处理;HORIZONTAL_PADDING 与 VERTICAL_PADDING 非合法 Scope,间距统一用 GAP;须使用 setSharedPluginData/getSharedPluginData 且命名空间为 component_contracts;链式别名创建顺序有要求;创建集合后会产生 ghost mode,需执行 Phase 3 显式模式分配。更新已有集合时不得未经确认删除变量。