Playwright Pro 测试工具包
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 安装 @user_3c6cb52e/breeze-playwright-pro 技能,在 AI 助手中启用 Playwright 测试工具包。
技能介绍
要解决的测试痛点
AI 编码代理写 Playwright 测试常踩三类坑:用 #submit-btn 或 [data-testid] 这类脆弱选择器,页面改版后测试大面积崩坏;手写断言绕过 web-first 机制,元素未加载时直接失败;以及 Cypress/Selenium 迁移时映射表不清,导致覆盖缺失或重复劳动。这些问题在持续集成中会表现为随机 flaky tests,排查成本极高。
技能如何运作
Playwright Pro 把测试生命周期拆成 9 个 /pw: 命令:/pw:init 自动探测框架并生成配置与 CI 脚本;/pw:generate 从用户故事、URL 或组件生成初版测试;/pw:review 在提交前拦截选择器反模式和缺失断言;/pw:fix 诊断并修复失败用例;/pw:migrate 提供 Cypress/Selenium 到 Playwright 的映射表。
核心能力还包括 3 个专属代理(test-architect、test-debugger、migration-planner)、55 个场景模板(登录、CRUD、结账、搜索、表单、无障碍等)、以及 TestRail 与 BrowserStack 的 TypeScript MCP 集成。配套的 locator 优先级强制 getByRole 优先于 CSS/XPath,10 条黄金法则覆盖重试、隔离、fixtures 和 trace 配置,确保生成的测试天然贴近 Playwright 最佳实践。
适用边界与注意点
AI 生成的测试仍需要人工审查,尤其是涉及权限边界和业务规则的断言逻辑。技能只允许 mock 外部服务,绝不能 mock 自身应用,否则会掩盖真实集成缺陷。TestRail 和 BrowserStack 为可选项,需自行配置环境变量和凭据。对于自定义 fixture 或 storageState 的高级模式,建议参考 reference/ 目录下的 6 篇文档。
使用场景
- 为 AI 编码代理提供生产级 Playwright 测试生成、审查、修复与迁移工作流
- 需要从用户故事、URL 或组件快速生成 Playwright 测试用例时
- 使用 Cypress 或 Selenium 迁移到 Playwright,并确认旧套件覆盖对等
- 需要在 CI 和本地中稳定运行 Playwright 测试,减少 flaky tests 与调试成本
适合人员
- 需要在 AI 编码代理中集成 Playwright 测试的工程师
- 维护前端测试套件并希望减少选择器脆弱性与 flaky tests 的开发者
- 正在将 Cypress 或 Selenium 迁移到 Playwright 的测试负责人
- 使用 TestRail 或 BrowserStack 管理跨浏览器测试结果的 QA