跳转到主要内容
返回 Skill 列表
playwright-cli 图标

playwright-cli

Playwright 官方面向编码 Agent 的浏览器自动化 CLI + Skill,单任务比 MCP 方案省约 9 万 token

test-automationplaywrightE2E浏览器自动化

场景示例

  • 「跑一遍下单流程,每一步截图给我」——自动化操作页面并留档
  • 「这个 E2E 用例挂了,帮我调一下」——录制/检查 trace 定位失败点
  • 「登录一次把状态存下来,后面测试直接复用」——cookies / localStorage 持久化与恢复
  • 「根据我刚才的点击操作生成一个回归测试」——从交互生成 Playwright 测试

为什么用 CLI 而不是 MCP

Skill 内置完整命令参考(SKILL.md),让 AI 精准使用命令语法而不是靠猜;CLI 把完整 a11y 树落盘、只给模型发摘要,单任务比 Playwright MCP 少约 9 万 token。别装成 claude mcp add ... @playwright/mcp。

避坑清单

  • 装完 Skill 必须重启会话:Skill 在会话启动时加载,不重启的话 AI 感知不到,会退回手写 Playwright 脚本硬跑
  • 浏览器要单独装:playwright-cli install-browser --with-deps,chromium 可换 firefox / webkit,每个占盘约 180-280 MB(官方实测 chromium 281M / firefox 187M / webkit 180M),磁盘紧张先清空间
  • Skill 默认装进当前项目的 .claude/skills:要全局可用,用下方全局安装或把 skill 目录拷到 ~/.claude/skills/playwright-cli/
  • AI 没在用 CLI 时按序排查:playwright-cli --help 确认可执行 → playwright-cli install --skills 确认 Skill 在位 → 重启会话
  • 需要 Node.js 20+

全局安装(所有项目可用)

bash
npm install -g @playwright/cli@latest
playwright-cli install --skills