用途:接收失败、flaky 或标红的 Playwright E2E 测试,用 trace 证据定位根因,并持续修复重跑,直到稳定通过。执行机械操作(浏览器启动、tracing-start/stop、trace zip 查看)可交给 playwright-cli 技能,本技能专注诊断判断。
主要能力:trace 中包含每步动作与顺序、步骤截图(DOM+截图)、全部网络请求响应(头、体、状态码、时间)、控制台日志与错误栈。按症状只取需要的部分核查:卡在哪一步看失败前快照;定位器超时看当时 DOM;数据或状态异常看网络;JS 异常或白屏看控制台。
使用方式:循环 run → debug → root-cause → fix → verify。先只对指定 spec 开 trace 复现,确认失败真实可复现,一次就过说明可能 flaky,可用 --repeat-each 看复现率;再用 trace 缩小线索;根因阶段三角对照测试代码、产品代码与 git diff,判断是测试过时还是产品回归,模糊时停下来带证据询问;修复只改判定的一侧,测试侧用稳定选择器、显式等待、确定性 fixture,产品侧修回归并视情况补强断言;最后同 spec 带 trace 重跑,确认稳定绿后跑 lint 与 type-check(本仓库为 yarn lint / yarn type-check)。重复两三次无进展就停止并报告。
限制与禁止:不要不打开 trace 只凭栈猜测;不要在未知原因下弱化或删除断言、加长 sleep 来变绿;不要产品回归却改测试掩盖;不要一轮同时大改两侧;不要未验证尤其是 flaky 未重复运行就报告已修复。具体命令与更多参考文件见原文,其他收费、平台等信息暂未提供。