用途
Agent Browser 用于浏览器自动化。当用户要求驱动 Agent Browser 执行以下操作时使用该技能：打开站点、点击、填写表单、截图、录制视频、抓取页面、验证 UI 等。
该技能自身的定位是轻量的发现型技能：Agent Browser 会随附其最新的技能内容，因此此技能应尽量把详细指令委托给已安装的 CLI，以保证使用方式与本地 CLI 版本一致。
何时不使用
- 不要用于可以用 curl 或项目 SDK 完成的纯 HTTP/API 调用。
- 不要用于在没有实时浏览器交互的情况下编写单元测试、集成测试或 E2E 测试。测试文件请使用 automate-e2e-tests。
- 不要用于绕过身份验证、条款、权限或访问控制。
加载当前指令
首先检查 CLI 是否可用：
agent-browser --version
如果可用，从已安装的 CLI 获取当前核心指令：
agent-browser skills get core --full
如果上述命令不受支持，则使用：
agent-browser skills list
agent-browser skills get core
随后按照 CLI 提供的指令执行，涉及命令语法、参考、模板、会话、截图、视频、选择器和故障排查。
安装或修复
如果 Agent Browser 缺失，且当前环境允许安装工具，使用官方安装路径：
npm i -g agent-browser
agent-browser install
如果不允许全局安装，请使用项目文档记录的工具链，或向用户询问已获批准的安装方式。在没有批准的情况下，不要在受限的企业环境中安装全局工具。
通用工作流
当 CLI 提供的指令不可用时，使用以下最小工作流：
- 打开目标 URL。
- 等待加载完成或某个具体 UI 条件满足。
- 使用可访问性/树快照检查页面。
- 优先使用稳定的元素引用、可访问角色、标签和可见文本，避免使用脆弱的 CSS 选择器。
- 按需点击、填写、输入、滚动或评估页面状态。
- 捕获截图或视频，用于面向用户的验证。
- 当涉及认证状态时，保存并复用命名会话。
- 完成后关闭或重置会话。
示例：
agent-browser open http://localhost:3000
agent-browser wait --load networkidle
agent-browser snapshot -i
agent-browser click @e1
agent-browser fill @e2 "example"
agent-browser screenshot --annotate reports/agent-browser/step.png
对较长流程使用命名会话：
agent-browser --session feature-test open http://localhost:3000
agent-browser --session feature-test snapshot -i
agent-browser --session feature-test screenshot reports/feature/step.png
证据规则
用于测试和验证工作时：
- 在发生有意义的状态变化后捕获证据。
- 在报告成功之前检查截图和录制内容。
- 拒绝空白、全黑、错误路由、状态过期或无法播放的证据。
- 对于多步骤流程、动画、认证、模态/面板交互和导航，优先使用视频。
- 在调用方工作流的报告中记录确切命令和观察到的结果。
失败处理
- CLI 缺失：仅在允许时安装；否则询问已获批准的工具路径。
- 命令语法不同：运行 agent-browser skills get core --full 并遵循已安装版本的说明。
- 需要认证：使用已获批准的测试凭据、已保存状态、预置用户，或请用户登录。不要凭空编造凭据。
- 引用过期：重新拍摄快照，并尽可能使用语义定位器。
- 截图或录制失败：用新的命名会话重试一次，然后在验证报告中记录该阻塞项。
- 页面行为异常：捕获 URL、截图、控制台/网络证据（如果可用），并将发现交回 test-feature。
来源说明
该技能为 Supatest AI supa-skills agent-browser v1.0.1 的通用起始版本。它有意保留常见的技能名称，同时把详细指令委托给已安装的 Agent Browser CLI 核心技能，使使用方式与本地 CLI 版本保持一致。
自我改进
如果 Agent Browser 更改了其技能名称、安装命令或恢复工作流，请在同一个变更集中修补此技能。
限制
关于具体收费标准、价格、支持的平台、性能或效果等事实，资料中暂未提供。