Skill/流程自动化/Playwright CLI
流程自动化 14.8k 仓库 Star

Playwright CLI

自动完成网页流程

这是 Microsoft 提供的浏览器命令行工具与配套 Skill。它让 Agent 通过页面快照识别元素,再点击、输入和导航,结合截图与日志检查结果。适合网页验证与重复操作,需要先准备 CLI、浏览器及当前宿主允许的实际执行方式。

你需要准备:网页地址、要完成的操作及必要账号授权

一桉AI 整理 · 2026.10.31 更新 · 查看 GitHub 来源

粘贴到 Codex,它会先检查安装条件,再引导你使用。

Playwright CLI 能帮你做什么?

  • 读取页面并定位元素

    获取页面快照,依据按钮、输入框和链接的实际信息决定操作,页面变化后重新确认定位。

  • 执行连续网页动作

    在浏览器会话中完成输入、点击、导航和标签页操作,并核对每一步是否产生预期结果。

  • 收集检查材料

    保存需要的截图、控制台或网络信息,帮助重现失败,也可配合 Playwright 测试工作。

什么时候适合用?

下面是用法示例,可换成你的材料和目标。

  • 检查结算测试路径

    例如在测试站填写地址、选择选项并查看结果,记录失败步骤,避免只看页面是否能打开。

  • 重复填写内部表单

    例如按提供的数据准备多条表单内容,逐项核对填入值,最终提交按已有任务授权执行。

怎么开始使用?

从材料到结果流程示意,非实测结果

页面与操作目标

准备这些材料网页操作与验证

网页地址、要完成的操作及必要账号授权

可核对的执行记录

  1. 01

    观察页面和目标

  2. 02

    执行所需网页操作

  3. 03

    截图并验证结果

准备什么,会得到什么?

准备的材料
网页地址、要完成的操作及必要账号授权
交付的结果
  • 网页操作或验证记录,包含关键步骤与结果。
  • 相关截图、日志或可复用的命令与测试线索。

使用前要知道

需要 Node.js 18+、Playwright CLI 和可用浏览器,单独复制 Skill 文本不会安装这些工具。当前 Codex 若提供其他浏览器接口,应遵循宿主实际支持的方式和权限。

常见问题

安装 Skill 后就自带浏览器吗?

不会。Skill 说明如何使用 CLI,CLI 和浏览器仍需按 Microsoft 当前安装流程准备,并确认能在本机启动或连接。

为什么之前能用的元素引用失效?

导航或页面更新后,快照中的引用可能变化。应先重新查看页面,再依据当前结构定位,避免继续对旧位置执行动作。

GitHub 与官方参考

依据项目说明与参考文档整理。页面中的任务与流程示例用于说明用法。

  • playwright-cli · SKILL.md ↗2026-10-31 核对
  • Playwright CLI · 安装与使用说明 ↗2026-10-31 核对
来源与使用条件
原始项目
microsoft/playwright-cli ↗
Skill 名称
playwright-cli
Skill 目录
skills/playwright-cli
仓库 Star
14,817 · 2026-10-31 核对,仅代表仓库关注度。
许可说明
以原项目许可为准
使用条件
需要 Node.js 18+、@playwright/cli 和可用浏览器。官方流程先安装 CLI,再运行 playwright-cli install --skills;已有项目也可检查本地 Playwright CLI。实际执行须符合当前 Codex 提供的浏览器接口与权限。
注意事项
Apache-2.0 许可。这个条目来自 Microsoft 官方 playwright-cli,已替换先前 openai/skills 的 Playwright 条目。仅复制 Skill 文本不会自动获得 CLI 和浏览器环境;当前站点未安装或运行验证。
查看安装与使用提示词
请帮我准备并使用 Playwright CLI Skill,完成下面的任务。请实际执行当前环境允许的安装与检查,不要只返回一份安装教程。

【来源与目标】
原始仓库:https://github.com/microsoft/playwright-cli
所选目录:skills/playwright-cli
参考分支:main
原始目录 frontmatter name:playwright-cli
安装后的目标调用名:playwright-cli
来源页面:https://github.com/microsoft/playwright-cli/tree/main/skills/playwright-cli
安装路线核对日期:2026-11-01
playwright-cli:当前源 SKILL.md:https://github.com/microsoft/playwright-cli/blob/main/skills/playwright-cli/SKILL.md
microsoft/playwright-cli:当前安装说明:https://github.com/microsoft/playwright-cli/blob/main/README.md
OpenAI:Build skills(Skill目录、发现和插件):https://learn.chatgpt.com/docs/build-skills

【先检查环境,再安装】
先识别操作系统、当前 shell、工作目录、同名 Skill 和已有工具;命令须适配实际平台并正确处理带空格的路径。默认安装到当前项目的 .agents/skills;如果没有可用项目目录,再使用用户目录的 .agents/skills。遵循当前 Codex 实际支持的位置;上游 CLI 或插件有专用目录时使用其正式方案。检查现有安装来源与完整性,能复用就复用,不重复注册相同来源、不覆盖用户修改。系统内置与所选第三方来源同名时保留系统版,明确区分来源和实际目录,不能只凭名称认定装过或选对了。
下文 ~/.agents/skills 是用户级路径示例;已选项目范围时,使用项目的 .agents/skills 并保持相同子目录层级。<SKILL_DIR>、<项目根目录> 等占位符须先换成核对过的真实路径再执行。依赖仓库的存放目录与 Codex 发现入口分别处理,不把缓存目录当作已注册入口。
这是 CLI 安装路线。先检查已安装的 CLI 和运行环境,再按下列项目文档为 Codex 生成所需文件;不要把仓库的源文件目录直接当作生成后的 Skill。

所选 Skill 的具体安装步骤:
1. 先检查 Node.js >=18、现有 playwright-cli 和当前 Skill;已有兼容版本先复用,不无条件替换全局软件。
2. 按当前官方 README,确需安装或升级时使用 npm install -g @playwright/cli@latest,再运行 playwright-cli --help 检查命令存在;仅在确需安装且当前环境允许时执行,不把安装命令当作只读检查。
3. 使用 playwright-cli install --skills 注册官方 Skill,检查它实际生成的位置和 name;如需项目级使用,按当前生成文件整体保存到 <项目根目录>/.agents/skills/playwright-cli,不只复制仓库静态文字。
4. 实际控制浏览器还需兼容浏览器二进制/运行环境;先列出已有条件与缺失项,不把 Skill 注册成功说成浏览器已启动或用户已登录。
5. Codex 自动检测 Skill 变更,未出现时再开新聊天/重载;只通过当前宿主允许的浏览器执行渠道操作。

必须保留的资源:
- 安装的 @playwright/cli 命令与运行时
- CLI 注册生成的完整 Skill 目录及 references/
- 实际任务使用的浏览器/配置与会话文件(属于运行环境,不能用一份 SKILL.md 替代)

已知依赖:需要 Node.js 18+、@playwright/cli 和可用浏览器。官方流程先安装 CLI,再运行 playwright-cli install --skills;已有项目也可检查本地 Playwright CLI。实际执行须符合当前 Codex 提供的浏览器接口与权限。
原项目许可:以原项目许可文件为准
特别条件:Apache-2.0 许可。这个条目来自 Microsoft 官方 playwright-cli,已替换先前 openai/skills 的 Playwright 条目。仅复制 Skill 文本不会自动获得 CLI 和浏览器环境;当前站点未安装或运行验证。
需要账号、密钥或服务时先检查现有可用连接;让用户在官方授权或本地配置入口完成,不要求把密钥粘贴到聊天。缺少付费服务或不支持的客户端能力时,明确剩余条件与可完成的范围。

【安装后验收】
读取实际安装位置的 SKILL.md,核对真实 name,并检查它引用的脚本、模板、共享文件与工具是否存在。若上游已迁移路径或更名,先核对正式说明再调整;找不到则报告实际错误,不猜路径或宣称成功。
1. 检查 node --version、playwright-cli --help 和生成的 SKILL.md frontmatter name;不会打开浏览器或访问网页。
2. 核对随 Skill 安装的 references/ 等资源;只读检查现有浏览器路径与配置,不为安装验收发起下载或浏览器会话。
Codex 通常自动发现变更;只有未出现时才引导新建聊天或重载。若本轮尚未出现在可用列表,可在允许的范围内读取已安装的完整文件继续准备任务,同时说明自动识别尚待确认。插件依赖的工具未连接时,不能用读取文件代替连接成功。
分别报告“文件已安装”“Codex 已识别”“任务所需能力已就绪”的实际状态和证据;失败时给出卡住的步骤、错误与下一步,不反复执行相同的失败命令。

【接着引导我使用】
请使用实际可用的 $playwright-cli;若实际名称发生变化,以刚核对的本地 name 为准。存在不同来源同名项时,明确选择所选来源与实际文件路径,避免调用成系统版或另一版本。对于必须由用户显式调用的 Skill,直接给我下一条可复制的调用语句。
- 提供获准 URL、本地服务启动条件和要完成的步骤;实际任务才打开目标页,先 snapshot 取得当前元素引用再交互。
- 页面更新后重新获取快照,检查操作结果;默认不共享系统 Chrome 的登录态,不把不同浏览器宿主的会话与权限混在一起。

我想完成的任务:
根据我给出的网址和目标,完成浏览器任务。先按官方说明检查 CLI、Skill 注册和浏览器环境;在当前 Codex 允许的浏览器接口内观察页面、按可见元素操作,并核对每一步结果。提交业务数据、付款、发布等动作必须在我明确授权的范围内进行。

需要我提供的材料:
网页地址、要完成的操作及必要账号授权

期望得到:
实际取得的信息、经过验证的操作结果或网页测试记录;适合时提供截图和复现步骤。若缺少登录、权限或浏览器能力,指出具体停在哪一步,不伪称已完成。

先查看我在当前聊天中已经提供的目标与材料,只问缺少的关键内容;没有材料时,告诉我第一步提供什么,可给一个简短示例。条件满足后从一个小任务开始,检查输出,再说明怎样继续使用。示例仅用于演示,不充当我的真实数据;没有执行过的步骤、测试或交付物不要写成已经完成。需要发送、发布或修改外部账号内容时,先让我核对具体对象和内容。

相关 Skill

  • Browser Use多步骤浏览器任务
  • n8n Loops批次与分页流程
  • n8n Data Tables工作流状态表

复制到 Codex

浏览器暂未允许直接复制。点击下方文字,按 Ctrl+C(Mac 按 ⌘C)复制,再粘贴到 Codex。

三步开始使用

  1. 找到想做的事,点击「复制提示词」。
  2. 打开 Codex,把提示词粘贴进去并发送。
  3. 按它的提示提供文件或材料,继续完成任务。

按需安装就好,不用一次装完。部分 Skill 需要软件、账号或付费服务,Codex 会先检查使用条件。