SuperAPI AI 工具集

figma-use

设计与创作

查看项目

更新于 10-16 03:47

技能介绍

用途:figma-use 用于通过 Figma Plugin API 在 Figma 文件里执行 JavaScript,并规范调用 use_figma 的方式。资料强调在每次调用 use_figma 之前必须先加载本技能,且调用时要在 skillNames 参数中带上 figma-use(若通过 MCP resource 加载则写成 resource:figma-use)。该参数仅用于记录技能使用情况,不影响执行。

主要能力:可搜索与批量修改节点、创建节点与变量、编辑文本、切换页面、读取元数据等。资料推荐用 node.query(selector) 做类 CSS 选择器查询,用 node.set(props) 批量设置属性;处理设计系统时先读 working-with-design-systems/wwds.md。构建整页或多区块布局时另加载 figma-generate-design,创建组件时加载 figma-generate-library。写 API 代码前先加载 plugin-api-standalone.index.md,并按其指引检索 plugin-api-standalone.d.ts。

使用方式与要点:脚本用纯 JavaScript 顶层 await 与 return,返回值会自动 JSON 序列化,不要用 figma.closePlugin() 或自包 async IIFE;console.log() 不会返回,必须用 return,且所有创建或修改的节点 ID 都要返回。颜色取值为 0–1。编辑文本遵循“加载字体→await→修改→返回节点 ID”流程,须加载节点当前字体而非硬编码默认字体。切页用 await figma.setCurrentPageAsync(page),同步 setter 不可用,且每次调用最多切页一次,多页任务并行拆分为多次调用。单步小批量操作并逐步验证。

限制:use_figma 默认用于 Design 模式;FigJam 与 Slides 可用节点类型不同,figma.createPage() 仅在 Design 文件可用。figma.notify() 会抛出“not implemented”。出错时依据 safeToRetryWithoutCanvasRead 决定是否直接重试。其余细节资料未提供。