用途:figma-use 是配合 use_figma MCP 使用的技能,用于在 Figma 文件中通过 Plugin API 执行 JavaScript,完成节点创建、变量与组件构建、页面布局等操作。调用 use_figma 前必须先加载本技能,且每次调用都要传入 skillNames: "figma-use"(仅用于记录技能使用情况,不影响执行)。若任务涉及从代码构建或更新整页、屏幕或多区块布局,还需同时加载 figma-generate-design。
主要能力与用法:代码使用顶层 await 与 return,返回值会自动 JSON 序列化;不要调用 figma.closePlugin(),也不要包 async IIFE。输出用 return,console.log 不会返回。颜色为 0–1 范围;fills/strokes 为只读数组,需克隆后重新赋值。文本操作前必须 await figma.loadFontAsync。切换页面用 await figma.setCurrentPageAsync(page),同步 setter 会报错。layoutSizing 的 FILL 必须在 appendChild 之后设置。创建变量时应显式设置 scopes。所有 Promise 都要 await。每个创建或修改节点的脚本都必须返回全部受影响的节点 ID。
限制与注意:figma.notify() 会抛“not implemented”,不可使用;getPluginData()/setPluginData() 不支持,改用 getSharedPluginData()/setSharedPluginData()。use_figma 出错时脚本是原子的,不会执行,应先读错误再修复重试。页面上下文在每次调用间重置。建议先只读检查文件,再小步增量执行并逐步验证。详细参考文档位于 references/ 目录,可按需加载。
适用场景:在 Figma 设计模式(editorType "figma")中编写 Plugin API 代码、管理变量与组件、组装布局。FigJam 模式多数设计节点不可用。具体收费、价格与平台信息暂未提供。