Codex 的 Frontend Testing Debugging skill
Frontend Testing Debugging 让 Codex 证明 UI 改动在浏览器里确实可用,而不只是能通过构建。它会打开页面,跑一组固定的检查,实际操作你改过的流程,然后附上截图汇报结果。它包含在 OpenAI 的 Build Web Apps 插件里。
更新于 2026年11月12日 · 阅读约 3 分钟
速览
| Skill 名称 | frontend-testing-debugging |
| 来自 | OpenAI 的 Build Web Apps 插件 |
| 安装 | codex plugin add build-web-apps@openai-curated,或者在 Codex 里用 /plugins |
| Codex 何时使用 | 测试、调试或改进渲染出来的前端时:开发服务器、UI 回归、点击无效、控制台报错、布局问题 |
| 源码 | GitHub 上的 openai/plugins |
它能做什么
只要改动了渲染出来的页面,这个 skill 就走同一个循环:用一句话说明要测的流程,选一个浏览器,做最小的有效修改,检查结果,然后汇报。
有 Codex Browser 插件时它就用这个插件;没有的话,它会退回到 Playwright,并说明原因。在宣称 App 正常之前,它会检查六件事:
- URL 和标题对应的是正确的页面
- 页面不是空白的
- 没有 Next.js、Vite 或 Webpack 的错误遮罩层
- 控制台里没有相关的错误或警告
- 任何关于视觉效果的说法都有截图佐证
- 流程里至少做过一次交互,并在之后检查状态
它还会在桌面和一种手机尺寸下检查内容被裁切、元素重叠、换行异常、素材缺失和 z-index 问题。最后的回复按 QA 报告的格式写:摘要、环境、各项检查的通过/失败表、测试过的交互、剩余风险,最后集中放截图。除非你要求,它不会把报告或截图写进你的仓库。
什么时候用
只要 Codex 改动了你能看到的 UI,就用它。它能抓住一种常见情况:构建通过了,但页面是空白的、报错,或者按钮点了没反应。
试一试
修复并验证失效的交互
用 frontend-testing-debugging skill。我们数据看板的交易页面上,搜索筛选不会更新表格。找到 bug,修好它,并在浏览器里用桌面和手机尺寸验证。
Claude Code 里能用吗?
能用一部分。首选路径用的是 Codex Browser 插件和它的 agent.browser API,Claude Code 没有这些。Playwright 备用路径只是普通的 shell 命令,所以把文件夹复制到 ~/.claude/skills 后,Claude Code 可以走这条路径,并沿用 QA 报告格式。