技能包

给编程代理先装 Playwright CLI 再谈测试脚手架

先全局安装官方 Playwright CLI,用同一 API 驱动三大浏览器内核,第一次不要初始化整套测试项目。

官方来源 · microsoft/playwright

安装

npm i -g @playwright/cli@latest

适合谁

这份技能适合要用同一套 API 驱动 Chromium、Firefox 和 WebKit 的人:官方把它写成网页自动化与测试框架,可用于测试、脚本,也可作为编程代理的工具。它也适合已经在用 Claude Code 或 Copilot 这类编码代理、准备装官方命令行的人。这两个名字来自原文示例,不能理解成只支持它们。

它不适合还没同意全局装包、却想立刻生成一整套测试项目的人。官方另有一条 npm init playwright@latest,会初始化测试项目,第一次不要走这条。若你只想先让代理会用命令行,主路径是全局安装 @playwright/cli。

官方仓库见 https://github.com/microsoft/playwright 请按该页已写出的命令操作。

3 分钟完成第一次尝试

只走官方写给编码代理的这一条安装路径。

前置条件:本机可以运行 npm,并且你明确同意一次全局安装。先确认:npm i -g @playwright/cli@latest 会把命令行装到全局。若还不想改本机全局包,不要执行。这一步不要初始化测试项目,也不要打开真实网站。

安装位置:在任意终端确认上述副作用后执行:

npm i -g @playwright/cli@latest

低风险核对:安装完成后,先让代理只根据官方说明复述这条 CLI 的用途——它被写成面向编码代理的浏览器自动化命令行,比 MCP 更省 token,命令避免把大型工具模式和可访问性树装进模型上下文。不要启动浏览器,不要对外部站点发请求。若你还想装更完整的代理集成,原文另有 playwright-cli install --skills;那会写入技能文件,执行前再确认一次。

成功信号:全局安装结束,代理能指出主命令是 @playwright/cli,并且没有改用未出现的安装器。若它直接跑 npm init playwright@latest,说明走错了路径,停住。

使用案例

案例一:给编码代理装上官方 CLI。原文在 Claude Code、Copilot 旁写出 npm i -g @playwright/cli@latest,随后可用 playwright-cli install --skills 安装更丰富的代理集成。适合先要命令行、稍后再决定是否写入技能文件的人。第二条命令会改本地技能目录,执行前先确认。

案例二:新建端到端测试项目。官方命令是 npm init playwright@latest。适合已经决定要一份测试脚手架、并同意它创建项目文件的人。初始化会写磁盘,不要在还只想试命令行时执行。原文没有写浏览器下载开关时,不要自行补参数。

使用边界

主路径是 npm i -g @playwright/cli@latest。不要把未出现的安装器写进主路径。playwright-cli install --skills 与 npm init playwright@latest 是原文里的另外两条命令,用途不同,不要混成一条。

能力覆盖用同一 API 驱动 Chromium、Firefox、WebKit,用于测试、脚本和编程代理。没有证明可以驱动未点名的浏览器内核。Claude Code、Copilot 只是示例名单。

官方页面是 https://github.com/microsoft/playwright 若代理建议的第一条命令不是全局安装 @playwright/cli,以该页为准。第一次不要对生产站点做自动化。