Codex 的 Design QA skill
Design QA skill 让 Codex 把原型和原始设计稿并排对比,把差异整理成按优先级排列的修改清单。它包含在 OpenAI 的 Product Design 插件里,每次搭建完成、交付之前都要先过它这一关。
更新于 2026年11月12日 · 阅读约 3 分钟
速览
| Skill 名称 | design-qa |
| 来自 | OpenAI 的 Product Design 插件 |
| 安装 | codex plugin add product-design@openai-curated,或在 Codex 里运行 /plugins |
| Codex 何时使用 | 不会自己触发:由插件里负责搭建的 skill 调用,或者你点名使用。它不用于一般性的 UX 点评 |
| 源码 | GitHub 上的 openai/plugins |
它能做什么
这个 skill 需要两样东西:一份原始设计(Figma 节点、图片、截图或设计稿),以及一个渲染出来的实现(本地或已部署的 URL、App 界面或截图)。它把两者都打开,对齐视口、状态和主题,然后放进同一个对比输入里,而不是分开各看各的。
每份报告都必须覆盖五个方面:
- 字体和排版: 字体家族、字重、字号、行高、字间距和换行。
- 间距和布局: 外边距、内边距、网格、间隙、圆角和阴影。
- 颜色和 token: 配色、对比度、状态色,以及 CSS token 和设计稿的对应关系。
- 图片和素材: 裁切、清晰度和画面风格。如果真实的图片或 logo 被换成了 CSS 形状、手绘 SVG 或 emoji,QA 直接不通过。
- 文案: 应用里特有的文字。
问题按 P0 到 P3 分级,每一条都写明位置、依据、影响和具体的修改方法。这是一个循环:只要还有 P0、P1 或 P2 级问题,结果就一直是 blocked,直到 Codex 修好并重新对比。报告保存为 design-qa.md,结尾必须是 final result: passed 或 final result: blocked 其中之一。
什么时候用
Image to Code 和 URL to Code skill 运行完后会自动调用它。手上有一份设计稿和一个实现、想要一份如实列出差异的清单时,也可以自己调用。如果要审查整个流程,请改用 Audit skill。
试一试
使用 design-qa skill。在相同的桌面视口下,把运行在 localhost:5173 的应用和 mockup.png 对比。按严重程度列出差异,修好 P0 到 P2 级问题,并保存 design-qa.md。
Claude Code 里能用吗?
基本可以。对比方法、严重程度分级和报告格式都是普通的指令,评分标准文件也在文件夹里,所以可以把它复制到 ~/.claude/skills。带不过去的是:截图步骤指向 Product Design 插件的 Browser Choice 规则(也就是 Codex 内置浏览器),而 Figma 来源需要 Figma 的 MCP 服务器。你需要给 Claude Code 另配一种给实现截图的方式。