用途:为网页项目提供浏览器自动化能力,基于 playwright-cli(微软官方 Playwright 命令行)实现,浏览器自动启停,无需管理守护进程。
主要能力:会话启动与隔离,通过 bin/open 按目录生成会话名,并在 Claude Code 下结合 CLAUDE_SESSION_ID 让并行代理互不干扰;读取每次命令后生成的可访问性树快照(.playwright-cli/page-<timestamp>.yml),用其中的 [ref=eN] 标识执行点击、填充、悬停等操作;核心命令覆盖导航、交互、观察、对话框处理与会话管理;提供 CSS 选择器回退脚本处理模态框、隐藏文件输入和框架事件目标;支持认证配置的保存与加载,存于 .playwright-skill/auth/;提供 run-code 逃生口执行任意 Playwright JS;内置上下文捕获与 QA 工作流,通过 bin/context、bin/inject-capture、bin/cache-query 收集快照、控制台、网络和截图数据并按 ID 查询。
使用方式:先运行 bin/open --headed 启动,再 playwright-cli goto <url> 导航;操作后读取快照文件获取 ref;交互用 playwright-cli click/fill/type/press/hover/select;认证可先 bin/auth-save <profile-name> 保存,后续 bin/auth-load <profile-name> 恢复;结束时 bin/close 清理。多会话时用 -s=<session> 前缀指定。
适用场景与限制:适合本地网页项目的自动化测试、调试与 QA。导航仅限项目 baseUrl 及其子路径,避免向未知域名泄露 cookie 和认证令牌。会话名与 baseUrl 等需在 skill/worktrees.json 中配置,其格式与设置说明需参见 skill/CONFIG.md。部分功能(如认证配置、上下文缓存)依赖项目内配置或脚本文件,具体可用性暂未提供完整说明。