用途:在终端中自动化真实浏览器,完成页面导航、表单填写、页面快照、截图、数据提取和 UI 流程调试。该技能定位为 CLI 优先,不主动转向 @playwright/test,除非用户明确要求测试文件。
主要能力:打开页面、通过快照获取稳定元素引用(如 e15)、点击/输入/按键、截图、生成 PDF 与追踪(tracing-start / tracing-stop)、多标签页操作(tab-new / tab-list / tab-select)。
使用方式:先检查 npx 是否可用:command -v npx >/dev/null 2>&1。若不可用,需安装 Node.js/npm,可执行 npm install -g @playwright/cli@latest 与 playwright-cli --help。设置技能路径后使用包装脚本:export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"、export PWCLI="$CODEX_HOME/skills/playwright/scripts/playwright_cli.sh"。快速开始示例:"$PWCLI" open https://playwright.dev --headed、"$PWCLI" snapshot、"$PWCLI" click e15、"$PWCLI" type "Playwright"、"$PWCLI" press Enter、"$PWCLI" screenshot。核心流程:打开页面→快照获取引用→用最新快照的引用交互→导航或 DOM 重大变化后重新快照。表单填写用 fill,调试用 tracing-start/tracing-stop。
适用场景:终端浏览器自动化、UI 流程调试、页面数据提取。需视觉检查时加 --headed;产物统一放在 output/playwright/。
限制:包装脚本依赖 npx;引用可能失效,失败时需重新快照;禁止在无新快照时用 run-code 绕过引用;不声称使用未暴露的 MCP;需以本地文件、日志或截图等直接证据验证结果,未经验证的限制需明确说明。