用途：当 Playwright 脚本原本可用却开始失败、测试间歇性不稳定（flaky）、出现“元素未找到”或超时错误、元素不可交互等自动化异常时，使用该技能进行系统化调试。不适用于编写新自动化（应使用 playwright-patterns 技能）或 API/后端调试。
主要能力：提供按问题类型划分的快速排查表（定位器超时、flaky 测试、元素不可见、本地通过 CI 失败、元素不可点击、陈旧元素等），并给出诊断框架：先复现与隔离，再增加可见性，然后检查元素状态、验证选择器，最后按常见问题与修复处理。
使用方式：可用 npx playwright test path/to/test.spec.js 隔离单个测试，用 --headed 观察，用 --headed --slow-mo=1000 放慢动作；用 npx playwright test --ui 进行时间旅行调试，用 npx playwright test --debug 逐步执行并实时选取定位器；用 DEBUG=pw:api npx playwright test 查看 API 日志，用 PWDEBUG=console 在浏览器 DevTools 中使用 playwright.$、playwright.$$、playwright.inspect、playwright.locator；用 tracing.start/stop 记录并用 npx playwright show-trace trace.zip 查看轨迹；也可安装 VS Code 扩展进行断点调试。
适用场景：本地开发调试、CI 失败复现、选择器与元素状态验证、时序与竞态问题定位、表单提交异常排查。
限制与注意：资料强调多数问题与时序有关，应把 waitForTimeout 替换为基于条件的等待；force 点击应作为最后手段并先查明根因；需同时测试无头模式；避免使用脆弱选择器。资料未提供该技能的安装命令、收费方式或平台支持范围。