用途:将 Playwright 的 trace.zip(或解包后的 trace JSONL/目录)转为按影响排序、带证据的测试分析报告,定位 flaky、慢步骤与根因。输入可为 GitHub Actions 运行 URL、trace.zip、解包 trace 目录、单个 trace.trace JSONL、单个 trace.network JSONL,或 report.json(仅作测试状态总览,时序与网络以 trace 为准);也可扫描 test-results/ 目录中每个失败测试的最新 trace.zip。
主要能力:提取动作时间线、网络瀑布、控制台与页面错误,统计总墙钟时间、Top-N 慢动作与慢请求、动作堆栈;当提供同一测试的通过/失败两份 trace 时可做差异对比。最终产出修复计划,含排序修复项、预期节省毫秒与复验步骤。
使用方式(命令保持原样): GitHub Actions 运行 URL:node <skill_dir>/scripts/fetch-gh-run.mjs https://github.com/<owner>/<repo>/actions/runs/<id> [--out <dir>] trace.zip 解包:node <skill_dir>/scripts/trace-extract.mjs <path/to/trace.zip> [--out <dir>] 摘要:node <skill_dir>/scripts/trace-summary.mjs <dir> 通过/失败对比:node <skill_dir>/scripts/trace-diff.mjs <pass-dir> <fail-dir> 若 gh 未安装或未认证,需手动从 Actions 页面下载 trace 并传入本地路径。
流程为 6 个阶段:输入识别、测量框架、热点提取、根因、置信度门槛(/confidence ≥ 90%,否则最多两轮深挖)、修复计划。要求先测量再建议,区分症状与根因,按影响而非易度排序。
适用场景与限制:适用于 Playwright E2E 测试排障与性能分析,尤其是 CI 场景。资料未说明是否需要额外依赖(除 gh CLI 外)、价格、平台或自动化程度;部分能力依赖具体脚本与规则文件,且报告结论受 trace 数据完整性影响。