跳到主要内容

Figma Generate Design 技能

Figma 出品的技能:根据你的代码,在 Figma 文件中搭建或更新界面,使用你设计系统中的组件和变量。

官方 · 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-generate-design 技能是 Figma 官方的智能体技能(Skill),用于根据代码或描述在 Figma 中搭建界面:页面、弹窗、抽屉、表单或仪表盘。Claude 通过 Figma MCP 服务器查找你设计系统中的组件、变量和文本样式,然后用真实的组件实例逐个区块组装视图,而不是画一堆写死颜色的方框。

成品应当是可编辑的 Figma 图层,绝不是粘贴进去的截图:该技能禁止把扁平化的界面图片作为交付物导入。它需要一个 Figma 账号、Figma MCP 服务器(远程)和一个目标文件,并与 Figma 的 figma-use 技能配合使用,后者包含每个画布脚本都要遵守的规则。

摘自该技能的 SKILL.md: Code-to-design output must recreate the UI as editable text, components, icons, and hierarchy.

这是 Figma 发布的官方技能。和所有技能一样,它会向智能体下达指令,并可能包含由智能体运行的脚本,因此请从本页链接的来源安装,而不要使用其他地方的副本。

功能

  1. 阅读你的源代码(或描述),列出视图的各个区块及每个区块用到的 UI 组件,并找出产品实际使用的字体,而不是默认用 Inter。
  2. 通过代码库中的 Code Connect 文件查找这些组件,搜索你的 Figma 组件库,并盘点现有界面中的组件 key、变量以及文本和效果样式。
  3. 在远离现有内容的位置创建一个外层框架,在其中搭建每个区块,导入设计系统的组件实例并绑定变量,而不是写死原始数值。
  4. 把重复的元素做成本地组件和实例,并以 SVG 形式导入图标。
  5. 检查结果:节点数量、一张与源界面对比的整体截图,并明确检查文字是否使用了产品字体;然后只修正有问题的部分。
  6. 对于带照片或标志的网页应用,并行运行 Figma 的页面捕获,把其中的图片复制到可编辑的版本中,然后删除捕获内容。

产出内容

  • Figma 文件中新建或更新的框架(frame),由设计系统组件实例、本地组件、变量和样式构成。
  • 不会在你的电脑上生成文件:成果直接落在 Figma 中。

适用场景

  • 你的应用界面已经用代码实现,你想用已发布的组件在 Figma 中把它们搭建出来。
  • Figma 中的某个界面已经过时,需要与代码中的现状保持一致。
  • 你想用已有的设计系统,在 Figma 中做出新界面、弹窗或仪表盘的原型。

不适用的场景

  • 交付物是组件库中可复用的组件或 token 集:Figma 为此推荐它的 figma-generate-library 技能。
  • 你想从 Figma 设计生成代码(方向相反):那是 figma-design-to-code 和 MCP 服务器的设计上下文工具的用途。
  • 你的文件中没有已发布的设计系统或团队库:该技能需要可复用的组件,没有的话效果会差一些。
  • 你无法连接远程 Figma MCP 服务器(例如所在组织屏蔽了它):没有它,这个技能无法工作。

所需条件

  • 一个能访问目标文件的 Figma 账号。在草稿以外写入需要 Full 席位;Figma 表示写入画布在 beta 期间免费,之后将改为按用量计费的付费功能。
  • 远程 Figma MCP 服务器(https://mcp.figma.com/mcp),已连接到你的智能体并登录 Figma。
  • 同时还需要 Figma 的 figma-use 技能:figma-generate-design 在运行任何画布脚本前都要求先有它。Figma 插件会同时安装这两个技能。
  • 一个目标 Figma 文件(URL 或 file key),最好其中有已发布的设计系统或团队库。
  • 界面的源代码或描述。读取类工具计入 Figma 的调用频率限制:Starter 套餐或 View、Collab 席位每月最多 20 次调用;写入类工具不受限制。

技能包含的文件

文件或文件夹用途
SKILL.md必须遵循的六步工作流程(理解、查找组件/变量/样式、外层框架、搭建区块、验证、更新),以及其边界和错误恢复。
references/componentization.md为什么以及如何在第一遍就把重复元素做成组件和实例。
references/discover-product-font.md在代码中哪里找到产品实际使用的字体,以及搭建后如何核实。

2026-11-14 在仓库中查到的许可证:No licence file; Figma Developer Terms apply。

示例提示词

安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。

  • 用 figma-generate-design 在这个 Figma 文件中搭建我们的定价页面(src/pages/pricing.tsx):<file URL>。使用我们 Acme UI 组件库中的组件。
  • 更新 Figma 中的设置弹窗框架,使其与当前的 SettingsModal.tsx 一致,替换所有有变化的组件。
  • 在 Figma 中创建一个仪表盘界面,包含页头、三张统计卡片和一个最近订单表格,颜色和间距使用我们设计系统中的变量。
  • 把运行在 localhost:3000/checkout 的应用在 Figma 中搭建成可编辑图层;先捕获页面,让商品图片也能带过来。

如何安装 figma-generate-design

第 1 步:连接 Figma MCP 服务器

在 Claude Code 中,最简单的方式是安装 Anthropic 官方插件市场中的 Figma 插件:它会添加 MCP 服务器设置以及 Figma 的全部技能,包括 figma-use 和 figma-generate-design。在 shell 中运行该命令,启动 Claude Code,然后运行 /mcp,按浏览器中的步骤登录 Figma。

不使用插件的话,请手动添加服务器,并自行安装这两个技能文件夹(见下方技能文件夹的步骤;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 中则作为扩展安装,然后在 Gemini CLI 内运行 /mcp auth figma。在 VS Code 中,添加一个使用同一 URL 的 HTTP MCP 服务器(Command Palette(命令面板)> MCP: Add Server),然后使用 Copilot 的智能体模式。

/add-plugin figma
gemini extensions install https://github.com/figma/mcp-server-guide

不适用于 claude.ai 上传或 Claude API Skills 接口

该技能依赖实时的 MCP 工具(use_figma、search_design_system 等)。Claude API 的技能沙盒无法联网,我们也没有核实过 claude.ai 上的配置方法,所以本页只提供上面的智能体配置。

技能(Skill)是一个包含 SKILL.md 文件的文件夹。只需安装一次;智能体会在每次会话开始时读取它的简短描述,只有请求匹配时才加载完整说明。选择你使用的环境:

Claude Code:从插件市场安装

  1. 在终端中用 claude 启动 Claude Code。
  2. 该插件位于 Anthropic 官方插件市场,Claude Code 首次启动时会自动为你添加。
  3. 安装插件。Claude Code 会先显示插件详情:确认它会添加哪些内容(技能、Hooks、MCP 服务器),然后选择安装给你自己、给该仓库的所有人,还是仅在该仓库中给你自己使用。
    /plugin install figma@claude-plugins-official
  4. 输入 / 查找 /figma:figma-generate-design,或直接提出任务。

也可以不进入会话,直接在 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-diagram, figma-generate-library, figma-generative-plugins, figma-implement-motion, figma-shaders, figma-spec, figma-swiftui, figma-use, 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-generate-design ~/.claude/skills/
cp -R mcp-server-guide/skills/figma-use ~/.claude/skills/

Claude Code 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /figma-generate-design,或直接描述任务。

在 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-generate-design .agents/skills/
cp -R mcp-server-guide/skills/figma-use .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 或更高版本)。
只安装你信任的技能. Anthropic 的建议是只使用可信来源的技能,其他技能在使用前要读完每个文件:技能可能以其描述中未提及的方式,指示智能体运行命令、读取文件或发送数据。

这些步骤的来源

已于 2026-11-14 对照各厂商的文档核实:

它如何搭建一个界面

该技能对顺序要求很严格:先查找,再搭建。首先检查你仓库中的 Code Connect 文件,然后搜索你的组件库(每种意图一次查询,并使用同义词,例如“pill”“tab”和“chip”),再盘点现有界面。只有设计系统未覆盖的空缺才会手工搭建。

所有内容都搭建在一开始就创建好的一个外层框架内,因为之后在不同画布脚本之间移动节点会悄无声息地失败。工作分成可安全重试的阶段进行,出错只影响当前阶段,之前的区块保持完好。

验证的最后一步是把一张整体截图与源界面对比,并检查字体家族,因为脚本可能加载了错误的字体却不报任何错。

图片与 AI 积分

画布脚本无法从 URL 获取图片。对于带照片、头像或标志的网页应用,该技能会用 Figma 的捕获工具把运行中的页面捕获到同一文件中,并把图片填充复制过来。如果没有可用的图片,它可以用 Figma AI 生成占位图,并会明确告知,因为这会消耗 Figma AI 积分。

关于 figma-generate-design 的常见问题

figma-generate-design 技能免费吗?

技能文件可以免费阅读和安装,但它们不是开源的:仓库中没有许可证文件,适用 Figma 的 Developer Terms。使用它需要 Figma 账号。Figma 表示写入画布在 beta 期间免费,之后将成为按用量计费的付费功能;读取类工具则按套餐和席位限制调用频率。

需要 Figma MCP 服务器吗?

需要。每一步都要通过远程 Figma MCP 服务器的工具来完成,例如用 use_figma 在画布上搭建,用 search_design_system 查找组件。如果服务器没有连接并登录,这个技能就无从下手。

需要哪种 Figma 套餐或席位?

Figma 的开发者文档写明,在草稿以外写入需要 Full 席位。读取类工具按套餐和席位限制:Starter 套餐或 View、Collab 席位每月最多 20 次调用;Professional、Organization 和 Enterprise 套餐的 Dev 或 Full 席位有每日和每分钟的限制。写入文件的工具不受限制。

得到的是可编辑图层还是截图?

可编辑图层。该技能的硬性规定是,输出必须用可编辑的文本、组件、图标和层级重建界面;截图只能用作视觉参考,用完即删除。

如果我的 Figma 文件没有设计系统怎么办?

该技能把已发布的设计系统或团队库访问权限列为前提条件。没有的话,它就没有可复用的组件或变量;如果要搭建组件库本身,Figma 提供了 figma-generate-library 技能。

它能在 Cursor、Codex 或 Gemini CLI 中使用吗?

Figma 的指南提供了 Claude Code、Cursor、Gemini CLI 以及 VS Code 配合 Copilot 的配置方法,并表示其他支持 Streamable HTTP MCP 服务器的工具也能连接。技能文件夹本身遵循 SKILL.md 标准,所以任何能读取技能文件夹并已连接 Figma MCP 服务器的智能体都可以加载它。

更多 AI 技能

相关技能

技能分类