用途:用于需要自动化浏览器交互的场景,例如导航网站、填写表单、截图、从网页提取数据,以及通过命令行管理浏览器会话。
主要能力:所有命令通过随该技能提供的 browse.sh 包装脚本执行,它调用 npx @playwright/cli 并采用正确配置;该配置启用有界面模式、持久会话,并把所有数据存放在项目的 .playwright/data/ 目录。核心命令覆盖打开与导航页面、点击、双击、填写、拖拽、悬停、选择、上传、勾选、快照、求值、对话框处理、调整窗口和关闭。导航类命令包括后退、前进、重新加载。键盘与鼠标命令支持按键、按下与释放、移动、按下与释放、滚轮等。截图和 PDF 可保存到 .playwright/data/screenshots/ 指定文件名。标签页命令支持列出、新建、关闭、选择。存储命令支持保存与加载状态,以及 Cookies、localStorage、sessionStorage 的增删查改与清空。网络命令可拦截指定路由并返回状态或自定义响应体,也可列出与取消拦截。DevTools 类命令可查看控制台和网络记录、运行 Playwright 代码、开启与停止追踪、开始与停止录制视频。
使用方式:从技能基础目录调用 browse.sh,例如 <skill-base-dir>/browse.sh open <url>、browse.sh click e15、browse.sh fill e5 "search query"、browse.sh press Enter、browse.sh snapshot、browse.sh close。每条命令执行后会提供当前浏览器状态的快照。可用 --filename 指定快照或截图的输出文件名。会话数据存放于 .playwright/data/session/,快照存放于 .playwright/data/output/(相对于工作目录)。多会话可用 -s=名称 指定,如 browse.sh -s=mysession open example.com;另有 list、close-all、kill-all 等管理命令。具体任务的参考文档包括 references/session-management.md、request-mocking.md、running-code.md、storage-state.md、test-generation.md、tracing.md、video-recording.md。项目特有的覆盖项(基础 URL、浏览器选择、开发服务器指令)应查看 CLAUDE.md 的 ## Browser testing 部分。
适用场景:网页表单提交、多标签页工作流、用 DevTools 调试、会话与存储状态管理、请求模拟、追踪与视频录制等浏览器自动化任务。
限制:使用前需具备可调用 @playwright/cli 的环境;具体浏览器类型、平台和运行要求以资料提供的命令为准,其余细节暂未提供。