SuperAPI AI 工具集

browser-acceptance-testing

测试与质量

查看项目

更新于 10-20 20:39

技能介绍

用途

该技能用于在真实浏览器中,以终端用户视角验证应用的验收标准与边界情况,而不是仅依赖状态码或单元测试。它适用于有用户界面、且验收标准描述了用户操作路径的变更。

主要能力

  • 按用户实际接触顺序走查验收标准(如首次访问、登录、列表、创建、编辑、删除)。
  • 通过真实 UI 操作(填表、点击)验证行为,仅在读取状态或输入超长内容时使用脚本。
  • 在网络面板确认 HTTP 状态码,在验收标准涉及数据时通过公开 API 核对数据。
  • 覆盖输入、导航、时序、会话、布局、控制台等六类边界情况,例如纯空格输入、超长与超限输入、emoji 临界、HTML/脚本注入、删除或登出后的返回按钮、未知或异常 id 的直链、重复提交、跨标签页会话变化、过期会话、服务器重启、桌面与 375px 移动视口、横向溢出、深色模式、键盘焦点顺序、脚本错误与安全策略违规等。
  • 自行查看桌面、375px 和错误页截图,识别状态码无法反映的布局问题(如复数错误、标题缺失、文字截断)。
  • 将测试笔记与发现整理为结构化报告。

使用方式

  1. 确定浏览器打开时机:用户明确要求时执行;无人值守运行时,由智能体判断变更是否涉及验收标准描述的用户界面,并将决定记录为 Q- 条目。
  2. 在隔离环境中启动应用,使用独立端口与数据(.scratchpad/<slug>/manual-env.sh);如有登录,在该环境创建测试账户,凭据保存在辅助脚本中而非聊天消息。
  3. 选择浏览器工具:优先 Chrome DevTools MCP,并预先加载 navigate、snapshot、screenshot、click、fill、fill form、evaluate script、console messages、network requests、emulate、resize 等工具;若无 MCP 但具备 Playwright 与浏览器(常见于容器和云端会话),在 .scratchpad/<slug>/scripts/ 写一个脚本执行同样的检查,将控制台消息、网络状态码和截图存入 .scratchpad/<slug>/shots/。工具失败时不得擅自切换到其他工具;无人值守时把切换记录为 Q- 条目。
  4. 边测边在 .scratchpad/<slug>/browser-test-notes.md 记录。
  5. 禁止触发 alert、confirm、prompt,因为它们会阻塞浏览器工具;如需证明脚本执行,使用 console.log。
  6. 编写 .scratchpad/<slug>/browser-test-report.md,包含:摘要(浏览器中通过/不可测/失败的标准,按红绿灯列出发现)、已测标准(AC | 用户做了什么 | 结果)、无法在浏览器验证的项及验证位置、边界情况(用例 | 结果)、发现项(B1、B2…带红绿灯标记)、最终状态(服务器已停止、测试数据留存情况)。
  7. 报告前停止服务器并关闭多余标签页。

适用场景

有用户界面、验收标准描述用户操作流程的功能变更;需要在多种视口与边界条件下做端到端确认的验收阶段;容器或云端会话中无 DevTools MCP 但可用 Playwright 的环境。

限制

工具选择需遵循优先级与失败不擅自切换的约束;无人值守时浏览器打开与否、工具切换等决定需记录为 Q- 条目;无法在浏览器验证的标准需要注明其他验证位置;具体的技术栈、依赖版本、安装命令、收费信息等资料暂未提供。