用途
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加入每次推送。 - 其他具体限制、收费或平台信息暂未提供。