技能介绍

手动编写 Playwright 测试的常见痛点

手动为项目编写 Playwright 测试时，开发者常面临一系列重复且易出错的工作：需要从零梳理用户故事对应的测试场景、逐个探索代码库中的组件结构、现有测试规范和约定，手动匹配适合的测试模板，再严格遵循 Playwright 的官方推荐规范生成测试代码，最后还要反复运行验证并修复问题。整个过程耗时久，且容易因个人习惯差异导致测试代码风格不统一、不符合项目约定，甚至遗漏关键边界场景。

技能的核心工作逻辑

该技能通过结构化的步骤简化了测试生成流程：

输入解析：接收 $ARGUMENTS（支持用户故事、URL、组件路径、功能描述），提取待验证的行为、目标组件/页面等核心信息；
代码库探索：调用 Explore 子代理读取 playwright.config.ts、现有测试、组件源码等，摸清项目的测试目录、fixtures、页面对象、认证配置等约定；
模板匹配：根据测试场景类型（如登录、CRUD、结算流程等）从 templates/ 目录加载对应模板，替换占位符为实际项目的 selector、URL 和测试数据；
规范生成：严格遵循 Playwright 官方推荐的 getByRole() 等定位优先级，使用 web-first 断言，避免 page.waitForTimeout() 等反模式；同时适配项目的 TypeScript/JavaScript 环境、页面对象、自定义 fixtures 等约定；
自动验证：运行生成的测试，若失败则读取错误并修复测试（而非修改应用代码），最后输出测试结果和覆盖说明。

适用边界与注意点

该技能依赖项目已具备基础的 Playwright 测试配置（如 playwright.config.ts），更适合针对用户故事、组件、页面或功能模块生成端到端或组件级测试。若项目无现成的页面对象、测试 fixtures 或测试数据目录，技能会根据需要创建对应支持文件，但高度定制化的测试场景（如涉及复杂第三方服务 mock、自定义测试拦截逻辑）可能需要开发者后续手动调整生成的测试代码。