这个痛你懂吗
PR提上去,CI红了,打开一堆日志,密密麻麻几千行,眼睛都花了还找不到哪里出了问题。这种感觉真的很崩溃。analyze-ci就是专门来解决这个问题的——它直接调用Claude分析GitHub Action失败日志,给你一份精准的根因报告,不用你自己翻日志。
核心功能
analyze-ci的核心逻辑很简单:你把PR链接或者具体的Job链接丢给它,它自动拉取失败日志,交给Claude做分析,最后输出一份结构清晰的失败摘要。
- 根因定位:不只是告诉你”失败了”,而是直接指出是哪一步、哪个测试、哪条错误信息导致的。
- 支持PR级别分析:一条命令分析一个PR下所有失败的Job,不用一个个点开。
- 支持单Job分析:如果你只想看某个特定Job,直接传Job URL就行。
- Debug模式:加上
--debug参数可以看到token消耗和费用,方便控制成本。 - GitHub Token自动检测:优先读取
gh auth token,也支持手动设置GH_TOKEN环境变量,接入成本极低。
适用平台
analyze-ci作为一个Skill,天然适配主流AI编程助手。无论你在用Cursor、GitHub Copilot、Claude Code,还是OpenAI Codex、Gemini Code Assist、文心快码、腾讯云CodeBuddy、华为云CodeArts,都可以把analyze-ci挂进去,让AI在帮你写代码的同时,顺手把CI失败的原因也分析清楚。它相当于给这些IDE装了一个”CI侦探”外挂,大幅提升AI对当前构建上下文的理解能力。
实操代码示例
用法非常直接,三种场景覆盖日常90%的需求:
# 分析某个PR下所有失败的Job
uv run skills analyze-ci https://github.com/mlflow/mlflow/pull/19601
# 只分析某个具体的Job
uv run skills analyze-ci https://github.com/mlflow/mlflow/actions/runs/12345/job/67890
# 开启debug模式,查看token和费用
uv run skills analyze-ci https://github.com/mlflow/mlflow/pull/19601 --debug
输出结果包含:失败摘要、根本原因、具体错误信息、失败的测试名称,以及最关键的日志片段。不是把日志原文甩给你,而是真正做了提炼。
优势分析
市面上也有一些CI分析工具,但大多数要么只是做日志搜索,要么需要复杂的配置才能跑起来。analyze-ci的优势在于:
- 零配置启动:只要本地装了
gh并且登录过,直接跑,不需要额外配置。 - AI级别的语义理解:背后是Claude在做分析,不是简单的关键词匹配,能理解测试框架的错误模式、依赖冲突、环境问题等复杂场景。
- 输出结构化:给出的是可读的摘要,不是原始日志的堆砌,直接可以贴到PR评论里。
- 成本透明:debug模式让你清楚知道每次分析花了多少token,不会有黑盒消费。
应用场景
几个真实会用到的场景:
- Code Review加速:Reviewer看到CI红了,不用自己去翻日志,直接跑一下analyze-ci,30秒拿到根因,判断是代码问题还是环境抖动。
- 新人上手:刚加入团队的同学对CI流程不熟,遇到失败不知道从哪看,analyze-ci直接给出定位,降低上手门槛。
- Flaky Test排查:某些测试时好时坏,用analyze-ci批量分析多次失败记录,更容易发现规律。
- 自动化流水线集成:在CI失败后自动触发analyze-ci,把分析结果写回PR评论,实现全自动的失败通知。
最佳实践
几个用起来更顺手的小建议:
- 先跑PR级别分析:大多数情况下直接传PR URL就够了,analyze-ci会自动找出所有失败的Job,不需要手动一个个找Job链接。
- GH_TOKEN权限要够:确保Token有
repo和actions:read权限,否则拉不到私有仓库的日志。 - debug模式用于成本评估:在团队推广前先用
--debug跑几个典型PR,评估一下平均token消耗,方便做预算规划。 - 结合CI通知机制:可以在GitHub Actions的
on: workflow_run事件里触发analyze-ci,失败后自动分析并评论到PR,形成闭环。 - 日志过大时拆分Job分析:如果某个PR的Job特别多,可以先用PR级别分析定位到具体哪个Job有问题,再单独传Job URL做深度分析,避免一次性消耗过多token。
如果你的团队在用多个类似的Skill来提升开发效率,管理和分发这些Skill本身也会变成一个问题。Skill优仓提供了一个统一的Skill仓库,团队成员可以直接搜索、下载、复用经过验证的Skill,不用每个人都从零开始配置。analyze-ci这类CI分析Skill在Skill优仓上也有收录,感兴趣可以去看看。








暂无评论内容