用途:该技能用于编写 Playwright 端到端测试、调试不稳定测试与间歇性 CI 失败、搭建视觉回归、用 request context 测试 API、配置 CI,以及从 Cypress、Puppeteer、Selenium 迁移。基础“写一个测试”任务 Claude 已能处理,此技能补充生产环境常用模式。
主要能力:首次激活时若技能目录无 config.json,会询问并保存 baseURL、testDir、authStrategy、ciProvider、browsers、screenshotBaseline,用于生成配置片段。覆盖认证(storageState、global setup、多角色项目)、CI 分片与缓存、Docker、视觉回归、网络拦截与 mock、自定义 fixture、页面对象、组件测试(React/Vue/Svelte)。
关键陷阱:storageState 不含 sessionStorage;page.route() 不拦截 iframe 请求,需用 context.route();截图基线依赖操作系统、浏览器与 DPI,应在 CI 相同环境生成;fullyParallel 与共享数据库会冲突;workers 与 shards 含义不同;SSR 水合前点击可能无效;page.clock.install() 须在导航前调用;toHaveText 默认子串匹配;route.fulfill 的 json 与 contentType 有优先级;直接用 browser.newPage() 会破坏隔离。
用法:按需加载 references 下的定位策略、认证模式、不稳定测试手册、CI 优化、组件测试文档。可选 /careful 对 --update-snapshots、rm -rf test-results/、rm -rf .auth/、npx playwright install --force 等命令加确认。技能会记录 .playwright-skill/run-log.json 以追踪不稳定测试。
限制:不适用于 Jest/Vitest 单元测试、与测试无关的 Puppeteer 脚本及首次项目搭建。