cifail

cifail是一个命令行工具，专门从GitHub Actions运行日志中提取失败步骤的摘录内容。它专为AI编码代理设计，帮助开发者和AI助手快速定位CI/CD流程中的错误信息。该工具由Go语言开发，能够自动复用GitHub CLI（gh）的已有认证，无需额外配置即可访问私有仓库的Actions日志。对于需要自动化处理GitHub Actions故障的场景，cifail提供了高效、精准的错误信息提取能力。

功能特点

1. 专注于提取GitHub Actions运行中的失败步骤片段
2. 提供有边界的摘录内容，避免输出过多无关日志
3. 自动复用GitHub CLI（gh）的认证信息，无需额外登录
4. 支持私有仓库和公开仓库的Actions日志访问
5. 轻量级命令行工具，安装简单、运行高效
6. 专为AI编码代理优化输出格式，便于LLM理解和处理

优缺点

优点：

• 零配置，开箱即用，依赖已有的gh认证
• 输出精简，只保留关键失败信息，减少token消耗
• 开源项目，代码透明，可自由定制
• Go语言编写，性能优异，跨平台支持

缺点：

• 需要本地安装GitHub CLI并完成认证
• 仅支持GitHub Actions，不支持其他CI平台
• 功能单一，不提供日志分析或可视化功能
• 需要手动指定仓库和工作流名称

主要应用场景

1. AI编程助手辅助开发者诊断CI/CD构建失败原因
2. 自动化工作流中集成错误日志提取功能
3. 开发团队快速获取Actions失败信息并分享给同事
4. CI问题排查的脚本化、批量化处理

使用方法

1. 确保已安装GitHub CLI（gh）并完成gh auth login认证
2. 安装cifail工具（通过go install或下载二进制文件）
3. 运行命令指定目标仓库和运行ID：cifail -repo owner/repo -run-id 123456789
4. 工具将输出失败步骤的摘录内容

收费标准

cifail是开源免费项目，采用MIT许可证。用户可自由使用、修改和分发。该项目托管于GitHub，源码完全开放。