跳到主要内容

Dev-Browser 技能

通过持久命名页面、Puppeteer 脚本和本地命令行服务自动操作 Chrome。

社区 · Sawyer Hood
作者Sawyer Hood
许可证MIT
来源SawyerHood/dev-browser · GitHub 上的 SKILL.md
适用于Claude Code · Codex、Gemini CLI、Cursor、Copilot
读取源文件日期

dev-browser 技能指导代理通过简短的 Puppeteer 脚本操作真实 Chrome,并在调用之间保留命名页面。

当前版本使用本地 CLI 和常驻 Bun 服务,可导航、填写表单、提取网页数据和截图;本站仅提供技能介绍。

摘自该技能的 SKILL.md: # dev-browser

这是 Sawyer Hood 发布的社区技能,未经我们或 Anthropic 审核。技能可以让智能体运行代码、读取文件或访问网络。安装前请阅读它的 SKILL.md 和文件夹中的每个脚本,留意任何与其声称用途不符的内容。

功能

  1. 操作前检查交互式页面快照。
  2. 在命名页面上运行简短脚本。
  3. 等待所需状态并检查结果。

产出内容

  • 按任务执行浏览器操作、提取数据或保存截图。

适用场景

  • 需要在多次调用间保留页面状态的浏览器流程。

不适用的场景

  • 当前版本不支持 Windows 或 musl Linux。

所需条件

  • 需要支持终端的代理、兼容的 macOS 或 glibc Linux,以及 Chrome。
  • 安装可能下载运行时二进制文件和 Chrome;代理使用与外部网站可能另有费用或账号要求。

技能包含的文件

文件或文件夹用途
SKILL.mdCLI 流程、命名页面、元素引用和导航注意事项。

2026-11-20 在仓库中查到的许可证:MIT。

示例提示词

安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。

  • 检查结账表单并报告必填字段,不要提交。
  • 为本地预览页面截取桌面和手机尺寸截图。
  • 复用命名页面,验证筛选器是否改变了结果。

如何安装 dev-browser

CLI 配置与浏览器权限

CLI 需要与说明文件夹分开安装。仅当 CLI 提示找不到 Chrome 时才下载,并在使用前阅读当前帮助。

审查脚本并授权浏览器操作。配置文件可能保留 Cookie 和登录状态;连接现有浏览器可能访问其当前会话。

运行时指南位于仓库中,并未打包在技能文件夹内。

npm install -g dev-browser
# Only if the CLI reports "No Chrome found":
dev-browser install
dev-browser --help

技能(Skill)是一个包含 SKILL.md 文件的文件夹。只需安装一次;智能体会在每次会话开始时读取它的简短描述,只有请求匹配时才加载完整说明。选择你使用的环境:

Claude Code:把文件夹复制到技能文件夹

把技能文件夹放到 ~/.claude/skills/,可在这台电脑的所有项目中使用;放到仓库内的 .claude/skills/,则与在该仓库工作的所有人共享(记得提交)。

git clone --depth 1 https://github.com/SawyerHood/dev-browser.git
mkdir -p ~/.claude/skills
cp -R dev-browser/skills/dev-browser ~/.claude/skills/

Claude Code 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /dev-browser,或直接描述任务。

在 Windows 上,请在 Git Bash 或 WSL 中运行这些命令,或用文件资源管理器把文件夹复制到同样的位置。

Codex、Gemini CLI、Cursor 和 GitHub Copilot

这些智能体读取同样的 SKILL.md 文件夹。四者在项目中都认可的文件夹是 .agents/skills/,所以下面的命令把技能复制到那里:

git clone --depth 1 https://github.com/SawyerHood/dev-browser.git
mkdir -p .agents/skills
cp -R dev-browser/skills/dev-browser .agents/skills/
智能体项目文件夹用户文件夹说明
OpenAI Codex
.agents/skills/
~/.agents/skills/
输入 $ 或运行 /skills 来选择技能;当任务匹配时,Codex 也会自动选用。
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
也可以用 gemini skills install <git URL> --path <folder> --consent 从 Git 安装。2026 年 6 月 18 日起,Google 已用 Antigravity CLI 取代 Gemini CLI,面向免费层级和 Google One 用户;Antigravity 在项目中使用 .agents/skills/,个人使用 ~/.gemini/config/skills/。
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
在 Agent 聊天中输入 / 选择技能。Cursor 也会读取 Claude Code 的 .claude/skills/ 文件夹。
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
适用于 Copilot CLI、云端智能体,以及 VS Code、Visual Studio 和 JetBrains 中的智能体模式(IDE 支持取决于版本)。也可以运行 gh skill install OWNER/REPOSITORY SKILL(公开预览版,需 GitHub CLI 2.90.0 或更高版本)。
只安装你信任的技能. Anthropic 的建议是只使用可信来源的技能,其他技能在使用前要读完每个文件:技能可能以其描述中未提及的方式,指示智能体运行命令、读取文件或发送数据。

这些步骤的来源

已于 2026-11-14 对照各厂商的文档核实:

持久页面与最新引用

页面名称以浏览器为范围。有界面和无界面模式使用不同的 Chrome 配置文件;不要同时操作同一个命名页面。

导航后元素引用会重置。重新获取快照,并等待目标元素或加载状态,不要假定点击后导航已完成。

安装方式与限制

发布者也提供向指定代理目录写入技能的 install-skill 命令。运行前检查目标位置;仅复制技能文件夹不会安装依赖。

npm 包会获取打包的运行时二进制文件,之后日常使用无需单独的 Node 运行时。任务结束时应保留用户自己的已连接浏览器。

关于 dev-browser 的常见问题

复制 SKILL.md 会安装运行时吗?

不会。CLI 和可用的 Chrome 需要另行安装。

它还使用旧版 Playwright 服务流程吗?

核对的版本通过 dev-browser CLI 使用 Puppeteer,旧版服务配置教程可能已不适用。

必须配置 MCP 服务吗?

不必。CLI 可直接使用;仓库也介绍了可选的 MCP 模式。

脚本执行环境是安全沙箱吗?

不是。文档中的 node:vm 隔离不构成安全边界。只运行经过审查且获得相应权限的脚本。

更多 AI 技能

相关技能

技能分类