Communitygithub.com

MigoXLab/webqa-agent

使用 WebQA 从真实用户角度测试网站、网页、URL、登录流程、搜索流程、表单、导航及核心用户旅程。

webqa-agent 是什么?

WebQA 是一个基于 AI 浏览器的 QA 代理技能,专为从真实用户视角测试网站和网页而设计。它支持测试广泛的场景,包括常规页面加载、登录流程、搜索功能、表单提交、导航操作以及核心用户旅程。该技能通过读取参考文件夹中的 `mini-agent.md` 来定义具体测试任务,并可选择配置 MCP 服务器、API 密钥或其他环境变量(通过 `references/setup.md`)。对于需要身份验证的测试,它支持通过浏览器 cookies 进行认证(参考 `references/cookies.md`),并能处理常见的 API 错误、执行超时或报告缺失等问题(参考 `references/troubleshooting.md`)。WebQA 默认在用户提供 URL 时执行轻量级代理任务,验证首页加载、核心入口点可见性及主要交互无错误,同时强调测试完成不等于测试成功,最终通过/失败结果必须来源于测试报告或已记录的降级逻辑。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MigoXLab/webqa-agent/tree/HEAD/skills/webqa

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

WebQA

当用户希望对网站或页面进行真实用户视角的测试时,请使用 WebQA。

路由

  • 对于常规网站、页面、URL、功能、登录、搜索、表单、导航或核心流程的测试,请阅读 references/mini-agent.md。
  • 对于 MCP 服务器安装、API 密钥设置、IDE 配置或环境变量,请阅读 references/setup.md。
  • 对于使用浏览器 cookies 进行身份验证的测试,请在运行测试前阅读 references/cookies.md。
  • 对于 API 错误、执行超时、报告缺失、工作者限制错误或执行卡住的情况,请阅读 references/troubleshooting.md。

默认行为

  • 如果用户提供了 URL 但未指定具体目标,则运行默认的迷你代理任务:验证首页正常加载、核心入口点可见,且主要交互无明显错误。
  • 如果用户描述了测试目标但未提供 URL,则在运行 WebQA 之前询问 URL。
  • 保持任务聚焦于一个 URL 和一个自然语言目标。
  • 不要将执行完成视为测试成功;最终的通过/失败报告必须来自测试报告或已记录的降级逻辑。

边界

  • 此公开技能公开了 WebQA 的 MCP 快速模式测试工作流程。
  • 在参考文件创建之前,不要承诺未来的能力。
  • 在常规公共页面测试中,除非需要该上下文,否则不要加载 cookies.md、setup.md 或 troubleshooting.md。

相关技能