前言¶
很多任务离不开浏览器：登录后台、填表提交、翻页抓取、对页面截图留档。若只靠手写 Playwright 或 Selenium 脚本，每一步选择器、等待和异常都要自己维护；若只给 Agent 一个通用「打开网页」能力，又往往难以稳定完成多步交互。
下面介绍腾讯在 SkillHub 上发布的 BrowserSkill。它面向 WorkBuddy 等 Agent 运行时，把「填表、点击、翻页、截图」等浏览器操作收敛成可安装的 Skill，便于在对话里完成需要真实浏览器的复杂流程。
这是什么¶
BrowserSkill 是腾讯开源的智能浏览器自动化 Skill，发布者为微信对话平台团队，在 SkillHub 上的坐标为 @tencent-adm/browserskill，当前版本 v1.0.7，分类为 ai-agent，来源标记为 enterprise。
官方简介将其定位为：让 WorkBuddy 像人一样操作网页——自动填表、点击、翻页、截图，完成任何需要浏览器的复杂任务。页面标签标明 requires_api_key=false，即按 SkillHub 展示信息，不强制额外 API Key 即可安装使用（具体仍取决于你本地浏览器环境与 Agent 配置）。
SkillHub 页面（截至资料抓取时）显示评分 100000、下载 117643 次；安装与能力说明以 SkillHub 与包内 SKILL.md 为准。
核心功能¶
以下能力均来自官方简介，未在公开页单独展开实现细节：
- 表单填写：在网页上输入并提交表单类操作。
- 点击与导航：模拟用户点击、进入下一页面或触发控件。
- 翻页：处理分页列表等多页内容。
- 截图：对当前页面或步骤结果做截图，便于核对或归档。
- 复杂浏览器任务：将上述动作组合，覆盖「必须打开真实浏览器才能完成」的流程。
Skill 本身遵循通用 SKILL.md 格式，安装后由 Agent 按技能文档中的指令调用，而不是单独起一个常驻服务。
安装与启用¶
安装前需本机具备 SkillHub CLI。官方安装说明见 SkillHub 安装与优先源配置。
1. 检查或安装 CLI¶
先确认是否已安装：
command -v skillhub && skillhub --version
若未安装，可按官方文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装 BrowserSkill¶
SkillHub 要求安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认落到 ./skills/ 可能不会被识别。
skillhub install @tencent-adm/browserskill --dir <你的 Agent skills 目录>
各客户端常见路径（摘自 SkillHub 安装文档）：
- WorkBuddy：
~/.workbuddy/skills/ - Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
若你通过对话让 AI 安装，SkillHub 页面给出的提示词为：请根据 https://skillhub.cn/install/skillhub.md，安装 @tencent-adm/browserskill。
安装完成后，按所用 Agent 的要求重启或刷新技能列表，再阅读包内 SKILL.md 中的触发条件与参数说明。
典型用法¶
公开 SkillHub 详情页未提供独立代码示例；可复现的流程如下。
- 按上一节将
@tencent-adm/browserskill安装到 WorkBuddy（或其它已配置 skills 目录的 Agent）对应目录。 - 在对话中描述需要浏览器完成的任务，例如：打开指定 URL、填写字段、点击提交、翻页后继续操作、对关键步骤截图。
- Agent 加载 BrowserSkill 后，按
SKILL.md中的步骤驱动浏览器自动化，而不是仅做静态 HTTP 抓取。
具体命令、环境变量或浏览器依赖以安装包内文档为准；本文不臆造未公开的接口名或配置项。
适用场景与注意¶
更适合谁
- 已在使用 WorkBuddy 或支持 SkillHub 技能的 Agent，希望把「网页里点一点、填一填」交给 Agent 编排。
- 任务强依赖真实 DOM 与前端交互，纯 API 或
curl无法覆盖的场景。
需要注意
- 浏览器自动化受页面结构变更、登录态、验证码、风控策略影响，稳定性需在实际站点上验证。
- 安装目录必须与当前 Agent 一致；装错目录是 SkillHub 文档中明确提到的常见坑。
- 自动化操作涉及账号与数据时，应在合规前提下使用，并限制 Agent 可访问的站点与权限。
结尾¶
BrowserSkill 把浏览器侧的填表、点击、翻页、截图等能力封装为 Skill，方便 WorkBuddy 一类 Agent 在对话中完成复杂网页任务。安装与路径配置以 SkillHub 官方说明为准。
