ci-auto-fix 用于处理 CI 失败:定位原因、做最小合理修复,并在推送后的修订版上验证 CI 是否通过。调查范围随不确定性和影响面扩展,每条路径都执行完成度检查,单次调用最多四轮修复-推送循环。
使用方式:先读取反模式参考,仅在需要做某项决策时加载对应参考。若调用方提供的证据在修订版、运行尝试和范围上匹配,则复用而不重复发现。流程分阶段:阶段0解析 GitHub 访问与目标,接受 PR URL、Actions 运行 URL/ID 或 check-run ID;无参数时解析当前分支的开放 PR,否则查找当前 SHA 上的失败运行。阶段1先列出检查与任务再抓取日志,按日志保存并在本地分析,按可能根因分组。阶段2检查失败命令、相关源码/配置与工作流任务,必要时扩展到调用方和兄弟任务。阶段3按根因分组判定路径:机械路径要求日志给出确切命令与受影响文件、存在确定性修复、无需对断言/公共 API/运行时/依赖/安全边界/共享工作流行为做判断,且本地可验证;否则走诊断路径,需记录假设、支持与冲突证据、受影响使用方及验证方式。阶段4在合适层面修复根因,保持改动范围受控。阶段5运行最小可证伪检查及受影响 CI 命令。阶段6审查差异、暂存相关文件、以根因摘要提交,变基后推送,禁止强推。阶段7监控所有相关检查,单次成功不足。阶段8用回归检测区分未变失败、新暴露失败、无关损坏与引入的回归。阶段9报告结果、目标与最终 SHA、原因、修复、本地验证、计数及 CI 链接。限制:修复-推送上限四轮,两次引入回归或诊断无法推进即停止;CI 专属条件无法本地复现时需记录原因并说明。官方未提供收费、平台与价格信息。