SuperAPI AI 工具集

figma-use

设计与创作

查看项目

更新于 10-16 05:46

技能介绍

用途:figma-use 是配合 Figma MCP 服务器使用的技能,用于通过 Figma Plugin API 在 Figma 文件中执行 JavaScript,实现读取与修改设计内容。资料强调它是调用 use_figma 工具前的强制前置技能,不应在未加载本技能的情况下直接调用 use_figma。

主要能力:提供 Plugin API 的使用规则与参考文档索引,涵盖节点创建与修改、文本编辑、变量与作用域、组件属性、页面切换、自动布局、颜色与填充等。详细参考文档位于 references/ 目录,包括 plugin-api-standalone.index.md 与 plugin-api-standalone.d.ts(API 类型定义的权威来源,建议按需 grep 而非整体加载)。涉及设计系统时,应先阅读 working-with-design-systems/wwds.md。

使用方式:调用 use_figma 时在逗号分隔的 skillNames 参数中始终包含 figma-use;若通过 MCP 资源加载,需加 resource: 前缀(如 resource:figma-use)。该参数仅用于记录技能使用情况,不影响执行。若 Figma MCP 工具为延迟工具,可用 ToolSearch 的 select: 语法一次性批量加载其 schema。脚本使用顶层 await 与 return,返回值会自动 JSON 序列化;不要调用 figma.closePlugin() 或包裹 async IIFE,不要使用 figma.notify(),console.log() 不会返回。

适用场景与限制:适用于设计模式(editorType 为 figma)下的 Figma 文件操作;FigJam 与 Slides 可用节点类型不同,figma.createPage() 仅在 Design 文件中可用。可见设计变更前需同时加载 figma-generate-design;可复用库资产需加载 figma-generate-library;只读调用无需这两个技能。每次调用页面上下文会重置,多页任务应拆分为并行调用。颜色为 0–1 范围,填充与描边为只读数组需克隆后重新赋值。文本编辑须先加载字体。具体收费、价格与平台信息暂未提供。