SuperAPI AI 工具集

playwright-pro

测试与质量

查看项目

更新于 11-02 02:29

技能介绍

Playwright Pro 是面向 AI 编程代理的生产级 Playwright 测试工具包,安装为 Claude Code 插件后以 /pw: 命令形式使用。

主要能力

  • 初始化:/pw:init 检测框架、生成配置、CI 和首个测试。
  • 生成:/pw:generate <spec> 根据用户故事、URL 或组件生成测试。
  • 审查:/pw:review 检查反模式与覆盖缺口。
  • 修复:/pw:fix <test> 诊断并修复失败或不稳定测试。
  • 迁移:/pw:migrate 从 Cypress 或 Selenium 迁移到 Playwright。
  • 覆盖:/pw:coverage 分析已测与缺失内容。
  • 集成:/pw:testrail 同步 TestRail 用例与结果;/pw:browserstack 在 BrowserStack 上运行并拉取跨浏览器报告。
  • 报告:/pw:report 按偏好格式生成测试报告。

推荐工作流

  1. /pw:init 搭建配置、CI 与冒烟测试;
  2. /pw:generate 生成测试;
  3. /pw:review 在提交前检查定位器反模式与缺失断言;
  4. /pw:fix 在 CI 失败时诊断修复,随后本地运行 npx playwright test 确认无回归;
  5. /pw:migrate 后用 /pw:coverage 确认与新套件一致再下线旧测试。

内置内容 9 个技能、3 个专用代理(test-architect、test-debugger、migration-planner)、55 个测试模板(auth、CRUD、checkout、search、forms、dashboard、settings、onboarding、notifications、API、accessibility)、2 个 TypeScript MCP 服务器(TestRail、BrowserStack)、自动校验测试质量与检测 Playwright 项目的智能钩子、6 份参考文档及 Cypress/Selenium 迁移指南。

黄金规则与定位器优先级 优先使用 getByRole(),避免 CSS/XPath;禁止 page.waitForTimeout(),改用 web-first 断言;每个测试相互隔离;配置 baseURL;CI 重试 2 次、本地 0 次;trace 设为 'on-first-retry';使用 fixtures 而非全局变量;每个测试只验证一个行为;仅 mock 外部服务。定位器优先级依次为 getByRole()、getByLabel()、getByText()、getByPlaceholder()、getByTestId()、page.locator()。

集成配置 TestRail(可选)需设置 TESTRAIL_URL、TESTRAIL_USER、TESTRAIL_API_KEY;BrowserStack(可选)需设置 BROWSERSTACK_USERNAME、BROWSERSTACK_ACCESS_KEY。

限制 资料未提供收费、价格、支持平台、性能数据或效果保证;具体使用需以实际安装与文档为准。