SuperAPI AI 工具集

playwright-reviewing

测试与质量

查看项目

更新于 10-16 06:46

技能介绍

用途:审查 Playwright E2E 测试代码,找出会导致测试不稳定、掩盖缺陷或降低可维护性的反模式。不适用于编写新测试、单元测试审查、纯 API 测试审查,以及 Cypress 等非 Playwright 的 E2E 框架。

主要能力:按严重程度分级检测违规。严重级包括模拟自身应用 API(page.route('/api'))、跳过测试(test.skip、.skip()、test.fixme)和注释掉的测试;高优先级包括 waitForTimeout、CSS 类选择器(.locator('.'))、手动断言(isVisible()).toBe 等)以及 expect(await 模式;中优先级包括对 Mantine 组件使用 selectOption、缺少测试隔离、定位器选择不佳;低优先级为改进建议,如优先用 getByRole、补充描述性测试名、用 describe 分组。

使用方式:先用 find 或 ls 定位测试文件,再并行运行 grep 检查,例如 grep -rn "waitForTimeout|test.skip|.skip(|page.route('/api|.locator('.|isVisible()).toBe" --include=".spec.ts" --include=".test.ts",随后逐文件人工复核定位器质量、断言质量、测试结构与 Mantine 组件处理,最后按模板输出分级报告。

适用场景:合并前审查、PR 评审、E2E 测试质量审计。限制:仅针对 Playwright;模拟外部第三方 API 是允许的,需区分被模拟 URL 是否属于自身应用;Mantine 的 selectOption 需结合上下文判断。相关技能包括 playwright-writing、run-tests、quality-check,并可配合 playwright-e2e-expert 智能体使用。