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 按偏好格式生成测试报告。
推荐工作流
- /pw:init 搭建配置、CI 与冒烟测试;
- /pw:generate 生成测试;
- /pw:review 在提交前检查定位器反模式与缺失断言;
- /pw:fix 在 CI 失败时诊断修复,随后本地运行 npx playwright test 确认无回归;
- /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。
限制 资料未提供收费、价格、支持平台、性能数据或效果保证;具体使用需以实际安装与文档为准。