调试 Playwright 测试再也不用点开 GUI 了：这个 Skill 让看 trace 变成 CLI 爽局

做自动化测试的同学，多少被 Playwright 的 Trace Viewer 折磨过：测挂一次，打开 GUI 慢慢翻 actions、requests、console、截图，找根因像寻宝。

playwright-trace 就是来解决这个的。它是微软官方打包的 Agent Skill，直接把 Playwright 的 .zip trace 包丢进命令行就能拆，不用开浏览器、不用等 GUI 加载。

它到底能做什么

简单说就是把 Trace Viewer 的核心能力全搬到了终端里：

• trace open：导入 trace zip，立刻看到浏览器、视口、持续时间、错误数
• trace actions：用树状图列出所有操作，支持按标题 grep，只看失败用例 --errors-only
• trace action <id>：单步深挖某个操作——参数、返回、日志、源码位置、截图快照
• trace requests：所有网络请求一览，可按 URL / 方法 / 失败状态过滤
• trace console / trace errors：控制台输出和报错直接看
• trace snapshot：冻结当前 action 的 DOM 快照，还能直接执行 eval 查询页面元素，或导出截图
• trace attachments：列出并导出 trace 里的附件

为什么值得装

定位清晰：它不是重新造轮子，而是把 Playwright 已经内置但藏在 GUI 里的 CLI 能力，整理成一个 Skill 让 Claude / Codex 直接调用。安装完说一句”帮我看看这个 trace”，AI 就能自主完成排查。

跨工具兼容：Skill 里声明了 allowed-tools: Bash(npx:*)，意味着任何支持 Bash 的 Agent 都能用。Claude Code、Cursor、Manus 都能直接接。

轻量无负担：不需要额外装服务，靠 npx playwright 现成能力，Skill 只是一个编排层。对已经在用 Playwright 的团队几乎零迁移成本。

适用场景

• nightly build 失败，要快速定位某次 flaky test 的根因
• CI 里跑完 Playwright，只上传了 trace zip，本地不用 GUI 就能看
• 让 AI Agent 自主排查 E2E 失败，把 trace 丢进去自动总结

一句话总结

如果你团队在用 Playwright，这个 Skill 是把”开 GUI 看 trace”这件事从 5 分钟压缩到 30 秒的官方捷径。

GitHub：https://github.com/microsoft/playwright/tree/main/packages/playwright-core/src/tools/trace

GitHub: https://github.com/microsoft/playwright/tree/main/packages/playwright-core/src/tools/trace