SuperAPI AI 工具集

figma-use

设计与创作

查看项目

更新于 10-16 03:05

技能介绍

用途:figma-use 是调用 use_figma 工具前必须加载的技能,用于通过 Figma Plugin API 在 Figma 文件中执行 JavaScript,完成节点创建、修改、查询等操作。

主要能力:提供 Plugin API 的规则与参考文档(references/ 目录),涵盖页面切换、文本编辑、变量、组件、设计系统等主题;支持 node.query() 的类 CSS 选择器搜索、node.set() 批量属性更新等高效 API;区分 Design、FigJam、Slides 三种编辑器模式下的可用节点类型与 API。

使用方式:每次调用 use_figma 时须在 skillNames 参数中包含 figma-use;若通过 MCP 资源加载,需加 resource: 前缀。代码使用顶层 await 与 return,返回值自动 JSON 序列化;不要调用 figma.closePlugin() 或包裹 async IIFE。切换页面用 await figma.setCurrentPageAsync(page),每次调用最多切换一次,多页任务应并行拆分为多个 use_figma 调用。文本编辑须先加载字体再修改。创建或修改节点后必须返回所有受影响的节点 ID。

适用场景:在 Figma 中构建或更新页面、屏幕、多区块布局,创建组件,处理设计系统、变量、文本样式等。若涉及整页构建还需加载 figma-generate-design,涉及组件创建还需加载 figma-generate-library。

限制:figma.notify() 不可用;console.log() 输出不会返回;颜色为 0–1 范围;fills/strokes 为只读数组需克隆后重新赋值;layoutSizing 与 AxisSizingMode 是不同枚举不可混用;figma.createPage() 仅 Design 文件可用;脚本出错时不会执行任何更改,需修正后重试。具体收费、价格等信息暂未提供。