本技能封装微软 @playwright/cli,用于实时的端到端浏览器自动化。使用前需确保 playwright-cli 在 PATH 中,可通过 npm install -g @playwright/cli 安装;若缺失应提示用户安装,而不是改用其他自动化方案。
主要能力包括:命名会话(-s=<flow>)隔离多步流程;快照(snapshot)生成含元素引用(如 e1、e2)的 YAML 文件,交互时按引用操作,而非 CSS 选择器;按引用点点击、填写并提交,截图,汇总控制台消息,以及关闭会话。快照与截图写入磁盘,仅路径回到上下文,上游测量称相比 Playwright MCP 约有 4 倍 token 降低(27K 对 114K)。
典型用法:先执行 playwright-cli kill-all 清理陈旧会话;再执行 playwright-cli -s=<flow> open <url>、snapshot、click e42、fill e37 "input" --submit、screenshot --filename=meaningful-name.png、console、close。命名会话用于多步工作;结束时 close 避免残留浏览器;--headed 仅在用户明确要求观察时使用。产物落在当前工作目录相对的 .playwright-cli/,建议加入 .gitignore。
默认行为:无头模式、内存隔离浏览器配置、动作超时 5000 毫秒、导航超时 60000 毫秒、控制台级别 info、视口 1280×720。视频录制是例外:帧尺寸由浏览器上下文创建时的视口决定并适配到 800×800 框,裸启动会录成 800×450,需用 PLAYWRIGHT_MCP_VIEWPORT_SIZE=<W>x<H> 前缀加 video-start --size "<W>x<H>" 两个匹配参数才能改变尺寸。
场景化参考文件覆盖命令参考、会话、快照与引用、存储与认证、跟踪与视频、网络模拟、运行代码、测试生成、Windows 特殊行为及编排器配方等。调用动作包括默认的实时自动化指引、update 漂移检查(只读)以及 update --apply 刷新 vendor 并更新元数据;脚本入口为 bash "${CLAUDE_PLUGIN_ROOT}/skills/playwright/scripts/update.sh" [--check|--apply|--help]。该技能可独立使用,也可与项目已有的测试编排、结果验证或 @playwright/test 视觉回归配合。收费、价格与平台支持等细节暂未提供。