SuperAPI AI 工具集

w-gha

部署与运维

查看项目

更新于 10-15 15:13

技能介绍

用途

w-gha 用于修复当前分支上失败的 GitHub Actions 工作流。它面向需要排查 CI 失败的开发者,帮助获取日志、定位失败原因,并在本地修复错误。

主要能力

  • 使用 gh 获取 GitHub Actions 日志,明确要求不使用 GitHub MCP 获取 Actions 日志。
  • 查看当前分支:git branch --show-current。
  • 解析上游跟踪分支并确认其存在;说明 git status -sb 并不能证明分支已推送。
  • 确认 HEAD 未领先于上游,或通过 gh pr view --json headRefOid 获取 PR head SHA,并在选择运行记录时使用该 SHA。
  • 检查 PR:gh pr checks。
  • 列出运行记录:gh run list --branch "$(git branch --show-current)" --limit 10(或 --commit <headSha>)。
  • 查看失败日志:gh run view <id> --log-failed。
  • 下载 artifacts:gh run download <id>。
  • 解析日志,识别测试、lint、构建、缺失依赖、环境、超时等问题。
  • 当 2 个及以上 job 失败时,为每个不同 job 派发一个只读解析器,由自身修改所属根因。

使用方式

按照技能描述执行以下流程:先确认当前分支与上游状态,再通过 gh 命令找到失败的运行记录和日志,解析日志定位问题,在本地复现并修复,最后运行与工作流相同的本地命令进行验证。技能说明中不建议把 gh run watch 添加到每次推送中;除非用户明确要求,否则不进行提交或推送。

若行为或命令发生变化,文档指向 /w-docs。

适用场景

  • 当前分支的 GitHub Actions 失败,需要获取失败日志并定位原因。
  • 需要区分多个失败 job 的各自成因,并逐一修复。
  • 需要在本地复现 CI 使用的命令以验证修复。

限制

  • 获取 Actions 日志应使用 gh,而非 GitHub MCP。
  • 不在用户未要求的情况下提交或推送代码。
  • 不将 gh run watch 加入每次推送。
  • 其他具体限制、收费或平台信息暂未提供。