SuperAPI AI 工具集

ci-forensics

通用与其它

查看项目

更新于 10-16 06:16

技能介绍

用途:在读取 CI 日志、诊断 GitHub Actions 失败时使用,帮助先分类再动手,避免把基础设施抖动当成代码问题去修改。

拉取日志的推荐顺序:先调用 mcp__github__actions_list,method 为 list_workflow_runs,branch 填 head ref;再用 mcp__github__get_job_logs,run_id 填 run,failed_only 为 true;最后用 get_job_logs,job_id 填 job,return_content 为 true,tail_lines 为 200。

已知陷阱:actions_list 与 actions_get 都由 method 判别器复用,缺少 method 会报错;actions_get 需要 resource_id 而非 run_id,返回元数据而非日志,不适合日志排查;get_check_run 按 checkRunId 取单个检查运行,没有列表模式,判断某 sha 是否通过应使用 actions_list → list_workflow_runs 并按 head_sha 过滤;list_workflow_runs 可能超出 token 限制被写入文件,应用 node -e 解析,不要直接内联读取。

失败分类:真实回归(可追溯到 diff 中某文件某行、本地可复现、测试新增或刚改动)应修复并补回归测试;偶发(同一 commit sha 结果不同,痕迹含时序、顺序、端口、网络)应至少跨 3 次运行确认后隔离;基础设施问题(runner OOM、磁盘满、镜像拉取失败、registry 5xx、action 下载超时)应重跑,重跑两次后升级处理,绝不改代码;基线损坏(同 job 在分叉点之前的基线上也红)上报一次等待恢复;配置漂移(workflow YAML、action 输入或缺失 secret)修 workflow;依赖问题(无源码变更却出现,第三方包新发布)应固定或回滚。

判定“基线损坏”要查基线分支在早于分叉点的 commit 上同一 job 的运行结果,不能凭错误文本推断。判定偶发与真实:同一 sha 结果不同是决定性证据;相邻运行通过且无相关变更是强证据;仅在并行时失败强,提示顺序或共享状态;仅在特定系统或运行时版本失败为中等;仅“重跑就过”为弱,不足以单独成立。从未通过过的测试不是偶发,是坏的。失败率可提示机制:约 50% 常为异步竞态,约 2% 常为资源压力或实时依赖。

不确定性来源:真实时间、未播种随机、测试顺序与共享模块状态、固定端口、共享数据库行、复用的临时路径、缺失 await、真实网络调用、资源压力。

禁止事项:不要为让 CI 通过而禁用、跳过或加 .only 测试,.only 会静默禁用同文件其余测试;不要不记录原因就重跑掩盖失败;没有绿色运行可指之前不要声称 CI 已修复。相关:actions-authoring 用于修 workflow 本身,../commands/ci.md 提供驱动到绿的循环。