这里的 playwright 是 openai/skills 中的独立 Skill，主要通过 CLI 驱动浏览器。它适合“打开页面，把新增待办流程走一遍”这类任务，先读取页面快照再操作元素，页面变化后重新读取。它与 Microsoft 仓库自带的 playwright-cli Skill 不是同一个条目，也不会默认替你建立完整自动化测试套件。
安装与准备
本文介绍 openai/skills 保留的独立 Skill 版本。该仓库已弃用，当前官方示例转至 openai/plugins；这里的步骤对应本页链接的旧仓库版本，不代表最新插件。
在 Codex 对话框输入下面这一行；它不是终端命令。安装后若找不到该 Skill，重启 Codex 再试。
$skill-installer playwright
- Node.js/npm，确保 npx 可用
- 可访问的目标网站或已运行的本地服务
- CLI 所需浏览器环境及目标页面的正常访问权限
配套 wrapper 可以通过 npx 使用 CLI，无需预先全局安装。Microsoft 当前 CLI 文档也提供 npm install -g @playwright/cli@latest；是否全局安装由你的项目环境决定。不要把另一套 playwright-cli install --skills 当成本文 OpenAI Skill 的安装命令。 [4]
第一次怎么用
下面以待办网页为例，先换成自己运行中的地址：
$playwright
用 playwright 检查 http://localhost:3000 的新增待办流程：输入“准备周报”、添加、标记完成，再清除已完成项。使用可见浏览器，操作前读取快照，保存关键步骤截图到 output/playwright/。失败时记录页面状态和可复现步骤。只走这条流程，暂不生成测试文件。
接下来怎样推进
-
先确认网页已运行。 检查实际地址、登录条件和测试数据，决定有头浏览器是否有助于观察。
-
快照后再操作。 从最新快照取得元素引用，执行点击或输入；导航、弹窗和重要页面变化后重新读取，避免沿用失效引用。
-
保留结果与失败现场。 记录经过的步骤和最后状态。遇到难复现问题可以保存 trace；需要长期回归时，再明确要求生成测试代码。
做一次可复查的表单检查
先让本地服务运行并确认测试地址、测试账号和可清理的数据。第一次可以只检查“打开登录页 → 填写无效邮箱 → 看错误提示 → 改成有效值”这一条路径。让 Agent 打开页面后先取快照，从实际可见的标签和元素引用选择输入框；点击、跳转或弹窗后重新取快照。元素编号不是永久定位器，页面变化后沿用旧编号可能点到别处。
把成功条件写成可观察的页面状态，例如某段确认文字、目标 URL 或列表中新出现的一条记录。等待这个条件比任意睡眠几秒稳定。过程中若失败，要求保存最后快照、截图和操作序列；需要定位间歇性问题时再录 trace。不要在真实生产账号上试付款、删除或发送消息。
CLI 操作与测试代码的区别
这个 Skill 首先帮助 Agent 完成一次真实浏览器操作。它可以指出复现路径与界面缺陷，但一次操作记录不会自动成为可重复运行的 Playwright 测试套件。若要长期回归，应另行要求生成测试文件、稳定定位方式、测试数据准备和清理步骤，再在 CI 环境运行。页面打不开时先排查本地服务和权限，不能把访问失败写成产品功能缺陷。
交付后先检查什么
你应看到实际执行过的步骤、哪些通过或失败，以及对应截图或 trace 的路径。截图只能证明当时的状态，应结合操作结果判断；仅成功打开首页不能算完整流程通过。
后端离线时先验证前端流程
后端不可用时，仍可以先验证前端自己的行为。一位测试者用同一 Playwright CLI 做登录检查：打开本地登录页，发现请求被拒绝后，只模拟登录与用户信息两个接口，再重走流程，核对跳转 URL、欢迎内容和本地登录态。这个案例使用的是另一份 CLI Skill，不能证明本页 Skill 自带模拟脚本；若你的 CLI 版本支持路由模拟，可以把它作为单独的前端测试方案，同时明确标记模拟数据，之后再用真实后端验证集成。
常见卡点
没有 npx。 先安装 Node.js/npm 并确认环境路径，再启动该工作流。
找不到元素引用。 页面可能已经变化，重新取快照，不要猜一个旧编号。
需要登录或遇到验证。 按网站正常方式完成所需访问；受阻时记录失败点，不把空白页当作已通过。