用途：该技能用于网页自动化、调试与端到端（E2E）测试，底层使用 Playwright，支持 Python 或 JavaScript/TypeScript。
主要能力：提供交互模式（点击、输入、导航，如登录流程、表单提交）、被动模式（仅观察，如网络抓包、控制台监控）和 E2E 测试模式（Playwright Test 框架）。附带多个辅助脚本：表单交互、截图捕获、Cookie 同意处理、页面元素发现、网络流量捕获、控制台调试、网络与控制台联合调试、网站视觉对比。
使用方式：建议先运行辅助脚本，例如： uv run ~/.claude/skills/web-automation/examples/python/element_discovery.py http://localhost:3000 uv run ~/.claude/skills/web-automation/examples/python/screenshot_capture.py http://localhost:3000 --output /tmp/shots 被动调试脚本示例： uv run ~/.claude/skills/web-automation/scripts/combined_debugger.py --duration 30 --output /tmp/debug.json 安全验证可结合 console_debugger.py 与 grep 检索敏感字段。视觉对比使用 visual_compare.py 比较两个站点并读取截图。
适用场景：验证前端 UI 修复、测试表单字段与下拉框、确认视觉变化、复现缺陷、在静态分析发现问题后进行安全验证。
限制与注意事项：页面遮罩层会阻断自动化，需在每次 page.goto() 后关闭；应在 DOM 检查前等待 networkidle；CI 中应使用 headless: true；避免使用易失效的 CSS 选择器，优先 role/text/test id；使用显式等待而非固定超时。Python 脚本内联依赖由 uv run 自动安装；JavaScript 需 npm install -D @playwright/test 并 npx playwright install chromium。具体实现细节见 references 目录下文档。