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.
功能
- 阅读你的源代码(或描述),列出视图的各个区块及每个区块用到的 UI 组件,并找出产品实际使用的字体,而不是默认用 Inter。
- 通过代码库中的 Code Connect 文件查找这些组件,搜索你的 Figma 组件库,并盘点现有界面中的组件 key、变量以及文本和效果样式。
- 在远离现有内容的位置创建一个外层框架,在其中搭建每个区块,导入设计系统的组件实例并绑定变量,而不是写死原始数值。
- 把重复的元素做成本地组件和实例,并以 SVG 形式导入图标。
- 检查结果:节点数量、一张与源界面对比的整体截图,并明确检查文字是否使用了产品字体;然后只修正有问题的部分。
- 对于带照片或标志的网页应用,并行运行 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:从插件市场安装
- 在终端中用
claude启动 Claude Code。 - 该插件位于 Anthropic 官方插件市场,Claude Code 首次启动时会自动为你添加。
- 安装插件。Claude Code 会先显示插件详情:确认它会添加哪些内容(技能、Hooks、MCP 服务器),然后选择安装给你自己、给该仓库的所有人,还是仅在该仓库中给你自己使用。
/plugin install figma@claude-plugins-official - 输入 / 查找
/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 或更高版本)。 |
这些步骤的来源
已于 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 技能
相关技能
Figma Use 技能(use_figma)
官方 · Figma每次写入 Figma 背后的基础技能:智能体通过 use_figma 在你的文件中运行 Plugin API 脚本时遵循的规则。Figma Design to Code 技能
官方 · FigmaFigma 出品的技能:把 Figma 框架转成你项目中的代码,复用你的组件和资源,而不是粘贴生成的标记代码。Figma Generate Library 技能
官方 · FigmaFigma 出品的技能:根据你的代码在 Figma 中搭建设计系统,包括变量、浅色与深色模式、样式以及带变体的组件。Brand Guidelines 技能
官方 · Anthropic把 Anthropic 的品牌色和字体应用到幻灯片和文档中。最适合用作模板,打造你自己的品牌技能。缩略图设计 技能
社区 · Frank Heijdenrijk规划真实、适合手机阅读的视频缩略图简报,并设计原生对比测试。设计与模板 技能
社区 · Frank Heijdenrijk为周期性社交图形制定可复用品牌套件、模板系列及制作流程。