SuperAPI AI 工具集

figma-use

设计与创作

查看项目

更新于 10-16 07:17

技能介绍

用途:figma-use 规定在每次调用 use_figma 之前必须先加载本技能,禁止直接调用 use_figma。它提供通过 Figma Plugin API 在文件中执行 JavaScript 的规则与约束。

主要能力与用法:调用 use_figma 时始终传入 skillNames: "figma-use"(仅用于记录技能使用,不影响执行)。如需从代码构建或更新整页、屏幕或多区块布局,应同时加载 figma-generate-design,二者配合使用。开始前先加载 plugin-api-standalone.index.md;编写插件 API 代码时用 plugin-api-standalone.d.ts 检索类型与方法,不要一次性加载全部。涉及设计系统时先从 working-with-design-systems/wwds.md 入手。

核心规则:用 return 返回数据(自动 JSON 序列化),不要用 figma.closePlugin() 或 async IIFE;代码自动包裹为异步上下文,可使用顶层 await;禁用 figma.notify();不支持 getPluginData()/setPluginData(),改用 getSharedPluginData()/setSharedPluginData() 或返回节点 ID;console.log() 不会返回。颜色为 0–1 范围;fills/strokes 为只读数组,需克隆后重新赋值;文本操作前必须先 await figma.loadFontAsync。切换页面用 await figma.setCurrentPageAsync(page),同步设置器会报错。layoutSizing 设 'FILL' 必须在 appendChild 之后。新建变量时显式设置 scopes。所有 Promise 都要 await。

建议增量工作:先只读检查文件,每次调用只做一件事,返回全部创建/修改的节点 ID,逐步验证。脚本是原子的,出错即完全不执行,修复后再重试。

限制:仅支持设计模式(editorType "figma"),FigJam 中多数设计节点被禁用。文档中未提供收费、价格或平台信息。