用途:该技能用于从终端自动化真实浏览器,覆盖页面导航、表单填写、元素快照、截图、数据提取和 UI 流程调试等任务。定位为 CLI 优先的自动化,除非用户明确要求测试文件,否则不切换到 @playwright/test。
前置检查:使用前需确认 npx 可用,命令为 command -v npx >/dev/null 2>&1。若不可用,应暂停并请用户安装 Node.js/npm,步骤为:node --version、npm --version,缺失时安装 Node.js/npm,然后执行 npm install -g @playwright/mcp@latest 与 playwright-cli --help。
技能路径:设置 export SKILLS_ROOT="${LOBSTERAI_SKILLS_ROOT:-${SKILLS_ROOT:-$HOME/Library/Application Support/LobsterAI/SKILLs}}" 与 export PWCLI="$SKILLS_ROOT/playwright/scripts/playwright_cli.sh"。已安装技能从 $LOBSTERAI_SKILLS_ROOT / $SKILLS_ROOT 解析,生产默认位于应用 userData/SKILLs,macOS 通常为 ~/Library/Application Support/LobsterAI/SKILLs。
快速开始:使用包装脚本,例如 "$PWCLI" open https://playwright.dev --headed、"$PWCLI" snapshot、"$PWCLI" click e15、"$PWCLI" type "Playwright"、"$PWCLI" press Enter、"$PWCLI" screenshot。也可全局安装:npm install -g @playwright/mcp@latest 与 playwright-cli --help。
核心流程:打开页面;快照获取稳定元素引用;使用最新快照中的引用交互;导航或 DOM 显著变化后重新快照;需要时捕获截图、PDF、追踪等产物。最小循环为 open、snapshot、click、snapshot。导航、点击导致 UI 大幅变化、开关模态框或菜单、切换标签页后应重新快照;引用可能失效,命令因缺少引用失败时重新快照。
推荐模式:表单填写与提交使用 open、snapshot、fill、click、snapshot;用 tracing-start 与 tracing-stop 调试 UI 流程;多标签页使用 tab-new、tab-list、tab-select、snapshot。包装脚本通过 npx --package @playwright/mcp playwright-cli 运行,无需全局安装,除非仓库已统一使用全局安装。
参考与护栏:按需查阅 references/cli.md 与 references/workflows.md。引用元素 id 前始终先快照;引用疑似失效时重新快照;优先显式命令而非 eval 与 run-code;没有新快照时使用 eX 之类占位引用并说明原因,不要用 run-code 绕过引用;需要视觉检查时使用 --headed;在本仓库捕获产物使用 output/playwright/,避免新增顶层产物目录;默认使用 CLI 命令与工作流,而非 Playwright 测试规范。