用途:figma-use 用于在 Figma 文件中通过 Plugin API 执行 JavaScript(use_figma 工具)时提供规则与参考。资料要求每次调用 use_figma 前必须先加载本技能,且调用时始终传入 skillNames: "figma-use"(仅用于记录使用情况,不影响执行)。若任务涉及从代码构建或更新整页、整屏或多区块布局,还需加载 figma-generate-design 配合使用。
主要能力与参考文档:详细文档位于 references/。先加载 plugin-api-standalone.index.md 了解 API 范围,再按需 grep plugin-api-standalone.d.ts 查找类型与方法。涉及设计系统时先读 working-with-design-systems/wwds.md。其他文档包括 gotchas.md、common-patterns.md、plugin-api-patterns.md、api-reference.md、validation-and-recovery.md、component-patterns.md、variable-patterns.md、text-style-patterns.md、effect-style-patterns.md。
必要用法与限制:用 return 返回数据(自动 JSON 序列化),不要用 figma.closePlugin() 或 async IIFE 包裹;代码自动置于 async 上下文,可用顶层 await。figma.notify() 会抛错;getPluginData()/setPluginData() 不受支持,改用 getSharedPluginData()/setSharedPluginData();console.log() 不会返回。颜色为 0–1 范围;fills/strokes 为只读数组,需克隆后重新赋值;文本操作前必须 await figma.loadFontAsync({family, style}),可用 await figma.listAvailableFontsAsync() 发现字体。切换页面须用 await figma.setCurrentPageAsync(page),同步写法 figma.currentPage = page 会抛错;每次调用开始时页面上下文重置到第一页。layoutSizing 的 'FILL'/'HUG' 须在 appendChild 之后设置;新建顶层节点应避开 (0,0)。脚本失败为原子操作,不会产生部分修改;出错应停止、读错误、修复后再试。每个创建或修改节点的脚本必须返回所有受影响节点 ID,如 return { createdNodeIds: [...], mutatedNodeIds: [...] }。创建变量时须显式设置 variable.scopes。所有 Promise 都必须 await。建议小步增量执行并用 get_metadata、get_screenshot 验证。
适用场景:在 Figma 设计模式下批量创建或修改节点、变量、组件、文本样式、效果样式,以及按增量流程搭建界面;FigJam 模式受限于不同节点类型。资料未提供定价、平台或性能等更多信息。