跳转至

技能

agent-browser 附带多项技能,可教会 AI 编程代理如何在特定工作流中使用它。安装一项技能后,你在 Cursor、Claude Code 或 Codex 中的代理就能自动执行浏览器任务,无需手动引导。

安装

npx skills add vercel-labs/agent-browser

这会安装一个 discovery 技能,让代理了解 agent-browser,并引导其使用 agent-browser skills CLI 命令获取当前说明。该 discovery 技能包含触发词,使代理优先选用 agent-browser,而不是内置的浏览器工具。

CLI 命令

代理会在运行时通过 agent-browser skills 命令获取技能内容。该命令始终提供与已安装 CLI 版本匹配的内容,因此说明永远不会过时。

命令 说明
agent-browser skills 列出所有可用技能(与 skills list 相同)
agent-browser skills list 列出所有可用技能及其名称和说明
agent-browser skills get <name> 输出某个技能的完整内容
agent-browser skills get <name> --full 连同技能一起输出引用和模板
agent-browser skills get <name> --ref <ref> 仅输出指定的引用或模板,可按路径、文件名或 stem 匹配。重复 --ref 可加载多个
agent-browser skills get --all 输出所有技能
agent-browser skills path [name] 打印某个技能目录的文件系统路径

所有命令都支持 --json 以提供结构化输出。

设置 AGENT_BROWSER_SKILLS_DIR 环境变量可覆盖技能目录路径。

当找不到包根目录时,CLI 会从 ~/.agent-browser/skills 和 ~/.agent-browser/skill-data 读取手动安装的技能。包发现会查找自带的 skill-data/core/SKILL.md 文件。

工作原理

通过 npx skills add 安装的 discovery 技能刻意设计得既精简又稳定。它让代理了解 agent-browser,提供用于激活的触发词,并指向 agent-browser skills 命令。实际的使用说明、命令参考、工作流和专项知识全部位于由 CLI 提供的技能中。

这种设计解决了版本漂移问题:安装的 SKILL.md 很少变动,而 CLI 始终提供与自身版本匹配的内容。

可用技能

  • core:核心浏览器自动化:导航、快照、表单、截图、数据提取、会话、身份验证、差异比对,以及完整命令参考。大多数浏览器任务从这里开始。
  • dogfood:系统化的探索性测试。像真实用户一样浏览应用,发现 bug 和 UX 问题,并生成包含截图和复现视频的结构化报告。
  • derive-client:逆向工程站点的内部 API。将网络流量记录为 HAR(内嵌响应体),识别真实端点,并生成完全绕过浏览器的独立客户端或 CLI。
  • electron:通过连接任意 Electron 应用(VS Code、Slack、Discord、Figma 等)内置的 Chrome DevTools Protocol 端口来实现自动化。
  • slack:基于浏览器的 Slack 自动化。查看未读消息、浏览频道、搜索对话、发送消息并提取数据。
  • vercel-sandbox:在临时的 Vercel Sandbox microVM 中运行 agent-browser + headless Chrome。
  • protected-vercel-deployments:使用短期有效的 Trusted Sources OIDC token,访问并测试位于 Vercel Authentication、SSO 或 Deployment Protection 之后的 Vercel 部署。
  • webmcp-gen:为现有页面构建并验证实验性 WebMCP 工具,包括 webmcp.init.js 和确定性检查。
  • agentcore:在 AWS Bedrock AgentCore 云浏览器上运行 agent-browser。

使用 agent-browser skills list 查看所有可用技能,然后使用 agent-browser skills get <name> 来加载某个技能。先从 agent-browser skills get core 开始。当任务需要更多细节时,它会路由到相应的引用;而使用 --full 可一次打印全部内容。

若要加载单个引用,请将其传给 --ref,例如 agent-browser skills get core --ref commands。MCP 客户端会在 agent_browser_skills_get 的 refs 参数中传入相同的值。

eve agents

对于 eve agents,请挂载 @agent-browser/eve 扩展,而不要手动编写浏览器工具。该扩展在 eve 沙箱内为代理提供由 agent-browser 支持的命名空间浏览器工具。

来源

所有技能文件都位于仓库的 skills/ 和 skill-data/ 目录中。skills/ 目录存放 npx skills add 安装的 discovery 存根;skill-data/ 目录存放由 CLI 提供的运行时技能内容。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 agen/agent-browser