用途:把手动测试用例(markmap + Schema)转换为 Playwright spec,在浏览器中运行验证,发现 Bug 后收集证据并输出测试报告。适用于 execution_model 为 ui 且 automation.supported 不为 no 的用例;无 UI 的协作用例应移交 api-testing 或保持手动。
主要能力:工作流零做小规模业务踩点(截图、枚举可交互元素、记录选择器与 API、编写 Page Object);工作流一解析用例、复用或新建 Page Object、编写 spec 并运行 npx playwright test tests/{文件名}.spec.ts;工作流二按 UI 不一致、表单校验、网络异常、数据一致性、状态流转、控制台错误等策略发现 Bug,用截图与 API/控制台日志收集证据,写入测试报告。
使用方式:先熟悉业务再写测试,有疑问必须向用户提问,不自行假设;每条自动化用例对应一条手动用例,每个 test 只测一个点且独立(自建数据 + 自清理);正式测试必须使用 Page Object,禁止裸写定位器。工程约定、场景模板、Page Object 规范见 references/playwright-conventions.md,通用 Helper 见 references/helpers_reference.md。等待策略按 auto-wait + expect 断言、waitForResponse、networkidle 依次降级,固定 waitForTimeout 仅临时调试。
限制:首轮运行 0 条通过视为流程认知错误,需回踩核实后再交付;一轮失败 ≥3 条先做四分类分流,仅真缺陷进入证据收集;Bug 确认后的根因定位、影响分析、回归建议移交 bug-analysis;单元测试、性能压测、安全测试不在范围内。探索文件 explore-*.spec.ts 属临时产物,知识提取后应删除。具体脚手架、配置与命令细节以资料所述 references 为准,其余未提供。