Agent Skills
返回列表
💻

CI 失败 PR 修复

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/fix-failing-pull-requests-by-analyzing-ci-errors-and-pushing-targeted-repairs。

技能介绍

要解决什么问题

PR 合并前被 CI 检查卡住是常态:本地跑得通,流水线却红了。排查这些失败通常要手动翻日志、定位根因、改代码、重新推送,一轮下来十几分钟到几小时不等,且这类排查高度重复。当失败原因明确、修复方案机械可执行时,这件事完全可以交给 agent 做。

工作方式

该技能基于 GitHub Next 的 pr-fix 工作流,在 PR 被失败的检查阻塞且修复方案机器可判定时介入:

  • 读取失败上下文:通过 gh 与 gh-aw 扩展获取 CI 运行状态、日志和错误输出。
  • 追踪根因:分析错误信息与失败栈,区分真实代码缺陷与偶发环境问题。
  • 应用针对性修复:只在 PR 分支上做最小改动,不夹带无关重构。
  • 留下可审查的历史:修复以独立的 commit 推送到原分支,reviewer 可以像对待人工提交一样逐条 diff 审查。

适用边界

  • 仅适合机器可做的修复,例如修类型错误、补依赖声明、改配置文件、修正 lint 违规;架构级问题仍需人工介入。
  • 依赖环境装有 GitHub CLI 和 gh-aw 扩展,未配置则无法运行。
  • 修复提交在 PR 分支上进行,不会绕过 review 流程——它生成的是需要人来确认的代码变更,而非自动合并。

使用场景

  • PR 合并前 CI 检查变红,需要定位失败原因并在分支上推送修复,让流水线重新通过。
  • 依赖升级后 CI 报类型错误或 lint 违规,需要在 PR 分支上补齐声明并修正代码。
  • 配置文件写错导致测试部署失败,需要在原分支上做最小修改并留下可审查的提交记录。
  • 流水线偶发失败与真实代码缺陷混杂,需要区分问题并针对真实缺陷推送针对性修复。

适合人员

  • 维护开源仓库的独立开发者:PR 常因 CI 失败滞留,需要快速定位并修复,而不是手动逐行翻日志。
  • 负责后端服务迭代的工程师:每次提交都要过 CI,遇到 lint 或类型错误时希望直接在 PR 分支上修复。
  • 兼任 reviewer 的技术负责人:合并前需要看到针对失败的最小修复提交,确认改动范围可控。
  • 搭建自动化流水线的 DevOps:希望把机械性修复接进 CI 流程,同时保留人工审查环节。