SuperAPI AI 工具集

qa

测试与质量

查看项目

更新于 10-16 08:28

技能介绍

用途

QA 是一个智能浏览器测试技能,目标是自动化开发者通常手动完成的验证工作:打开页面、执行交互、触发 API 调用、检查结果。它适用于需要快速验证某个页面或流程是否正常工作的场景,例如“创建一个含 3 种食材的食谱,并验证营养计算是否正确”,或“访问 http://localhost:3000/orders,点击 New Order,填写供应商并提交”。

主要能力

  • 使用 Playwright MCP 进行页面导航、元素快照、点击、填表、选择、等待响应、检查网络请求和控制台错误。
  • 使用 agent-browser 进行视频录制和视觉前后差异对比。
  • 支持自然语言流程描述,或 URL 加操作说明两种输入方式。
  • 未提供 URL 时默认使用 http://localhost:3000。
  • 自动检测登录状态,若未登录会提示用户手动登录。
  • 按步骤输出 PASS/FAIL 报告,包含观察结果、API 状态、截图路径和控制台错误。
  • 在完成影响 UI 的代码改动后,可主动询问用户需要 QA 的流程并自动执行。

使用方式

  1. 准备:创建 .qa 目录,并确保其被 .gitignore 忽略。检查开发服务器是否可达,若不可达则请用户启动。
  2. 认证检查:通过 Playwright MCP 导航到目标 URL,获取页面快照,查找登录表单标志(如 input[type=password]、URL 中的 /login、认证相关文本)。若未登录,提示用户手动登录后继续。
  3. 执行测试流:将用户流程解析为编号步骤,启动一个子代理,按规则选择工具执行。每个步骤先获取最新元素引用,再执行交互,截图,检查网络请求和控制台错误。
  4. 报告:子代理完成后输出合并报告,包含每步结果、API 调用、截图、控制台错误、视频文件路径,并给出总体判定(ALL PASS / PARTIAL / FAIL)。

适用场景

  • 前端页面或流程的端到端验证。
  • 代码改动后快速回归检查 UI 是否正常。
  • 需要记录操作视频和截图用于调试或存档。
  • 需要检查 API 调用状态和控制台错误。

限制

  • 依赖 Playwright MCP 和 agent-browser 工具。
  • 需要开发服务器已启动且可访问。
  • 若页面需要登录,需用户手动完成登录。
  • 具体收费、价格、平台支持范围等信息暂未提供。