网页自动化测试

技能简介

web-qa-bot 是一款基于 AI 的 Web 应用 QA 自动化工具，通过浏览器可访问性树（accessibility tree）定位页面元素，替代易失效的 CSS 选择器，支持冒烟测试、无障碍检测与视觉回归验证。

能做什么

• 一键执行网站健康检查（页面加载、控制台错误、导航元素、图片 alt 文本）
• 编写 YAML 测试套件验证关键业务流程（登录、支付等）
• 生成 Markdown/PDF/JSON 多格式测试报告
• 接入 CI/CD 流水线实现部署前自动质检
• 通过编程 API 在 TypeScript 代码中调用测试能力

使用说明

安装指令

npm install -g web-qa-bot agent-browser
agent-browser install

快速开始

1. 执行冒烟测试：web-qa-bot smoke https://example.com
2. 运行测试套件：web-qa-bot run ./tests/suite.yaml --output report.md
3. 生成 PDF 报告：web-qa-bot report ./results.json -o report.pdf -f pdf

调试模式：添加 --no-headless 参数以可视化浏览器运行过程；使用 agent-browser snapshot 查看当前页面可用元素引用。

输入与输出

见下方输入与输出表格。

风险提示

• 依赖 agent-browser 底层组件，需确保全局安装且完成初始化
• 动态加载内容可能导致元素定位超时，建议增加 waitMs 或 waitFor 步骤
• 无障碍树依赖页面正确实现 ARIA 属性，老旧页面可能识别不全
• PDF 报告生成需额外依赖 ai-pdf-builder 模块

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/nextfrontierbuilds/web-qa-bot/SKILL.md
来源类型：GitHub 仓库