用途:当 Renovate 自动创建的依赖升级 PR 出现 CI 失败时,用最小且正确的改动让检查重新通过,并保留可验证的证据。
主要能力:定位目标 PR(支持 PR 编号或 URL;未提供时用 GitHub MCP 搜索近 14 天内更新且检查失败的 Renovate PR,优先匹配当前分支,多个候选时让用户选择);检查失败的工作流与作业;阅读 PR 正文、变更文件摘要与讨论;必要时在 PR 上发布评论。
使用方式:全程使用 GitHub MCP 工具获取和更新 GitHub 数据,不用原始 git remote 命令或手动抓取。流程为:确认 PR 范围(改了哪些依赖与锁文件、哪些检查失败);完整阅读失败日志,找出第一个真实错误;将失败归类为 installOrLockfile、typeOrBuild、tests、lintOrFormat、peerOrCompanionMismatch 或 runtimeOrCompatibility;尽量以 CI 一致的方式复现(用 npm ci 而非 npm install,运行 CI 中完全相同的失败命令,匹配 CI 的 Node 与工具版本);应用针对根因的最小修复,例如兼容性代码调整、工具链版本对齐、按仓库策略最小化重生成锁文件、在合理时收紧依赖约束或覆盖、回退到上一个已知良好版本;仅在证据表明能防止复发时才改 Renovate 配置,且保持范围窄、优先使用定向 packageRules;最后重新运行失败命令验证并总结失败检查、根因、修复理由、改动文件与验证情况。
决策点:若日志显示超时或注册表故障等基础设施抖动,先重跑一次再改代码;若修复范围超过 10 个文件或 300 行、或跨层复杂,停止并给出分阶段方案;若尝试 2-3 次仍卡住,停止并报告尝试、最佳假设与下一步。
限制:需具备 GitHub MCP 工具环境;不暴露 CI 日志中的密钥或个人信息;对等/伴随依赖需一起对齐版本,缺失的对等或可选依赖应加在直接依赖父包的工作区包中,而非 monorepo 根(除非根是直接消费者)。