playwright-cli 浏览器自动化技能
通过命令行驱动 Playwright，让 AI 代理替你完成网页导航、表单填写、截图与数据提取，无需手写浏览器脚本。
浏览器自动化示例技能（打开浏览器、点击、填表、截图），与其他 playwright 系列技能（id 758）同类风险——本质是可执行任意浏览器交互的能力，本例是框架示例而非独立发布的生产技能。
这个 Skill 能做什么，适合哪些场景？
playwright-cli 是 VoltAgent 仓库 examples 目录中的一个 Agent Skill，把浏览器自动化封装为一套可直接调用的 CLI 命令。它通过快照（snapshot）返回元素引用（如 e15），代理再据此执行点击、输入、上传等操作，形成稳定的交互循环。技能还覆盖多标签页、Cookie 与本地存储、请求拦截、控制台/网络日志、追踪和视频录制等高级能力。它自带 `allowed-tools: Bash(playwright-cli:*)` 权限声明，属于 Claude Code 风格的技能文件，移植到其他平台需少量修改。
运行 playwright-cli 命令行工具：打开浏览器会话（可指定 chrome/firefox/webkit/msedge 或持久化配置文件）、导航页面、通过 snapshot 获取元素 ref 后执行 click/type/fill/select/upload/hover/drag 等交互、对页面或元素截图、导出 PDF、执行 JavaScript（eval / run-code）、管理多标签页、保存与加载 Cookie/LocalStorage/SessionStorage、用 route 命令模拟网络响应、查看 console 与 network 日志、进行 tracing 和录制 WebM 视频。SKILL.md 另附 7 个 references/ 文档，涵盖请求模拟、测试生成、会话管理等专题。
- 前端开发者想让代理对本地或线上 Web 应用做端到端验证：打开页面、操作交互、核对快照与截图
- 测试工程师需要批量填写表单、提交并捕获结果截图，替代手工回归
- 数据分析师要从无需登录或已具备会话凭证的网页提取信息，可用 storage state 保存/恢复登录态
- 调试人员排查前端问题：读取 console 报错、network 请求，并配合 tracing 复现操作序列
- QA 需要生成测试代码或录制操作视频，作为缺陷报告附件
这个 Skill 有哪些优点和局限？
- 命令覆盖面极广：交互、标签页、存储、网络模拟、DevTools、追踪、录屏一站式齐全
- 基于 snapshot ref 的交互模式对 LLM 友好，比坐标或 CSS 选择器更稳定
- 支持命名会话与持久化 profile，适合需要登录态的多任务场景
- 文档质量高，含表单提交、多标签、调试等即用示例和 7 篇专题参考
- frontmatter 使用 Claude Code 的 `allowed-tools: Bash(...)` 语法，其他平台需手动调整
- playwright-cli 工具本身的独立安装方式在来源中未完整说明
- 需要真实浏览器环境与网络访问，沙箱或离线环境无法运行
- README 面向整个 VoltAgent 平台，与该技能本身的能力无直接关系，评估时需区分
如何安装这个 Skill？
该技能位于 VoltAgent 仓库的 examples/with-workspace/workspace/skills/playwright-cli/ 目录，包含 SKILL.md 和 references/ 子目录。将其文件夹复制到你所用 Agent Skills 客户端的技能目录即可。SKILL.md 中提供了 playwright-cli install --skills 和 playwright-cli install-browser 安装命令，但仓库未说明 playwright-cli 二进制本身的独立安装渠道，需自行查阅。
如何使用这个 Skill？
安装浏览器后，用自然语言触发，例如：「打开 https://example.com，填入邮箱 [email protected] 并提交，然后截图」。代理会按 SKILL.md 的流程执行：playwright-cli open <url> → snapshot 获取元素 ref → fill/click 交互 → screenshot 截图 → close 关闭。可用 --browser=chrome 指定浏览器，用 -s=会话名 管理多个并行浏览器会话。
这个 Skill 与同类方案有什么区别？
来源中未点名直接竞品；README 赞助商栏提到 Ego Lite 宣称比 agent-browser (Vercel) 快 3.45 倍，但这是赞助内容且针对 VoltAgent 平台整体，不能作为本技能的客观对比依据。