如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题
Codex

Codex 使用场景

将 Figma 设计稿转为代码

根据结构化设计信息,将 Figma 中选定的设计实现为界面,再对照设计稿打磨视觉细节。

难度 Intermediate
时间跨度 1h

使用 Codex 从 Figma 获取设计上下文、素材和变体,并据此编写符合代码仓库设计系统的代码。然后使用 Playwright 对照 Figma 设计稿检查界面,逐步调整,直到视觉效果与设计稿一致。

最适合

  • 在现有代码库中实现已用 Figma 设计好的界面或交互流程
  • 希望 Codex 根据结构化设计上下文实现界面的团队

目录

    ← 所有使用场景

    将 Figma 设计稿转为代码

    根据结构化设计信息,将 Figma 中选定的设计实现为界面,再对照设计稿打磨视觉细节。

    使用 Codex 从 Figma 获取设计上下文、素材和变体,并据此编写符合代码仓库设计系统的代码。然后使用 Playwright 对照 Figma 设计稿检查界面,逐步调整,直到视觉效果与设计稿一致。

    Intermediate
    1h

    使用 Codex 从 Figma 获取设计上下文、素材和变体,并据此编写符合代码仓库设计系统的代码。然后使用 Playwright 对照 Figma 设计稿检查界面,逐步调整,直到视觉效果与设计稿一致。

    Intermediate
    1h

    最适合

    • 在现有代码库中实现已用 Figma 设计好的界面或交互流程
    • 希望 Codex 根据结构化设计上下文实现界面的团队

    技能与插件

    • 用代码实现设计稿,通过 Code Connect 建立已发布组件与源文件之间的映射,并为项目生成专用的设计系统规则,方便后续按同一套规则将 Figma 设计稿转为代码。
    • 检查界面在不同屏幕尺寸下的表现,并在真实浏览器中验证实现效果。
    技能 使用理由
    Figma 用代码实现设计稿,通过 Code Connect 建立已发布组件与源文件之间的映射,并为项目生成专用的设计系统规则,方便后续按同一套规则将 Figma 设计稿转为代码。
    Playwright 检查界面在不同屏幕尺寸下的表现,并在真实浏览器中验证实现效果。

    起始提示词

    请在当前项目中使用 Figma 技能实现这份 Figma 设计稿。 要求: - 先对指定的节点或画框调用 `get_design_context`。 - 如果返回的内容被截断,请使用 `get_metadata` 梳理文件的节点结构,再用 `get_design_context` 重新获取所需的节点,只获取这些节点。 - 开始编码前,请对指定的变体调用 `get_screenshot`。 - 复用现有设计系统中的组件和设计变量。 - 使用代码仓库已有的工具和组件模式来实现 Figma 输出的设计,避免另建一套体系。 - 尽量还原设计稿的间距、布局、视觉层次,以及界面在不同屏幕尺寸下的表现。 - 遵循代码仓库现有的路由、状态管理和数据获取模式。 - 确保页面能自适应桌面和移动设备的屏幕。 - 如果 Figma 返回指向 localhost 的图片或 SVG 资源,请直接使用这些资源,不要创建占位符或添加新的图标包。 验证: - 对照 Figma 设计稿,检查实现后的界面在外观和行为上是否与设计稿一致。 - 使用 Playwright 核对界面效果,如有差异就继续调整,直到与设计稿一致。
    请在当前项目中使用 Figma 技能实现这份 Figma 设计稿。 要求: - 先对指定的节点或画框调用 `get_design_context`。 - 如果返回的内容被截断,请使用 `get_metadata` 梳理文件的节点结构,再用 `get_design_context` 重新获取所需的节点,只获取这些节点。 - 开始编码前,请对指定的变体调用 `get_screenshot`。 - 复用现有设计系统中的组件和设计变量。 - 使用代码仓库已有的工具和组件模式来实现 Figma 输出的设计,避免另建一套体系。 - 尽量还原设计稿的间距、布局、视觉层次,以及界面在不同屏幕尺寸下的表现。 - 遵循代码仓库现有的路由、状态管理和数据获取模式。 - 确保页面能自适应桌面和移动设备的屏幕。 - 如果 Figma 返回指向 localhost 的图片或 SVG 资源,请直接使用这些资源,不要创建占位符或添加新的图标包。 验证: - 对照 Figma 设计稿,检查实现后的界面在外观和行为上是否与设计稿一致。 - 使用 Playwright 核对界面效果,如有差异就继续调整,直到与设计稿一致。

    简介

    在 Figma 中选定要实现的具体元素后,Codex 就能沿用项目已有的模式,将所选设计实现为精致的界面。

    通过 Figma 技能,Codex 可以使用 Figma MCP 服务器获取结构化的设计上下文、变量、素材,以及要实现的具体变体。

    通过 Playwright 交互式技能,Codex 可以在真实浏览器中打开应用,对照 Figma 设计稿检查实现效果,并反复调整布局或交互行为,让结果更接近设计目标。

    整理 Figma 项目

    Figma 文件的结构越清晰,首版实现的效果就越好。为了让设计交接更顺利,您可以这样整理文件:

    • 尽可能使用变量或设计令牌,尤其是在定义颜色、排版和间距时
    • 为可复用的界面元素创建组件,避免反复复制已与组件脱离的图层
    • 尽量使用自动布局,减少手动定位
    • 为画框和图层取清晰的名称,让人一眼就能识别主界面、状态和变体
    • 尽可能在文件中保留实际使用的图标和图片,这样 Codex 就无需猜测该用哪些素材

    清晰的设计结构有助于 Codex 实现稳定、可用于生产环境的界面。

    明确说明要求

    您对预期交互模式和所需风格的描述越具体,实现效果就越好。

    如果某个状态、断点或交互很重要,请明确指出。如果文件中有多个相似的变体,请告诉 Codex 应以哪个变体为准。

    请说明哪些细节必须与设计完全一致,哪些地方应优先遵循代码仓库的约定。要求越明确,Codex 就越容易做出合适的取舍。

    准备设计系统

    如果目标代码仓库已有结构清晰的组件层,Codex 的实现效果会更好。Codex 可以自动复用您现有的组件和设计系统,无需从头构建。

    如有必要,您可以告诉 Codex 应复用哪些基础组件、设计令牌存放在哪里,以及代码仓库对按钮、输入框、卡片、排版和图标采用哪些标准实现。

    Figma MCP 的输出通常看起来像用 React 和 Tailwind 写的代码。可以参考它的结构,最终代码风格则应遵循项目约定。请让 Codex 使用项目现有的工具、组件封装、色彩系统、字号层级和间距令牌来实现设计,并沿用项目的路由、状态管理和数据获取方式。

    工作流程

    在 Figma 中选定要实现的元素

    复制指向您要实现的具体 Figma 画框、组件或变体的链接。Figma MCP 工作流程依赖链接定位元素,因此链接必须直接指向目标节点,不能只指向其所在的父级画框。

    提示 Codex 使用 Figma

    首版实现应以 Figma 设计为依据。请让 Codex 在开始编写代码前先执行 Figma MCP 工作流程。

    您可以在提示词中写明以下步骤:

    1. 先针对目标节点或画框运行 `get_design_context`。 2. 如果响应过大或被截断,运行 `get_metadata` 获取文件的节点结构,然后仅针对所需节点重新运行 `get_design_context`。 3. 针对要实现的具体变体运行 `get_screenshot`。 4. 拿到设计上下文和目标变体的截图后,再下载所需素材并开始实现。 5. 按照代码仓库的约定实现设计:复用现有组件,尽可能用项目的样式系统替代直接使用的工具类,并确保间距、视觉层级和响应式行为与设计一致。 6. 如果 Figma 返回 localhost 上的图片或 SVG 源文件,请直接使用。如果返回的数据中已有所需素材,就不要创建占位素材或引入新的图标包。

    首版实现完成后,Codex 会使用 Playwright 在真实浏览器中验证界面,并进一步调整视觉和交互细节,缩小与设计稿之间的差异。

    技术栈

    需求

    设计稿来源

    默认选项

    Figma

    为什么需要

    在 Figma 中选定具体的画框或组件,可以为界面实现提供明确的参照。

    需求 默认选项 为什么需要
    设计稿来源 Figma 在 Figma 中选定具体的画框或组件,可以为界面实现提供明确的参照。

    相关使用场景