Figma Design to Code 技能
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-design-to-code 技能是 Figma 官方的智能体技能(Skill),用于把 Figma 设计实现为代码:你给智能体一个框架的链接,它就在你的项目中搭建出这个界面或组件。Figma 将它定为 MCP 服务器 get_design_context 工具的必需前提,因此智能体每次从 Figma 提取设计时都会加载它。
之所以需要它,是因为 Figma 返回的代码只是参考,而不是成品组件。该技能让智能体把它当作高保真、不可交互的原型:把绝对定位转换为你的布局体系,复用你现有的组件、token 和 Code Connect 映射,把每张图片和 SVG 精确放在设计中的位置,然后对照设计截图检查结果。它只读取 Figma;它与 figma-generate-design 方向相反,后者是把代码写进 Figma。
摘自该技能的 SKILL.md: treat returned code as a high visual fidelity non-interactive prototype
功能
- 在第一次调用 get_design_context 时请求附带截图(或调用 get_screenshot),并把它作为成品代码必须达到的视觉目标。
- 当返回结果被标记为信息稀疏时,把其中的子节点 ID 与截图对应起来,并以一次并行批量请求获取可见的子节点,然后只根据这些详细结果来实现。
- 检查你的项目和已安装的设计库包,找到匹配的组件、资源和 token,复用或组合它们,而不是写原始标记、内联样式或写死的数值。
- 只要存在 Code Connect 映射的组件,就使用它,即使接入起来更费事。
- 把每张静态图片和 SVG 下载到你的项目中,并保持其精确的位置和尺寸,代码中不留任何临时的 Figma 资源 URL;由数据驱动的图片保持动态。
- 只验证所要求的界面或组件:检查每个资源文件、它的位置、调用处和渲染尺寸,修正范围内的不一致,对无关的问题只做记录、不做改动。
产出内容
- 你仓库中的代码改动:符合你技术栈的组件或页面(Figma 默认输出 React 和 Tailwind,会按你的项目调整),以及下载的图片和 SVG 资源。
- 不会改动 Figma 文件。
适用场景
- 设计师交来一个 Figma 框架,你想在现有代码库和设计系统中把它实现出来。
- 你在使用 Code Connect,希望复用已映射的组件,而不是重新创建。
- 之前的设计转代码尝试产出了绝对定位的标记代码、丢失了图标,或链接到已过期的 Figma 图片。
不适用的场景
- 你想要相反的方向(代码转 Figma):请使用 figma-generate-design。
- 设计带有动画,你也需要动效:请加上 figma-implement-motion,它负责 get_motion_context,与本技能处理的结构配合使用。
- 目标是 SwiftUI:Figma 的 figma-swiftui 技能专门处理 SwiftUI 与 Figma 之间的转换。
- 你需要像素级精确的输出,而项目中没有现成组件:该技能仍然可用,但它的主要价值在于复用项目中已有的内容。
所需条件
- 已连接并登录的 Figma MCP 服务器。Figma 推荐使用远程服务器;桌面版服务器上也有 get_design_context,但需要 Figma 桌面应用以及付费套餐中的 Dev 或 Full 席位。
- 一个能访问该设计的 Figma 账号。该技能只读取,所以不需要写入权限,但读取类工具有调用频率限制:Starter 套餐或 View、Collab 席位每月最多 20 次调用,付费的 Dev 和 Full 席位则有每日和每分钟的限制。
- 在智能体中打开你的项目,以便它找到组件、token 以及放置资源的正确位置。
- 框架或图层的链接(Figma URL 中包含 file key 和节点 ID)。
技能包含的文件
| 文件或文件夹 | 用途 |
|---|---|
SKILL.md | 整个技能,分为三个简短部分:上下文(截图、稀疏结果)、实现(复用、Code Connect、资源)和验证。 |
2026-11-15 在仓库中查到的许可证:No licence file; Figma Developer Terms apply。
示例提示词
安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。
- 用我们现有的 Button 和 Card,把这个 Figma 框架实现为 src/components 中的一个 React 组件:<frame URL>。
- 根据这个 Figma 链接在我们的 Next.js 应用中搭建设置页面,使用 Tailwind 和我们的 design token,并把图标下载到 public/icons。
- 把这个 Figma 设计转成纯 HTML 和 CSS,与截图完全一致:<frame URL>。
- 更新 ProfileHeader.tsx,使其与最新的 Figma 设计一致;复用 Code Connect 映射到的 Avatar 组件。
如何安装 figma-design-to-code
连接 Figma MCP 服务器
在 Claude Code 中,安装 Anthropic 官方插件市场中的 Figma 插件,会添加远程 MCP 服务器,以及本技能和 Figma 的其他技能。安装后运行 /mcp 并登录 Figma。也可以用第二条命令添加服务器,然后只复制这个文件夹:该技能没有其他文件,也没有需要一起复制的配套技能。
claude plugin install figma@claude-plugins-official
# or, by hand:
claude mcp add --transport http figma https://mcp.figma.com/mcpCursor、Gemini CLI、VS Code 和桌面版服务器
按照 Figma 的指南,在 Cursor(/add-plugin figma)和 Gemini CLI(作为扩展安装,然后运行 /mcp auth figma)中安装同一个插件,VS Code 则通过 HTTP MCP 服务器连接。如果你的组织改用桌面版服务器,在 Figma 桌面应用打开、并已在 Dev Mode(开发模式)中启用服务器时,其地址为 http://127.0.0.1:3845/mcp。
/add-plugin figma
gemini extensions install https://github.com/figma/mcp-server-guide不适用于 claude.ai 上传或 Claude API
该技能只负责指导对 Figma MCP 服务器设计上下文工具的调用。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-design-to-code,或直接提出任务。
也可以不进入会话,直接在 shell 中运行:
claude plugin install figma@claude-plugins-official插件会整体安装,因此会附带其他技能,包括 figma-3d-transforms, figma-code-connect, figma-code-workflows, figma-create-new-file, figma-generate-design, 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-design-to-code ~/.claude/skills/Claude Code 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /figma-design-to-code,或直接描述任务。
在 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-design-to-code .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 对照各厂商的文档核实:
复用胜过重新生成
该技能的大部分内容都在强调不要在你的项目里重复造轮子。动手编辑前,智能体必须查看可能的项目路径和已安装的设计库包,复用匹配的组件、资源和 token,只有在它们无法表达设计时才做修改。Code Connect 映射总是在其映射的节点上使用,除非该组件确实无法配置。
Figma 中的绝对定位会转换为你项目自己的布局方式,除非设计确实需要固定位置;设计中可交互的部分也会变成可交互的代码。
大多数尝试败在资源上
该技能对图片和 SVG 要求严格:每个资源都按设计上下文结果的描述下载,并放在精确的位置,绝不重新绘制、内联、用相近的资源替代,或留下指向临时 Figma URL 的链接。SVG 保留自身的宽度和高度。在验证步骤中,只要有一个资源被替换或比例失调,就算失败。
关于 figma-design-to-code 的常见问题
figma-design-to-code 和 figma-generate-design 有什么不同?
两者方向相反。figma-design-to-code 读取 Figma 设计,在你的仓库中写代码。figma-generate-design 读取你的代码,在 Figma 中搭建可编辑的界面。很多团队通过 Figma 插件把两者都装上。
生成的代码是 React 吗?
Figma 的 get_design_context 默认返回 React 和 Tailwind,按要求也可以返回其他框架,例如 Vue、纯 HTML 和 CSS 或 iOS。随后该技能会把输出调整为符合你项目的技术栈、规范和现有组件,而不是直接粘贴。
需要付费的 Figma 席位吗?
写入方面不需要,因为该技能只读取。但读取类工具有限制:Starter 套餐或 View、Collab 席位每月最多 20 次调用。Professional、Organization 和 Enterprise 套餐中的 Dev 和 Full 席位则改为每日和每分钟的限制,适合经常使用。
为什么它坚持要截图?
截图是成品代码必须达到的视觉目标。该技能禁止把截图当作图片放进代码:实现必须基于详细的设计上下文,并下载和放置真实的资源。
figma-design-to-code 技能免费吗?
该文件可以免费安装,但不是开源的:仓库中没有许可证文件,适用 Figma 的 Developer Terms。它需要一个 Figma 账号,并计入你所在套餐和席位的 Figma 读取类工具调用频率限制。
更多 AI 技能
相关技能
Anydesign 技能
社区 · Alan Ponce (uxKero)从截图、网站或 Figma 设计中提取 design.md、设计令牌或单个元素的重建说明。Figma Implement Motion 技能
官方 · FigmaFigma 出品的技能:把在 Figma 中制作的动画转成代码,React 用 motion.dev,其他网站用 CSS keyframes,时间和缓动分毫不差。Figma Generate Design 技能
官方 · FigmaFigma 出品的技能:根据你的代码,在 Figma 文件中搭建或更新界面,使用你设计系统中的组件和变量。Figma Use 技能(use_figma)
官方 · Figma每次写入 Figma 背后的基础技能:智能体通过 use_figma 在你的文件中运行 Plugin API 脚本时遵循的规则。Figma Generate Library 技能
官方 · FigmaFigma 出品的技能:根据你的代码在 Figma 中搭建设计系统,包括变量、浅色与深色模式、样式以及带变体的组件。缩略图设计 技能
社区 · Frank Heijdenrijk规划真实、适合手机阅读的视频缩略图简报,并设计原生对比测试。