用途:当某个 PR 的 CI 变红时使用该工作流,目标是让 CI 变绿,或记录下真实存在的阻塞问题。
主要能力与流程:
- 列出失败的检查:gh pr checks 和 gh run list --branch $(git branch --show-current) --limit 5。
- 对每个失败的运行,获取失败作业日志:gh run view <run-id> --log-failed。
- 按类型聚类失败:构建/类型错误(解析编译器输出的 file:line 并修复直接原因)、Lint/格式(运行对应本地命令并应用格式化工具)、测试(在可行时本地重跑失败测试,区分偶发失败与真实失败)、基础设施/依赖(锁文件漂移、缺失环境变量、runner 镜像问题)。
- 每个聚类应用最小修复,不捆绑无关清理。
- 提交信息形如 fix(ci): <cluster description> 并推送。
- 循环有硬性上限(默认 5 次尝试),每次尝试后在 ledger/current.md 记录带日期的笔记。
- 若失败看起来是环境问题(runner 故障、瞬时网络),重试一次,否则上报给人工。
循环控制:当某次修复尝试未改变失败模式时停止并报告;当失败表明用户预期改动存在真实问题(而非仅 CI 问题)时停止并报告;除非明确授权并记录,绝不通过禁用或跳过测试来修复。
最终报告需包含:开始时的失败检查、每个聚类应用的修复、推送的提交、最终 CI 状态、任何剩余失败及其分类(偶发/真实/环境)。
限制:资料未提供安装方式、收费、支持平台等细节。