Playwright Automation

概述

Playwright Automation 即 lackeyjb/playwright-skill，一个 MIT 许可的通用 Agent Skill，让编程 Agent 即时编写并执行 Playwright 代码，从单页检查到多步骤流程都可覆盖。它遵循开放的 Agent Skills 规范，可用于 Claude Code、Cursor、GitHub Copilot、Codex、Gemini CLI、OpenCode 等客户端，也打包成了 Claude Code 插件。

README 对定位说得很清楚：简单的交互式浏览优先用微软官方的 @playwright/cli；基于工具调用、带无障碍快照的控制用 playwright-mcp；而这个 Skill 是代码优先的选择，适合「自动化脚本本身就是产出」的场景，比如循环、断言、多上下文、网络拦截、截图、录屏，或想保留下来重复运行的脚本。

核心功能

• 按需求编写代码，而不是固定的预置脚本。
• 默认可见浏览器（headless: false），可以看着它运行；需要时可要求无头模式。
• 可移植执行器 run.js，以稳定的模块解析运行文件或内联脚本。
• 渐进式加载：SKILL.md 很精简，完整的 API_REFERENCE.md（选择器、登录、视觉回归、移动端模拟、性能、调试）只在需要时加载。
• 开发服务器检测，以及 lib/helpers.js 中的可选辅助函数。
• 可通过 SLOW_MO、PW_ARTIFACT_DIR 配置（截图默认存到系统临时目录）。

快速上手

npx skills add lackeyjb/playwright-skill --skill playwright-skill --global --yes
# 然后在安装后的 Skill 目录执行
npm run setup   # 安装 Playwright 与 Chromium

在 Claude Code 中也可以执行 /plugin marketplace add lackeyjb/playwright-skill 和 /plugin install playwright-skill@playwright-skill。之后直接说「测试首页」「检查联系表单能否提交」「分别截取仪表盘的移动端和桌面端截图」即可。

适用场景

• 开发时对本地应用做快速端到端检查。
• 多视口响应式截图。
• 批量检查链接、图片和表单校验。

局限

• 需要 Node.js 和本地浏览器；npm run install-all-browsers 可额外安装 Firefox 与 WebKit。
• 生成的脚本默认是一次性的，需要自己收进测试套件。

常见问题

它和 Playwright MCP 有什么区别？

Playwright MCP 把浏览器操作暴露为工具；这个 Skill 让 Agent 编写并运行完整的 Playwright 程序。

截图保存在哪里？

默认在系统临时目录，设置 PW_ARTIFACT_DIR 后保存到指定位置。

替代方案

• Webapp Testing：Anthropic 基于 Playwright 的本地 Web 应用测试 Skill。
• Chrome DevTools MCP：基于工具调用的浏览器检查。
• Agent Browser 与 Browser Use：由 Agent 驱动的浏览。

更多内容见 Skills 分类 与 浏览器自动化标签。