用途：从终端驱动真实浏览器完成自动化任务，包括页面导航、表单填写、元素快照、截图、数据提取以及 UI 流程调试。定位为 CLI 优先的自动化方式，除非用户明确要求测试文件，否则不转向 @playwright/test。
前置检查：在提出命令前需确认 npx 可用，命令为 command -v npx >/dev/null 2>&1。若不可用，应暂停并请用户安装提供 npx 的 Node.js/npm，步骤如下：node --version、npm --version。若缺失则安装 Node.js/npm，然后执行 npm install -g @playwright/cli@latest 和 playwright-cli --help。npx 就绪后使用包装脚本；全局安装 playwright-cli 为可选项。脚本与参考文件位于 {baseDir}/ 下。
主要能力与用法：优先使用包装脚本，它通过 npx --package @playwright/cli playwright-cli 运行，无需全局安装。快速开始示例："$PWCLI" open https://playwright.dev --headed、"$PWCLI" snapshot、"$PWCLI" click e15、"$PWCLI" type "Playwright"、"$PWCLI" press Enter、"$PWCLI" screenshot。核心工作流为先打开页面，再快照获取稳定元素引用，使用最新快照中的引用进行交互，导航或 DOM 显著变化后重新快照，必要时捕获截图、PDF 或 traces 等产物。
建议模式包括表单填写与提交、使用 tracing-start 与 tracing-stop 调试 UI 流程、以及多标签页操作（tab-new、tab-list、tab-select）。
限制与护栏：引用元素 id 前必须快照；引用疑似失效时重新快照；除非必要，优先使用显式命令而非 eval 和 run-code；没有新鲜快照时可使用 eX 之类的占位引用并说明原因，不得绕过引用；视觉检查有帮助时使用 --headed；在本仓库捕获产物应使用 output/playwright/，避免新增顶层产物目录。默认使用 CLI 命令与工作流，而非 Playwright 测试规范。当不使用及何时使用部分资料未提供具体内容，暂未提供。