跳到正文
Codex DesignBETA

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 也复制过去才能用。

继续阅读

Codex Design 是独立开发的 Codex 插件,与 OpenAI 无关联,也未获 OpenAI 认可。