mcpField
B
browser-qa

browser-qa

github.com/angusfretwell测试与质量171 次安装4 天前更新
代码仓库

关于 browser-qa

用于根据指定改动及其规格检查运行中应用的浏览器 QA 技能。它以运行时观察作为证据,并生成包含截图和视频引用的通过或失败结论。

主要功能

  1. 01确定测试范围和规格来源
  2. 02端到端操作应用流程
  3. 03检查相关边缘情况
  4. 04报告通过或失败
  5. 05关闭浏览器会话和应用进程

适用场景

  1. 01依据功能规格验证分支
  2. 02测试运行中应用的改动流程
  3. 03为 QA 报告收集证据

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/angusfretwell/skills --skill browser-qa

安装后在 Claude Code 中输入/browser-qa确认已加载。

详细介绍

验证是运行时观测:从运行中的应用捕获的内容才是证据;测试和类型检查是 CI 的输出,不是你的。

步骤

1. 确定测试范围

用户说明的内容就是范围(提交 SHA、分支名称、标签、main、HEAD~5)。如果用户没有指定,请询问。

2. 确定规范来源

按以下顺序查找源规范:

  1. 提交消息中的 issue 引用(#123、Closes #45、GitLab !67),通过 docs/agents/issue-tracker.md 中的工作流获取。
  2. 用户作为参数传入的路径。
  3. docs/、specs/ 或 .scratch/ 下与分支名称或功能相匹配的规范文件。
  4. 如果没有找到,请询问用户规范在哪里。
3. 操作

如果未安装 agent-browser,请拒绝:停止并告知用户。调用 run 技能,获取应用正在提供服务的 URL;如果应用无法运行,同样拒绝。

调用 agent-browser 技能,并通过 agent-browser skills get dogfood --full 加载其 dogfood 工作流;--full 会内嵌报告模板和边缘情况检查清单。针对该 URL 按照工作流操作,但有以下两处调整:

  • 范围限定为差异,而不是整个应用。你只能阅读差异中的代码,并且只能用来列出其影响的流程。
  • 报告就是你的回复,而不是一个文件;引用截图和视频时使用绝对路径。

端到端操作此次更改影响的每个流程,然后从边缘情况检查清单中选取适用于此次更改的探测项。

如果任务说明提供了测试夹具,即已准备好的测试数据,就使用它们操作相关流程,只补充它们缺少的内容。

4. 判定

报告第一行必须给出判定:pass 或 fail。任何破坏指定行为或未通过探测的问题,都判定为 fail。没有部分通过:任何未完成项都算 fail,同时注明已通过的部分。

然后清理你启动的内容:使用 agent-browser --session <name> close 关闭你打开的每个浏览器会话,并停止你启动的任何应用进程,但要保留你发现已经在运行的进程。每个会话都会保持一个无头 Chrome 运行,直到会话关闭。每次退出时都必须清理,包括拒绝执行的情况。

报告以判定开头且清理已完成后,任务即完成。

评论

支持 Markdown