SuperAPI AI 工具集

browser-qa

测试与质量

查看项目

更新于 10-15 21:42

技能介绍

用途:面向浏览器端功能与页面的三层测试工作流,依次为确定性 E2E 测试(Layer 1)、AI 自主验收(Layer 2)、调试诊断(Layer 3)。参数格式为 [layer1|layer2|layer3|all] <目标描述>,前缀可选,无前缀时按意图推断,意图模糊则询问用户。

主要能力:Layer 1 用纯 Playwright 原生代码生成并运行 E2E 测试,要求 data-testid 选择器、独立用例、Arrange-Act-Assert 结构与有效业务断言;Layer 2 通过 Playwright MCP 让 AI 自主探索界面,按定制检查项与通用项生成验收清单,逐项串行执行并取证,对 fail/warn 项做对抗复核,对 pass 项做独立证据审计,结果分为通过、警告、阻塞、未验证;Layer 3 针对失败项分类诊断,使用 Playwright MCP、Chrome DevTools MCP 或 Browser Harness 定位根因,根因需经假设验证。

使用方式:先运行环境检测脚本 node <skill-base-directory>/scripts/detect-env.mjs [--cwd <project>],按 suggestions 处理;未配置 Playwright 时用 npm install -D @playwright/test 与 npx playwright install chromium 非交互安装;运行测试用 npx playwright test <文件路径> --reporter=list。Layer 2 需 Playwright MCP,Layer 3 推荐 chrome-devtools MCP,Shadow DOM/iframe 场景可选 Browser Harness(安装需用户同意)。

适用场景:E2E 与回归测试编写、界面验收、UI 自动化验收、页面交互与渲染问题诊断。

限制:Layer 1 不使用 MCP 与 LLM;Layer 2 不适合 CI,消耗 Token 且需手动触发;Playwright MCP 为单浏览器会话,禁止并行驱动;无证据不得判为通过;非 Node.js/Playwright 技术栈时 Layer 1 可适配其他框架。具体收费、价格与平台信息暂未提供。