用途
该技能用于为 Playwright 测试开发提供覆盖全流程的实践指导，从编写新测试，到调试失败、修复不稳定用例、维护已有测试套件，以及配置 CI/CD 与优化性能。
主要能力与主题范围
技能采用“按活动检索”的参考指南组织方式，把你要做的事情映射到对应参考文件：
- 编写新测试：E2E、组件、API、GraphQL、可视化回归、Canvas/WebGL、无障碍、表单校验、拖拽、i18n、Electron、浏览器扩展、多用户等。
- 结构与数据：Page Object Model、fixtures/hooks、测试数据、认证与认证流程、注释与测试标签。
- 移动与响应式：设备模拟、触摸手势、视口/断点、移动端 UI。
- 实时与浏览器 API：WebSocket、地理位置、权限、剪贴板、摄像头/麦克风模拟、多标签/弹窗、OAuth 弹窗。
- 调试与排障：测试失败、元素找不到、超时、竞态、并行下不稳定、状态泄漏、选择器问题、trace viewer、控制台/JS 错误。
- 错误与边界：错误边界、网络失败模拟、离线、Service Worker、加载状态、表单校验。
- 架构决策：POM 与 fixtures 取舍、测试类型选择、Mock 与真实服务、测试套件结构。
- 框架特定：React、Angular、Vue/Nuxt、Next.js。
- 重构与维护：迁移到 POM、改进组织、抽取 setup/teardown、替换脆弱选择器、移除显式等待、测试数据工厂、配置。
- 基础设施与配置：项目配置、CI/CD、GitHub Actions、GitLab CI、其他 CI、Docker、全局 setup/teardown、项目依赖、性能优化、并行与分片、覆盖率、报告与产物。
- 高级模式：API 响应 Mock、网络拦截、GraphQL Mock、HAR 录制/回放、自定义 fixtures、高级等待策略、OAuth/SSO、支付网关、邮件/短信验证模拟、控制台错误、安全测试、性能预算与 Web Vitals、Lighthouse 集成、测试注释与标签、测试步骤。
使用方式
资料提供了“快速决策树”，根据你正在做的事情定位参考文件。例如：
- 写 E2E 测试 → core/test-suite-structure.md、core/locators.md、core/assertions-waiting.md
- 写组件测试 → testing-patterns/component-testing.md
- 写 API 测试 → testing-patterns/api-testing.md、core/test-suite-structure.md
- 修复不稳定测试 → debugging/flaky-tests.md、debugging/debugging.md、core/assertions-waiting.md
- 配置 CI/CD → infrastructure-ci-cd/ci-cd.md、infrastructure-ci-cd/github-actions.md
资料还给出“测试验证循环”：
- 运行测试：npx playwright test --reporter=list
- 若失败：查看错误输出与 trace（npx playwright show-trace），修复定位器、等待或断言，然后重跑。
- 全部通过后再继续；关键测试多次运行：npx playwright test --repeat-each=5
适用场景
适合团队在以下工作中参考：新建或重构 Playwright 测试套件、排查 flaky 与超时问题、设计测试架构、处理认证与第三方依赖、搭建 CI/CD、并行分片、性能与覆盖率、以及编写安全、无障碍、可视化等专项测试。
限制与未提供信息
资料未提供安装命令、收费与价格、平台范围、版本兼容性等细节；上述内容暂未提供。