技能介绍

要解决什么问题

编码代理（如 Claude Code、GitHub Copilot，或任意其他编码代理）常需要在浏览器里验证改动：打开页面、确认元素状态、点击或输入、截图留证。传统路径要么让代理加载一套完整的浏览器自动化服务，环境依赖重、上下文占用大；要么代理先手写一版 Playwright 脚本，再手动执行、调试，一轮迭代的成本很高。

核心能力与关键步骤

该技能把浏览器操作收敛为 Playwright CLI 的简洁 shell 命令：

页面导航：打开目标页面并取回可读的快照（snapshot），代理据此判断当前 DOM 状态
交互操作：点击、输入等动作由命令直接驱动，不必先写脚本
截图取证：捕获截图，便于事后回溯失败现场
会话管理：管理浏览器会话，避免每次操作都重建上下文

工作方式上，代理在 shell 里执行 playwright-cli 命令即可，无需引入常驻的自动化服务器。命令是否可用由 CLI 自身确认，拿到环境后先用 playwright-cli --help 探一遍能力面。

适用边界与注意点

运行环境要求 Node.js 18 及以上，并能从编码代理一侧取得 shell 权限
若使用 PLAYWRIGHT_MCP_EXTENSION 连接已在运行的浏览器实例，仅支持 Edge/Chrome，且需要预先安装 "Playwright MCP Bridge" 浏览器扩展
调用方式取决于本地版本是否就绪：本地已可用时走 npx playwright-cli，否则需要把 playwright-cli 作为全局命令安装
复杂的断言逻辑与多步骤状态编排仍可能需要脚本配合，CLI 路径更适合以会话为单位的轻量操作