SuperAPI AI 工具集

ci-fix

通用与其它

查看项目

更新于 10-15 22:34

技能介绍

用途:诊断并修复 GitHub Actions 的 CI 失败,以最小化、针对性的改动解决问题,并将修复推送到专用分支,不创建 PR。

主要能力:定位失败的 workflow run、提取失败步骤日志、分析常见失败原因(构建/编译错误、测试失败、lint/format 问题、环境问题等)、实施最小改动、推送修复分支并验证。

使用方式:先验证 GitHub CLI 认证:gh auth status;若未认证,需先运行 gh auth login。定位失败运行:gh pr view --json statusCheckRollup --jq '.statusCheckRollup[] | select(.conclusion == "FAILURE")',或 gh run list --branch <branch> --status failure --limit 5 与 gh run view <run-id> --verbose。提取日志:gh run view <run-id> --log-failed,也可用 --log --job <job-id> 或 gh run download <run-id> -D .artifacts/<run-id>。

实施与推送:做最小、范围明确的改动,匹配仓库现有风格,只修损坏部分;必要时保留工作流权限。创建或更新修复分支:git checkout -b ci-fix/<original-branch>、git add -A、git commit -m "fix: resolve CI failure in <job-name>"、git push -u origin ci-fix/<original-branch>。验证:gh run list --branch ci-fix/<original-branch> --limit 1、gh run watch <new-run-id> --exit-status,或 gh run rerun <run-id> --failed。

适用场景:基于 PR 分支、指定分支或 run ID 的 CI 失败修复流程。

限制与安全:避免使用 pull_request_target,除非明确要求;保持 workflow 权限最小化;对 flaky 测试优先确定性修复而非盲目重跑。完成后给出失败运行链接或 ID、根因、改动内容和验证结果。