Figma Use 技能(use_figma)
每次写入 Figma 背后的基础技能:智能体通过 use_figma 在你的文件中运行 Plugin API 脚本时遵循的规则。
官方 · Figma| 作者 | Figma |
|---|---|
| 许可证 | No licence file; Figma Developer Terms apply |
| 来源 | figma/mcp-server-guide · GitHub 上的 SKILL.md |
| 项目官网 | developers.figma.com/docs/figma-mcp-server |
| 适用于 | Claude Code · Codex、Gemini CLI、Cursor、Copilot |
| 读取源文件日期 |
figma-use 技能是 Figma 官方为其 use_figma MCP 工具提供的基础技能(Skill)。use_figma 让 AI 智能体在你的文件中针对 Figma Plugin API 运行 JavaScript:创建和编辑框架、文本、自动布局、组件、变量和样式,或检查文件的结构。Figma 将它标为必需的前提:智能体在每次调用 use_figma 之前都会先加载它。
它是一本规则手册,而不是一套工作流程。它列出会导致画布脚本失败的错误(字体未加载、颜色用了 0–255 的取值、切换页面的方式不对、忘记返回节点 ID)以及避免方法,并指向建立在它之上的任务型技能:figma-generate-design 用于界面,figma-generate-library 用于设计系统资源,figma-use-motion 用于动画。它需要远程 Figma MCP 服务器和一个 Figma 账号。
摘自该技能的 SKILL.md: Use the `use_figma` tool to execute JavaScript in Figma files via the Plugin API.
功能
- 为每个 use_figma 脚本定下基本规则:使用支持顶层 await 的普通 JavaScript,结果用 return 返回(console.log 的输出看不到),并返回每个创建或修改过的节点 ID,以便后续调用找到它们。
- 防止常见的失败:编辑任何文本前先加载字体,颜色用 0–1 的取值,填充和描边以新数组重新赋值,节点加入父级之后才设置自动布局尺寸,新的顶层框架放在远离原点的位置。
- 说明页面的处理方式(每个脚本最多切换一次页面,多页面工作拆成并行调用),以及 Figma Design、FigJam 和 Slides 文件之间的差异。
- 告诉智能体该加载哪个配套技能:任何可见的设计改动用 figma-generate-design,可复用的组件和 token 用 figma-generate-library,透视和倾斜效果用 3D 变换技能。
- 用专门的参考文档覆盖设计系统工作(组件、变量、文本样式和效果样式),并通过先返回 ID 和数量来控制大规模读取的体量。
- 规定错误恢复方式:失败的脚本能否安全重试,还是智能体必须先读取画布、弄清哪些内容已经改变。
产出内容
- 它本身不产出任何内容:它决定智能体如何编写 use_figma 脚本。最终结果就是任务所要求的、在你的 Figma 文件中创建或编辑的内容。
适用场景
- 任何通过 Figma MCP 服务器写入 Figma 文件的智能体任务:在调用 use_figma 之前会自动加载它。
- 设计师觉得繁琐的批量编辑:批量重命名图层、把颜色绑定到变量、修正自动布局、审查文件结构。
- 你在编写自己的 Figma 技能,想要了解官方技能所依赖的基础规则。
不适用的场景
- 搭建完整界面或设计系统组件库:请使用 figma-generate-design 或 figma-generate-library,它们会自行加载 figma-use。
- 把 Figma 设计转成代码:这只需要读取文件,是 figma-design-to-code 的工作。
- 你只使用 Figma 桌面版 MCP 服务器:它无法写入画布,所以那里没有 use_figma。
所需条件
- 已连接并登录的远程 Figma MCP 服务器(https://mcp.figma.com/mcp);Figma 文档表示,只有远程服务器才能写入画布。
- 一个对该文件有编辑权限的 Figma 账号。在草稿以外写入需要 Full 席位;写入在 beta 期间免费,Figma 表示之后将改为按用量计费的付费功能。
- 涉及可见的设计改动时,需要同时安装 figma-generate-design(该技能将其列为必需),组件库资源则需要 figma-generate-library。Figma 插件会把它们全部装好。
技能包含的文件
| 文件或文件夹 | 用途 |
|---|---|
SKILL.md | 21 条关键规则、页面规则、编辑器模式、高效 API(node.query、node.set、createAutoLayout、内联截图)、增量工作流程、错误恢复,以及一份执行前检查清单。 |
references/gotchas.md | 所有已知的陷阱,附错误和正确的代码,首先是编辑文本时加载字体的方法。 |
references/common-patterns.md | 可直接使用的脚本框架:形状、文本、自动布局、变量、组件、多步骤工作流程。 |
references/component-patterns.md | 变体集、组件属性、实例替换,以及查找现有组件。 |
references/variable-patterns.md | 集合、模式、作用范围、别名和变量绑定。 |
references/working-with-design-systems/ | 九篇简短指南,介绍如何使用和创建组件、变量、文本样式和效果样式。 |
references/plugin-api-standalone.d.ts | 完整的 Plugin API 类型定义(约 400 KB),用于搜索精确的函数签名,而不是整篇阅读。 |
2026-11-15 在仓库中查到的许可证:No licence file; Figma Developer Terms apply。
示例提示词
安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。
- 在这个 Figma 文件中,把仍是默认名称(如“Frame 12”)的图层按内容重命名为有意义的名称,并列出你改了哪些。
- 把 Pricing 页面上所有写死的蓝色填充绑定到我们的 color/brand/primary 变量。
- 列出这个文件中的页面、组件和变量集合,方便我们规划一次清理。
- 把 Features 框架中的卡片改成自动布局,间距 16 px,保持现有外观不变。
如何安装 figma-use
通过 Figma 插件安装,或与配套技能一起安装
figma-use 很少单独安装。Figma 为 Claude Code 提供的插件会一次性添加远程 MCP 服务器和 Figma 的全部技能;安装后运行 /mcp 并登录 Figma。
如果手动复制文件夹,下面的命令还会复制 figma-generate-design 和 figma-generate-library,因为 figma-use 会把可见的设计工作和组件库工作交给它们。
claude plugin install figma@claude-plugins-official
# or, by hand:
claude mcp add --transport http figma https://mcp.figma.com/mcp在 Cursor、Gemini CLI 和 VS Code 中
按照 Figma 的指南,在 Cursor 中安装同一个插件(在 Agent 聊天中运行 /add-plugin figma),在 Gemini CLI 中作为扩展安装(然后运行 /mcp auth figma)。在 VS Code 中,添加一个使用同一 URL 的 HTTP MCP 服务器,然后使用 Copilot 的智能体模式。
/add-plugin figma
gemini extensions install https://github.com/figma/mcp-server-guide不适用于 claude.ai 上传或 Claude API
该技能只有配合 Figma 远程 MCP 服务器中的 use_figma 工具才有意义。Claude API 的技能沙盒无法联网,我们也没有核实过 claude.ai 上的配置方法。
技能(Skill)是一个包含 SKILL.md 文件的文件夹。只需安装一次;智能体会在每次会话开始时读取它的简短描述,只有请求匹配时才加载完整说明。选择你使用的环境:
Claude Code:从插件市场安装
- 在终端中用
claude启动 Claude Code。 - 该插件位于 Anthropic 官方插件市场,Claude Code 首次启动时会自动为你添加。
- 安装插件。Claude Code 会先显示插件详情:确认它会添加哪些内容(技能、Hooks、MCP 服务器),然后选择安装给你自己、给该仓库的所有人,还是仅在该仓库中给你自己使用。
/plugin install figma@claude-plugins-official - 输入 / 查找
/figma:figma-use,或直接提出任务。
也可以不进入会话,直接在 shell 中运行:
claude plugin install figma@claude-plugins-official插件会整体安装,因此会附带其他技能,包括 figma-3d-transforms, figma-code-connect, figma-code-workflows, figma-create-new-file, figma-design-to-code, figma-generate-design, figma-generate-diagram, figma-generate-library, figma-generative-plugins, figma-implement-motion, figma-shaders, figma-spec, figma-swiftui, figma-use-figjam, figma-use-motion, figma-use-slides。
Claude Code:把文件夹复制到技能文件夹
把技能文件夹放到 ~/.claude/skills/,可在这台电脑的所有项目中使用;放到仓库内的 .claude/skills/,则与在该仓库工作的所有人共享(记得提交)。
git clone --depth 1 https://github.com/figma/mcp-server-guide.git
mkdir -p ~/.claude/skills
cp -R mcp-server-guide/skills/figma-use ~/.claude/skills/
cp -R mcp-server-guide/skills/figma-generate-design ~/.claude/skills/
cp -R mcp-server-guide/skills/figma-generate-library ~/.claude/skills/Claude Code 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /figma-use,或直接描述任务。
在 Windows 上,请在 Git Bash 或 WSL 中运行这些命令,或用文件资源管理器把文件夹复制到同样的位置。
Codex、Gemini CLI、Cursor 和 GitHub Copilot
这些智能体读取同样的 SKILL.md 文件夹。四者在项目中都认可的文件夹是 .agents/skills/,所以下面的命令把技能复制到那里:
git clone --depth 1 https://github.com/figma/mcp-server-guide.git
mkdir -p .agents/skills
cp -R mcp-server-guide/skills/figma-use .agents/skills/
cp -R mcp-server-guide/skills/figma-generate-design .agents/skills/
cp -R mcp-server-guide/skills/figma-generate-library .agents/skills/| 智能体 | 项目文件夹 | 用户文件夹 | 说明 |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | 输入 $ 或运行 /skills 来选择技能;当任务匹配时,Codex 也会自动选用。 |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | 也可以用 gemini skills install <git URL> --path <folder> --consent 从 Git 安装。2026 年 6 月 18 日起,Google 已用 Antigravity CLI 取代 Gemini CLI,面向免费层级和 Google One 用户;Antigravity 在项目中使用 .agents/skills/,个人使用 ~/.gemini/config/skills/。 |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | 在 Agent 聊天中输入 / 选择技能。Cursor 也会读取 Claude Code 的 .claude/skills/ 文件夹。 |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | 适用于 Copilot CLI、云端智能体,以及 VS Code、Visual Studio 和 JetBrains 中的智能体模式(IDE 支持取决于版本)。也可以运行 gh skill install OWNER/REPOSITORY SKILL(公开预览版,需 GitHub CLI 2.90.0 或更高版本)。 |
这些步骤的来源
已于 2026-11-14 对照各厂商的文档核实:
安全的画布脚本是什么样的
每个脚本都足够小,可以重试:先切换一次页面,加载要用到的字体,完成改动,再返回它创建或修改过的 ID。如果重试不会造成问题,相关的工作可以合并到一次调用中;遇到页面边界或真正出错后,再拆分工作。
检查依据的是脚本返回的证据(ID、数量、名称、尺寸),通常再加上组合完成后的一张截图和视觉修正后的一张截图,而不是每一步都截图。
处理大文件,又不返回海量内容
大范围读取只返回 ID、名称、类型和数量;所选 ID 的详细信息在之后的调用中再获取,每类清单(变量、样式、组件、页面)分别返回。该技能要求智能体在返回结果前先估算其大小,而不是悄悄截断。
关于 figma-use 的常见问题
use_figma 是什么?
use_figma 是 Figma MCP 服务器的通用写入工具。智能体发送一段 JavaScript 代码,Figma 在你的文件中针对 Plugin API 运行它,并返回脚本的返回值。它适用于 Figma Design、FigJam、Slides 和 Specs 文件,并且只能在远程服务器上使用。
已经有 figma-generate-design 了,还需要 figma-use 吗?
需要。figma-generate-design 和 figma-generate-library 在运行任何画布脚本前都要求先有 figma-use,因为它们所依赖的 Plugin API 规则都在 figma-use 中。Figma 插件会把它们一起安装。
为什么 Figma 称它为必需的前提?
画布脚本出错的方式往往难以排查:字体没加载时编辑文本会报错,颜色值 255 超出范围,用错 setter 切换页面会报错,脚本不返回节点 ID 则会让下一次调用无从下手。该技能把这些规则提前讲清,让智能体不必靠反复试错来摸索。
它能编辑 FigJam 白板和 Figma Slides 吗?
use_figma 在这三种编辑器中都能使用,但各自支持的节点类型不同。figma-use 覆盖 Figma Design 及其差异;对于 FigJam 和 Slides,Figma 提供了 figma-use-figjam 和 figma-use-slides 技能。
figma-use 技能免费吗?
这些文件可以免费安装,但不是开源的:没有许可证文件,适用 Figma 的 Developer Terms。你需要一个 Figma 账号,在草稿以外写入需要 Full 席位;Figma 表示写入画布在 beta 期间免费,之后将改为按用量计费的付费功能。
更多 AI 技能
相关技能
Figma Generate Design 技能
官方 · FigmaFigma 出品的技能:根据你的代码,在 Figma 文件中搭建或更新界面,使用你设计系统中的组件和变量。Figma Generate Library 技能
官方 · FigmaFigma 出品的技能:根据你的代码在 Figma 中搭建设计系统,包括变量、浅色与深色模式、样式以及带变体的组件。Figma Use Motion 技能
官方 · FigmaFigma 出品的技能:用 AI 为 Figma 文件中的图层添加动画,包括关键帧、动画样式、缓动、文字显现效果和时间轴长度。Figma Design to Code 技能
官方 · FigmaFigma 出品的技能:把 Figma 框架转成你项目中的代码,复用你的组件和资源,而不是粘贴生成的标记代码。缩略图设计 技能
社区 · Frank Heijdenrijk规划真实、适合手机阅读的视频缩略图简报,并设计原生对比测试。设计与模板 技能
社区 · Frank Heijdenrijk为周期性社交图形制定可复用品牌套件、模板系列及制作流程。