关于 verify-in-browser
通过实际浏览器操作验证应用改动的测试技能,面向需要检查用户流程的开发者。它根据需求整理测试用例,再按角色分派浏览器操作,并按预期结果汇报观察。
主要功能
- 01从需求或代码改动推导测试用例
- 02记录角色、入口、步骤和预期
- 03按角色并行分派浏览器测试
- 04按通过、差异或未到达汇报
- 05保留测试过程中的环境修复记录
适用场景
- 01验证合并请求涉及的用户流程
- 02检查不同角色可见的应用页面
- 03确认改动是否符合预期行为
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ l0st0/ skills --skill verify-in-browser安装后在 Claude Code 中输入/verify-in-browser确认已加载。
附带文件agents/openai.yaml
详细介绍
在浏览器中验证
代码审查会阅读差异;这会实际操作构建好的产品并报告其行为。你负责推导、准备和报告;子 Agent 负责实际操作。
1. 推导测试用例
按优先顺序采用第一个适用的输入:规范或工单、PR、与默认分支相比的分支差异,以及用户提供的任何内容。如果什么都没有,就停止并询问要测试什么。根据输入列出此次变更涉及的用户角色——不明确时列出所有角色——以及涉及的页面。每个测试用例都包含一个用户角色、一个入口、操作步骤,以及根据输入推断出的预期结果;报告中要说明推断依据,以便通过阅读发现预期是否有误。
完成标准:每个测试用例都包含以上四项。
2. 加载项目文件
docs/verify-in-browser.md 用四个部分记录仓库本身无法说明的信息:Serve——启动命令和基础 URL;Personas——每个角色及其登录方式,凭据使用环境变量名,除非字面值已提交在种子脚本中;Data——种子数据或重置命令,以及如何让每位测试者的数据彼此隔离;Gotchas——配置中未说明的注意事项。如果文件缺失,就全面检查仓库,查找启动脚本、种子脚本和测试凭据,通过实际运行验证每一项;只就无法找到的内容向用户询问一轮,然后编写该文件,并在存在 CLAUDE.md 或 AGENTS.md 时从中指向该文件。之后运行时若发现某项信息不再有效,也要以同样方式修正文件,并在报告中说明。
完成标准:应用已启动并填充种子数据,且本次会话中所有测试用例需要的用户角色均已登录。
3. 分派测试者
每个用户角色都分派一个全新的子 Agent,并行执行;在 Claude Code 中使用 model: "sonnet"。向其提供基础 URL、登录信息、文件中的 Data 和 Gotchas 部分,以及包含预期结果的测试用例。分派提示词只包含测试者的规则,不包含报告内容:只能创建以该角色为前缀的记录,并在完成后删除;修复阻碍测试的内容——例如过期的标志或损坏的种子数据——但保持被测行为原样;对每个测试用例,返回以下结果之一:pass;observed X, expected Y,并附上操作步骤;或 unreached,并说明阻碍因素。另需报告过程中发现的任何可疑故障。
完成标准:每个测试用例都返回一个判定结果。
4. 报告
测试全部通过时,仅输出一行:N cases across M personas, all pass. 否则,先列出失败用例的实际结果与预期结果,并附上操作步骤;然后列出过程中发现的可疑故障;最后列出本次运行所做的所有环境修复。只有用户同意后,才能修复此次变更。
完成标准:每个判定结果和每项修复都恰好出现一次。