用途:系统化审查 Playwright 测试文件,发现反模式、缺失的最佳实践和覆盖缺口。
输入:$ARGUMENTS 可为文件路径(审查该测试文件)、目录(审查目录下所有测试文件),留空则审查项目 testDir 中的全部测试。
主要能力:先读取 playwright.config.ts 并列出范围内所有 *.spec.ts / *.spec.js 文件,单文件审查时还会检查相关页面对象与 fixtures;随后对照 anti-patterns.md 检查 20 项反模式。严重问题包括 waitForTimeout()、非 web-first 断言、硬编码 URL、优先 role 时仍用 CSS/XPath、缺少 await、测试间共享可变状态、依赖执行顺序等;警告项包括测试超过 50 行、魔法字符串、缺少错误/边界用例、用 page.evaluate() 替代定位器、嵌套 describe 过深、测试名笼统等;提示项包括缺少页面对象、内联测试数据、可访问性断言、视觉回归测试、未检查控制台错误、用网络空闲等待替代具体断言、缺少 describe 分组等。
评分与报告:按 1-10 分评级(9-10 生产就绪,7-8 良好,5-6 有反模式,3-4 问题显著易 flaky,1-2 需重写),逐文件输出问题行号、原因与改进建议;项目级审查可用子代理并行(最多 5 个并发)或 /batch 汇总为总表。最后针对严重问题给出修正代码,并询问是否应用修复。
适用场景:用户说 review tests、check test quality、audit tests、improve tests、test code review 等时。
限制:资料未提供安装方式、运行命令、平台与收费信息;审查依据内置反模式清单,非资料未涵盖的规则不在范围内。