메뉴
使用 playwright-cli 做网页导航、表单交互、截图、录屏、网络调试、多标签和会话管理。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
维护配置系统、服务编排、离线工具与自动化调度的手册。
维护 Web 入口、Flask app factory、页面探针与全局运行时 hook 的手册。
维护摘要生成、缓存、任务状态、SSE 通知与模型切换全链路的手册。
使用 MinerU 云 API 解析 PDF、Office、图片或 HTML 文档，并通过轮询或批量接口获取结果。
维护 aslite 数据层、SQLite KV、仓储、索引与底层状态库的手册。
维护模板、静态脚本、CSS、manifest 与页面级交互契约的手册。
| name | playwright-cli |
| description | 使用 playwright-cli 做网页导航、表单交互、截图、录屏、网络调试、多标签和会话管理。 |
| license | Apache-2.0 |
| compatibility | opencode |
| metadata | {"category":"browser-automation","requires_cli":"@playwright/cli","workflow":"cli-first"} |
playwright-cli 驱动真实浏览器完成网页任务需要先具备这些前提：
npm install -g @playwright/cli@latest
playwright-cli --help
npx playwright-cli --help
playwright-cli install --skills
优先使用我：
playwright-cli不要优先使用我：
@playwright/cli 且用户不希望安装任何额外工具playwright-cli 的基本流程是：
open 或 gotosnapshot 获取元素引用e15 的 ref 做 click / fill / check / selectclose 或保留 session 继续工作重要习惯：
snapshotsnapshotscreenshot 适合交付物，snapshot 才是主工作流playwright-cli open https://playwright.dev
playwright-cli snapshot
playwright-cli click e15
playwright-cli type "locator"
playwright-cli press Enter
playwright-cli screenshot
playwright-cli close
playwright-cli open
playwright-cli open https://example.com
playwright-cli open https://example.com --headed
playwright-cli goto https://example.com/login
playwright-cli reload
playwright-cli go-back
playwright-cli go-forward
playwright-cli snapshot
playwright-cli click e3
playwright-cli dblclick e7
playwright-cli fill e5 "user@example.com"
playwright-cli type "hello"
playwright-cli press Enter
playwright-cli hover e4
playwright-cli select e9 "option-value"
playwright-cli check e12
playwright-cli uncheck e12
playwright-cli drag e2 e8
playwright-cli upload ./document.pdf
playwright-cli eval "document.title"
playwright-cli eval "el => el.textContent" e5
playwright-cli screenshot
playwright-cli screenshot e5
playwright-cli screenshot --filename=page.png
playwright-cli pdf --filename=page.pdf
playwright-cli console
playwright-cli console warning
playwright-cli network
playwright-cli run-code "async page => await page.title()"
playwright-cli tracing-start
playwright-cli tracing-stop
playwright-cli video-start
playwright-cli video-stop demo.webm
playwright-cli route "**/*.jpg" --status=404
playwright-cli route-list
playwright-cli unroute
命名 session 很重要，尤其是并行任务或需要长期保留登录态时。
playwright-cli -s=todo-app open https://demo.playwright.dev/todomvc/ --persistent
playwright-cli -s=todo-app snapshot
playwright-cli -s=todo-app click e21
playwright-cli -s=todo-app close
常用命令：
playwright-cli list
playwright-cli close-all
playwright-cli kill-all
playwright-cli show
如果用户希望 agent 默认使用同一个 session，也可以配合环境变量：
PLAYWRIGHT_CLI_SESSION=todo-app claude .
--persistent 会把 profile 落盘，适合需要跨重启保留状态state-save / state-load 适合显式保存与恢复登录态常用命令：
playwright-cli state-save auth.json
playwright-cli state-load auth.json
playwright-cli cookie-list
playwright-cli localstorage-list
playwright-cli sessionstorage-list
更多细节见：references/session-management.md
open 到目标页面snapshotconsole / network / screenshot 留证据snapshotfill / type 输入snapshotstate-save 或 --persistentconsolenetworktracing-start / tracing-stop更多细节见：references/test-generation.md
playwright-cli open --browser=chrome
playwright-cli open --browser=firefox
playwright-cli open --browser=webkit
playwright-cli open --browser=msedge
playwright-cli open --extension
playwright-cli open --persistent
playwright-cli open --profile=/path/to/profile
playwright-cli open --config=my-config.json
一个任务完成得好，通常至少满足：
snapshot 就直接猜元素 ref@playwright/cli，却直接假设 playwright-cli 可执行如果用户的环境里没有全局二进制，可改用：
npx playwright-cli open https://example.com
npx playwright-cli snapshot
这个 skill 在仓库里带了一个最小 smoke test：
python -m unittest "skills/playwright-cli/tests/test_playwright_cli_smoke.py"
它会验证两件事：
playwright-cli --help 可用open -> snapshot -> eval -> close 可跑通