开发与工程

Playwright 浏览器自动化技能

让编程代理即时编写并执行 Playwright 脚本,覆盖网页测试、截图、登录流程与任意浏览器自动化任务。

68/ 100
推荐

整体可靠,存在已披露的局限;按说明试用并保留回滚路径。

查看评分依据 ↓
可直接使用于
Codex · Claude Code · Claude.ai(部分支持)
Star 数
★ 3.3k
最近更新
2 个月前
License
MIT
playwrightbrowser-automatione2e-testingweb-testing
+3screenshotsnodejsresponsive-design

这个 Skill 能做什么,适合哪些场景?

playwright-skill 是一个面向编程代理的 Agent Skill,让代理能根据用户需求现场编写并运行真实的 Playwright 代码,而非套用预置脚本。它自带通用执行器 run.js、开发服务器自动检测和一组可选辅助函数,默认使用可见浏览器。安装后需要执行一次 npm run setup 来安装 Playwright 与 Chromium。适合需要留存并复用自动化脚本的场景。

该技能让代理:读取 SKILL.md 中的工作流指令;用内置的 detectDevServers 辅助函数检测本机运行中的开发服务器;将一次性脚本写入系统临时目录(或通过 PW_SCRIPT_DIR 保留到项目目录);通过 run.js 执行脚本以获得稳定的模块解析;产出页面截图、控制台输出等结果。支持截图、多视口响应式检查、登录流程(凭据来自环境变量)、链接检查、Cookie 弹窗处理、连接已有 Chrome 调试会话,以及通过环境变量配置浏览器类型、无头模式、额外 HTTP 头等。

适合
  • 开发者让代理测试本地项目:技能自动检测 localhost 上的开发服务器并验证页面加载、控制台错误等
  • 前端工程师需要移动端与桌面端截图对比:代理用多视口脚本生成 full-page 截图
  • 测试人员验证登录注册流程:代理用环境变量中的测试凭据走完整登录流并断言跳转后元素
  • 维护者排查死链或图片加载问题:代理遍历页面执行链接与资源检查
  • 需要在有登录态的浏览器里复用 Cookie 与扩展:代理通过 CDP 连接已有 Chrome 会话

如何安装这个 Skill?

使用前请注意
  • Claude 会现场生成并执行浏览器自动化代码,可访问任意 URL;使用前应了解目标站点内容
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 网络访问
  • 本地文件系统
需要预先安装
  • Node.js 20+
  • npm
  • Playwright
  • Chromium

推荐用 Vercel 的 skills CLI 安装:npx skills add lackeyjb/playwright-skill --skill playwright-skill --global --yes(加 --agent claude-code cursor 可指定目标代理)。也可作为 Claude Code 插件安装:/plugin marketplace add lackeyjb/playwright-skill 然后 /plugin install playwright-skill@playwright-skill。或从 GitHub Releases 下载,将 skills/playwright-skill/ 复制到 ~/.claude/skills/playwright-skill 或项目 .claude/skills/ 目录。无论哪种方式,安装后需在技能目录运行一次 npm run setup 安装 Playwright 和 Chromium(首次需要网络)。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/lackeyjb/playwright-skill.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/playwright-skill" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 测试一下首页
  • 在移动端和桌面端给仪表盘截图
  • 填写注册表单并提交
  • 检查死链

安装后直接用自然语言向代理下达浏览器任务,例如:"测试一下首页"、"在移动端和桌面端给仪表盘截图"、"填写注册表单并提交"、"检查死链"。代理会编写定制 Playwright 代码、通过 run.js 执行、返回控制台输出和截图。需要 Firefox 或 WebKit 时运行 npm run install-all-browsers;通过 PW_BROWSER、PW_HEADLESS、PW_ARTIFACT_DIR 等环境变量调整行为。完整 API(网络拦截、视频录制、设备仿真等)见 API_REFERENCE.md。

这个 Skill 有哪些优点和局限?

优点
  • 代理按需编写定制脚本,不局限于预置模板,可处理循环、断言、多上下文等真实程序需求
  • 默认可见浏览器,便于实时观察自动化过程
  • 自带 dev server 检测、Cookie 弹窗处理、截图等实用辅助函数
  • run.js 执行器解决了脚本模块解析问题,支持脚本保存与复用
  • 文档详尽,含完整 API 参考与渐进式加载设计
局限
  • 需要 Node.js 20+ 并在首次使用时联网下载 Playwright 与 Chromium
  • Firefox/WebKit 需额外运行 install-all-browsers
  • 源材料未提供测试套件或在 Claude Code 之外平台的验证证据
  • 连接已有 Chrome 会话会获得用户的全部访问权限,处理敏感信息需谨慎
  • 脚本默认写入临时目录,跨会话保留需手动设置 PW_SCRIPT_DIR

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
Playwright 浏览器自动化技能 本页 68 · 推荐 ★ 3.3k 2 个月前 MIT
playwright-cli 浏览器自动化技能 56 · 谨慎使用 ★ 11k 1 个月前 MIT
Web 应用测试技能 49 · 谨慎使用 ★ 3.1k 8 个月前 MIT
Playwright 浏览器自动化技能 ✓ OpenAI · 官方 52 · 谨慎使用 ★ 28k 4 个月前 —
Playwright 浏览器自动化技能 ✓ Microsoft · 官方 46 · 谨慎使用 ★ 99k 7 天前 Apache-2.0

README 明确区分了两个替代方案:Microsoft 官方的 @playwright/cli(适合简单的交互式浏览,可用 playwright-cli install --skills 安装其技能)和 playwright-mcp(基于可访问性快照的工具式浏览器控制)。本项目定位是"代码优先"选项——当自动化脚本本身就是要产出的成果时使用。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-1.0
推荐
68/ 100 五分制 3.4 / 5
1价值适配16 / 20 · 4.0/5
2可靠性14 / 20 · 3.5/5
3安全性17 / 25 · 3.4/5

让 Claude 现场编写并执行浏览器自动化脚本(默认非无头模式),可以打开任意 URL 并与页面交互;脚本限定写到 /tmp,不写入项目目录,风险面可控但本质是任意代码执行能力。

4证据7 / 15 · 2.3/5
5易用性8 / 10 · 4.0/5
6维护性6 / 10 · 3.0/5
1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月17日 评估证据[1]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

本条评估按 FSRS 1.0 标准完成,维度分不做换算,已进入按 FSRS 2.0 重新评估的复核队列。

查看完整评分方法 →

常见问题

需要哪些运行环境?
需要 Node.js 20+、npm,且首次安装需联网以下载 Playwright 和 Chromium。通过 npm run setup 一次性完成。
登录测试的凭据从哪来?
技能要求用户提供测试凭据(通过 TEST_EMAIL/TEST_PASSWORD 等环境变量),明确禁止代理编造或暴露真实凭据。
脚本和截图会保存在哪里?
默认写入操作系统临时目录;设置 PW_SCRIPT_DIR 可保留脚本到指定目录,PW_ARTIFACT_DIR 控制截图输出位置。
它和直接用 Playwright 写测试有什么区别?
区别在于由代理现场生成代码:你只需描述任务,代理编写、执行并回报结果,省去手动搭建与编写的过程,且脚本是可留存复用的真实 Playwright 程序。

相关 Skills