Figma Generate Library 技能
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-library 技能是 Figma 官方的智能体技能(Skill),用于根据你的代码库在 Figma 中搭建或更新设计系统。它读取你的 CSS 变量、主题文件和组件,然后创建对应的 Figma 变量(含浅色和深色模式)、文本样式和效果样式,以及带规范变体集的组件,每个属性都绑定到变量,而不是写死数值。
它决定搭建什么、按什么顺序搭建;配套的 figma-use 技能决定每个画布脚本怎么写,所以两者总是一起加载。它通过远程 Figma MCP 服务器运行,需要一个 Figma 账号和一个你有编辑权限的文件。它会按需求调整规模:一套 token、一个组件、一整套组件库,或者对代码与 Figma 之间已经不一致的部分做一次核对同步。
摘自该技能的 SKILL.md: Build professional-grade design-system assets in Figma that match code.
功能
- 在改动文件之前先确定一个范围(仅 token、单个组件或组件族、完整组件库,或代码到 Figma 的核对同步),并列出一份简短清单,说明将交付什么、如何检查。
- 先摸底:分析相关代码,检查文件中已有的页面、变量和样式,列出文件可用的组件库并在其中搜索;代码和 Figma 中的取值不一致时会询问你。
- 创建变量集合和模式(例如 Primitives 加上含 Light 和 Dark 模式的 Color 集合)、以别名指向基础变量的语义变量、为每个变量设置作用范围,并写入指回代码的 CSS var() 代码语法。
- 按依赖顺序搭建组件,包含变体集、组件属性和变量绑定;图标用实例替换(instance swap),而不是每个图标做一个变体;超过 30 个的变体矩阵会被拆分。
- 对于完整组件库,会添加封面、入门指南、基础规范和组件页面,再加上 Code Connect 映射,最后做一次无障碍、命名和绑定审查。
- 把每个已创建的 ID 记录在一个 JSON 状态文件中,让耗时较长的搭建可以在新对话中继续;并且从不同时运行两个画布脚本。
产出内容
- Figma 文件中的变量、模式、文本样式、效果样式、组件和组件集;如果范围包含文档,还会有文档页面。
- 你电脑上的一个状态文件(/tmp/design-system-state-<run id>.json),列出已创建的内容,用于继续搭建。
适用场景
- 你的 design token 和组件都在代码里,而 Figma 组件库缺失、不完整或已经过时。
- 你需要在 Figma 中规范地搭建一个新组件,带变体和变量绑定,而不是手工绘制。
- 你要把浅色和深色主题设置成与 CSS 一致的 Figma 变量模式。
- 代码和 Figma 已经不一致,你只想就地更新有变化的 token 和组件。
不适用的场景
- 你想用现有组件库搭建一个界面或页面:那是 figma-generate-design 的工作。
- 你想从 Figma 设计生成代码:请改用 figma-design-to-code。
- 你没有任何代码或 token 来源,想让它凭空设计一套品牌:该技能只搭建代码中定义的内容,拿不准时会询问而不是猜测。
- 你在共享文件上只有 View 或 Collab 席位:在草稿以外写入需要 Full 席位。
所需条件
- 一个 Figma 账号和一个你有编辑权限的文件。Figma 文档表示,在草稿以外写入需要 Full 席位;写入画布在 beta 期间免费,之后将改为按用量计费的付费功能。
- 远程 Figma MCP 服务器(https://mcp.figma.com/mcp),已连接到你的智能体并登录。
- Figma 的 figma-use 技能:该技能的每个画布脚本都要求先有它。Figma 插件会同时安装这两个技能。
- 以你的代码库(或一个 token 文件)作为唯一依据。读取类工具计入 Figma 的调用频率限制:Starter 套餐或 View、Collab 席位每月最多 20 次调用;写入类工具不受限制。
- 完整组件库需要一些时间:它分阶段运行并设有检查点,技能会给你一条续接提示词,方便在新对话中继续。
技能包含的文件
| 文件或文件夹 | 用途 |
|---|---|
SKILL.md | 范围约定、各范围的工作流程、15 条设计系统规则、状态记录、组件库复用矩阵,以及何时询问你。 |
references/discovery-phase.md | 在做任何改动之前,如何分析代码和 Figma 文件。 |
references/token-creation.md | 集合、模式、别名、作用范围和代码语法,包括一种更大型的多品牌模式。 |
references/component-creation.md | 搭建带属性和绑定的组件及变体集。 |
references/documentation-creation.md | 封面、入门指南和基础规范页面。 |
references/code-connect-setup.md | 把 Figma 组件映射到代码组件,以及设置变量的代码语法。 |
references/naming-conventions.md | 文件还没有命名规范时,变量、页面、变体和样式的命名方式。 |
references/error-recovery.md | 脚本失败时怎么办,以及如何安全清理中途放弃的工作。 |
scripts/*.js | 嵌入画布调用中的八个辅助脚本:检查文件、创建集合和语义 token、搭建变体集、绑定变量、创建文档页面、验证,以及只删除列出的孤立节点。 |
2026-11-15 在仓库中查到的许可证:No licence file; Figma Developer Terms apply。
示例提示词
安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。
- 用 figma-generate-library 根据 src/styles/tokens.css 在这个文件中创建 Figma 变量:<file URL>。包括 Primitives,以及含 Light 和 Dark 模式的 Color 集合。
- 根据 components/Button.tsx 在 Figma 中搭建我们的 Button 组件,包含 Size、Variant 和 State 变体,并绑定到我们的变量。
- 对比我们的 Tailwind 主题和这个 Figma 组件库中的变量,只更新有变化的部分。
- 根据这个仓库在一个新的 Figma 文件中搭建完整的设计系统:基础规范、Button、Input、Card、Badge,以及一个入门指南页面。
如何安装 figma-generate-library
连接 Figma MCP 服务器,并同时安装 figma-use
在 Claude Code 中,最快的方式是安装 Anthropic 官方插件市场中的 Figma 插件:它会添加 MCP 服务器以及 Figma 的全部技能,包括本技能所需的 figma-use。安装后在 Claude Code 中运行 /mcp,并在浏览器中登录 Figma。
也可以手动复制文件夹,只要把 figma-use 一起复制到旁边(下面的命令会同时完成两者),并用第二条命令添加 MCP 服务器即可。
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 或 API 的用法
每一步都要调用实时的 Figma MCP 工具,例如 use_figma、get_libraries 和 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-library,或直接提出任务。
也可以不进入会话,直接在 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-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-library ~/.claude/skills/
cp -R mcp-server-guide/skills/figma-use ~/.claude/skills/Claude Code 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /figma-generate-library,或直接描述任务。
在 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-library .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 对照各厂商的文档核实:
先定范围,做完就停
该技能的设计就是为了避免范围蔓延。只要求一个组件,不会变成搭建整套组件库:它只创建该组件缺少的 token,完成验证,把要求的各个状态以实例形式放在一个紧凑的框架中展示,然后停止。只要求 token,就不会附带组件。
每种范围都有自己的完成标准(变体覆盖、变量作用范围和别名、代码语法、绑定以及视觉检查);额外的文档或审查会作为后续事项提出,而不是直接开工。
让组件库保持整洁的规则
每个变量都设有明确的作用范围(背景、文字、描边、间距、圆角),不会出现在每一个属性选择器中;Web 代码语法使用 var() 形式并填入你真实的 CSS 变量名。语义颜色以别名指向基础变量,而不是重复写原始数值。
清理时只按状态记录中的精确 ID 删除节点,绝不根据名称猜测,因此不会删掉你自己的图层。
关于 figma-generate-library 的常见问题
figma-generate-library 和 figma-generate-design 有什么区别?
figma-generate-library 搭建设计系统中可复用的部分:变量、样式、组件和变体集。figma-generate-design 则用这些部分搭建界面和页面。如果一个任务两者都需要,Figma 的 figma-use 技能要求同时加载两者。
它能创建浅色和深色模式的变量吗?
能。它的标准 token 模式是:一个只有单一模式的 Primitives 集合,一个含 Light 和 Dark 模式、以别名指向基础变量的 Color 集合,以及独立的 Spacing 和 Typography 集合。更大的系统可以使用更多模式,例如品牌或对比度变体。
它会重新搭建我的组件库中已有的组件吗?
不会,它会先搜索。如果组件库中的组件在属性、token 模型和命名上都合适,就直接复用;看起来合适但属性不符,就对它进行封装;只有当 API 或 token 模型不兼容、或你无法编辑该组件库时才重新搭建。选择不明确时,它会询问你。
它需要 figma-use 吗?
需要。该技能写明,每次调用 use_figma 都必须加载 figma-use:figma-generate-library 知道要搭建什么、按什么顺序,figma-use 则掌握 Plugin API 的规则。安装 Figma 插件会同时得到两者。
figma-generate-library 技能免费吗?
技能文件可以免费安装,但它们不是开源的:仓库中没有许可证文件,适用 Figma 的 Developer Terms。你需要一个 Figma 账号;在草稿以外写入需要 Full 席位,Figma 表示写入画布在 beta 期间免费,之后将改为按用量计费的付费功能。
耗时较长的搭建中断了怎么办?
该技能会把每个已创建的 ID 记录到一个 JSON 文件中,并给出一条带运行 ID 的续接提示词。在新对话中,它会重新读取该文件,并按名称扫描 Figma 文件,从中断的地方继续,而不会重复创建已有的内容。
更多 AI 技能
相关技能
UI/UX Pro Max 技能
社区 · nextlevelbuilder搜索本地 UI/UX 数据,获取设计系统、配色、字体、无障碍和技术栈建议。Figma Use 技能(use_figma)
官方 · Figma每次写入 Figma 背后的基础技能:智能体通过 use_figma 在你的文件中运行 Plugin API 脚本时遵循的规则。Figma Generate Design 技能
官方 · FigmaFigma 出品的技能:根据你的代码,在 Figma 文件中搭建或更新界面,使用你设计系统中的组件和变量。Theme Factory 技能
官方 · Anthropic十套现成的颜色与字体主题,适用于幻灯片、文档和网页,用一份 PDF 展示供你挑选,也可按需定制新主题。Brand Guidelines 技能
官方 · Anthropic把 Anthropic 的品牌色和字体应用到幻灯片和文档中。最适合用作模板,打造你自己的品牌技能。缩略图设计 技能
社区 · Frank Heijdenrijk规划真实、适合手机阅读的视频缩略图简报,并设计原生对比测试。