关于 browser-qa
用于根据指定改动及其规格检查运行中应用的浏览器 QA 技能。它以运行时观察作为证据,并生成包含截图和视频引用的通过或失败结论。
主要功能
- 01确定测试范围和规格来源
- 02端到端操作应用流程
- 03检查相关边缘情况
- 04报告通过或失败
- 05关闭浏览器会话和应用进程
适用场景
- 01依据功能规格验证分支
- 02测试运行中应用的改动流程
- 03为 QA 报告收集证据
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ angusfretwell/ skills --skill browser-qa安装后在 Claude Code 中输入/browser-qa确认已加载。
详细介绍
验证是运行时观测:从运行中的应用捕获的内容才是证据;测试和类型检查是 CI 的输出,不是你的。
步骤
1. 确定测试范围
用户说明的内容就是范围(提交 SHA、分支名称、标签、main、HEAD~5)。如果用户没有指定,请询问。
2. 确定规范来源
按以下顺序查找源规范:
- 提交消息中的 issue 引用(
#123、Closes #45、GitLab!67),通过docs/agents/issue-tracker.md中的工作流获取。 - 用户作为参数传入的路径。
docs/、specs/或.scratch/下与分支名称或功能相匹配的规范文件。- 如果没有找到,请询问用户规范在哪里。
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 运行,直到会话关闭。每次退出时都必须清理,包括拒绝执行的情况。
报告以判定开头且清理已完成后,任务即完成。