用途:对 PR 或分支改动影响的页面运行端到端浏览器冒烟测试。该技能仅使用 agent-browser CLI 做浏览器自动化,不采用其他浏览器自动化系统、浏览器 MCP 集成或内置浏览器控制工具;在 Codex 中不得使用 Chrome MCP 工具,也不得替换为无关浏览工具。agent-browser 用于打开页面、点击元素、填写表单、截图和抓取渲染内容。
前置条件:本地开发服务器运行中(如 bin/dev、rails server、npm run dev);已安装 agent-browser CLI;存在待测试改动的 Git 仓库。检查安装:command -v agent-browser >/dev/null 2>&1 && echo "Installed" || echo "NOT INSTALLED"。若未安装,提示用户运行 /ce-setup,然后停止。
工作流程:1) 验证安装;2) 询问用户使用 headed 还是 headless,选择 headed 时加 --headed;3) 确定测试范围:有 PR 编号用 gh pr view [number] --json files -q '.files[].path',当前或空则 git diff --name-only main...HEAD,有分支名则 git diff --name-only main...[branch];4) 将变更文件映射到路由(如 src/app/、src/components/、src/features/、src/views/);5) 检测开发服务器端口,优先级为显式 --port 参数、AGENTS.md 中的端口说明、package.json 的 dev/start 脚本 --port 标志、.env/.env.local/.env.development 的 PORT=,默认 3000;6) 验证服务器运行:agent-browser open http://localhost:${PORT} 与 agent-browser snapshot -i;7) 逐个测试受影响路由,检查标题/主内容渲染且无错误信息;8) 失败时截图并询问用户如何处理(立即修复、创建待办或跳过);9) 输出测试页面、失败项和结果(PASS/FAIL/PARTIAL)的 markdown 摘要。
常用命令:agent-browser open <url>、agent-browser snapshot -i、agent-browser click @e1、agent-browser fill @e1 "text"、agent-browser screenshot out.png、agent-browser --headed open <url>。限制:缺少 agent-browser 时技能无法运行;文档未提供其他执行环境或平台的更多说明。