Codex 的 figma-use skill
figma-use skill 教 Codex 怎么往 Figma 里写内容:每次调用 use_figma 之前都会先加载它。use_figma 会在你的文件里运行 Plugin API JavaScript,用来创建节点、设置变量和搭建组件。它包含在 Figma 给 Codex 的插件里。
更新于 2026年11月12日 · 阅读约 3 分钟
速览
| Skill 名称 | figma-use |
| 来自 | Figma 的 Figma 插件 |
| 安装 | codex plugin add figma@openai-curated,或在 Codex 里运行 /plugins |
| Codex 何时使用 | 每次调用 use_figma 之前:创建或编辑节点、变量、组件、自动布局或填充时 |
| 源码 | GitHub 上的 openai/plugins |
它能做什么
Figma 把这个 skill 称为必须先满足的前提,因为跳过它会导致很难排查的失败。它是一本 Plugin API 的规则手册,包含一份简短的索引和一个完整的类型定义文件,Codex 会按需搜索这个文件,而不是一次性全部加载。
它强制执行的规则包括:
- 输出: 用
return把数据传回来。console.log()的内容不会返回,figma.notify()会直接报错。创建或修改过的每个节点都要返回它的 ID。 - 小步进行: 每次调用最多 10 个逻辑操作,用占位元素自上而下地搭建,每一步之后都用
get_metadata和get_screenshot检查。 - API 陷阱: 颜色取值范围是 0 到 1;填充是只读数组,要先克隆再重新赋值;编辑任何文字之前必须先加载字体;切换页面只能用
await figma.setCurrentPageAsync(page)。 - 编辑器类型: 它会根据 URL 区分 Design、FigJam 和 Slides 文件,因为每种文件允许的节点类型不同。
它还会把 Codex 引向关于组件、变量、文字和效果样式、设计系统的参考文件,以及用来搭建完整界面或组件库的配套 skill。
什么时候用
只要你想让 Codex 在 Figma 里做修改,而不只是读取,就装上它:设置 token、搭建带变体的组件,或者根据代码排出一个页面。
试一试
在 Figma 里创建颜色变量
使用 figma-use skill。在这个 Figma 文件里,为我们的品牌色创建一个带浅色和深色模式的颜色变量集合,给每个变量设置正确的作用范围,并把它们绑定到 Components 页面上的按钮。
Claude Code 里能用吗?
能,需要配合 Figma 的 MCP 服务器。这个 skill 是标准的 SKILL.md 加上普通的参考文件,所以可以把文件夹复制到 ~/.claude/skills。use_figma、get_metadata 和 get_screenshot 这些工具来自 Figma 的 MCP 服务器,所以要先在 Claude Code 里连上它。指向其他 Figma skill 的链接,只有把那些 skill 也复制过去才能用。