SuperAPI AI 工具集

review

测试与质量

查看项目

更新于 10-15 16:48

技能介绍

用途:系统化审查 Playwright 测试文件,发现反模式、未遵循的最佳实践和覆盖缺口。输入 $ARGUMENTS 可为单个文件路径、目录,或留空以审查项目 testDir 下的全部测试。

主要能力:先读取 playwright.config.ts 并列出范围内的 *.spec.ts / *.spec.js;单文件审查时还会检查相关 page object 与 fixture。随后依据该技能目录中的 anti-patterns.md 检查 20 项反模式,分为三级:严重(如 waitForTimeout()、非 web-first 断言 expect(await ...)、硬编码 URL 而非 baseURL、可用 role 定位时仍用 CSS/XPath、缺少 await、测试间共享可变状态、依赖执行顺序);警告(如测试超过 50 行、魔法字符串、缺少错误与边界用例、用 page.evaluate() 做定位器可完成的事、test.describe() 嵌套超过两层、测试名过于笼统);提示(如 5 个以上定位器的页面未用 page object、内联测试数据、缺少可访问性断言、UI 密集页面无视觉回归测试、未检查控制台错误、用网络空闲等待代替具体断言、缺少 test.describe() 分组)。

评分与报告:按 1-10 分评估每个文件(9-10 生产就绪,7-8 良好,5-6 可用但有反模式,3-4 问题较多易不稳定,1-2 需重写)。报告按文件列出严重、警告与建议项,并标注行号与修改方向。项目级审查可对每个文件派生子代理并行处理(最多 5 个并发),或用 /batch 处理大型套件,最后汇总为总文件数、平均分、严重问题数与可执行修复清单,并指出无测试覆盖的页面或功能。

修复:针对每个严重问题提供修正代码,并询问用户是否应用;确认后使用 Edit 工具应用全部修复。

限制:资料未说明支持的 Playwright 版本、运行环境、是否收费或价格,也未提供安装命令与具体平台信息。