技能介绍

要解决什么问题

维护浏览器自动化脚本时，常见路径是：在 DevTools 里审查元素 → 翻 CSS 与属性 → 手写 Playwright 选择器 → 页面一改类名就全线失效。本技能把这条链路收成「在真实页面里操作，后端收特征、写步骤」的录制闭环，并为目标元素生成多策略定位器，前序失败时自动降级，减轻样式小改版带来的脚本雪崩。

技能如何工作

录制侧用 Playwright 打开目标页，注入 record_spy.js 探针：悬停时虚线高亮可选元素，点击在捕获阶段拦截并抽取 tagName / role / testId / label / placeholder / text / 过滤后的 className 等特征，并支持 Shadow DOM 与 Enter、Tab 等按键记录。Python 后端按 9 级启发式（可选 --ai-refine）写出 locators 数组，顺序覆盖 test_id → role → label → placeholder → text → css_fuzzy 等策略；每步模拟执行、networkidle 等待，并留存 before/after 截图到 steps.json。输入框内容可落成 {{variable_name}}，由 skill_config.json 声明变量与 start_url。

适用边界与注意

当前动作类型以 click / fill / hover / press / check / uncheck / select / focus 为主；拖拽与滚动需手改 steps.json。探针依赖脚本注入，严格 CSP 或部分 Portal 渲染可能导致漏捕。回放异常时用 --dry-run、--step 单步调试并检查 locators 前几项；登录态可通过首步 cookie 或 storageState 处理。另含订舱场景下固定阶段话术的 Agent 回复规则，与录制/回放引擎本身分开配置。