用途
该技能用于对当前分支的功能变更进行端到端浏览器测试,并生成带截图和视频证据的结构化测试报告。它覆盖从代码变更分析、测试策略制定、真实浏览器测试执行到报告生成的完整流程。
主要能力
- 环境准备:获取任务上下文 ID(taskId、conversationId、teamId),验证 agent-browser CLI 工具可用性,创建 /tmp/aiden-captures/ 工作区。
- 覆盖范围确认:通过 AskUserQuestion 询问用户所需的测试覆盖级别(light / standard / comprehensive),并收集针对性的补充问题。
- 变更发现:通过 git log 和 git diff 分析分支变更,识别受影响的页面、组件和 API 路由,发现并启动开发服务器。
- 测试策略构建:基于覆盖级别和变更分析,编写结构化测试计划,为每个场景创建 todo 条目。
- 浏览器测试执行:使用 agent-browser CLI 工具(open、snapshot、click、fill、screenshot、record、wait、find、close)在真实浏览器中执行测试场景。
- 强制媒体捕获:始终录制视频并截取截图,截图写入 /tmp/aiden-captures/,命名具有描述性。
- S3 上传:通过 mcp__aiden__get_upload_url 获取预签名 URL,使用 curl PUT 上传文件到 S3。
- 结构化报告生成:通过 mcp__aiden__create_test_report MCP 工具持久化测试报告,包含标题、任务 ID、分支、提交、变更文件、应用 URL、摘要、状态、步骤、问题和媒体 URL。
使用方式
该技能以任务形式运行,流程分为以下阶段:
- Phase 0:环境准备,包括获取 artifact 上下文 ID、验证 agent-browser(如缺失则安装:
npm install -g agent-browser && agent-browser install)、创建 /tmp/aiden-captures/ 工作区。 - Phase 0.5:覆盖范围确认与上下文收集,必须通过 AskUserQuestion 询问用户覆盖级别和针对性问题,确认计划后方可继续。
- Phase 1:发现测试目标,分析分支变更,发现并启动开发服务器,确定应用 URL。
- Phase 1.5:构建测试策略并创建 todos,编写结构化测试计划。
- Phase 2:使用 agent-browser 执行测试,包括打开应用、开始视频录制(强制)、截取初始截图(强制)、执行每个场景、停止录制并清理、修复 WebM 时长元数据(如 ffmpeg 可用)。
- Phase 3:上传捕获文件到 S3,使用 mcp__aiden__get_upload_url 获取预签名 URL 并 curl PUT 上传。
- Phase 4:创建结构化测试报告,必须调用 mcp__aiden__create_test_report MCP 工具。
适用场景
- 对当前分支的功能变更进行端到端浏览器测试。
- 需要生成带截图和视频证据的测试报告。
- 需要按不同覆盖级别(light / standard / comprehensive)执行测试。
- 需要将测试捕获文件上传到 S3 并在报告中引用。
限制
- agent-browser 是 Vercel Labs 的 CLI 工具(npm: agent-browser),不是 skill 或 MCP 工具,必须通过 bash 调用。
- 所有捕获文件只能写入 /tmp/aiden-captures/,禁止写入 .claude/、项目目录、reports/ 或仓库内任何路径。
- 视频录制必须保持在 2 分钟以内,如功能需要更多探索则拆分为多个录制。
- 如果 agent-browser 不可用且无法安装,必须停止并告知用户,不得继续 Phase 2。
- 如果 S3 上传失败,仍须继续 Phase 4 创建报告,但省略媒体 URL 字段。
- 测试报告必须通过 MCP 工具持久化,不得仅以 markdown 文本输出或仅在聊天中总结。
- 具体收费、价格、平台支持范围等信息暂未提供。