核心用法
Rails CI Fixer 是一个专为 Rails 项目设计的自动化 CI 修复代理，采用分层升级策略处理失败的持续集成流程。当 PR 出现 CI 失败时，系统会自动执行以下流程：
1. 日志采集：通过 GitHub CLI 拉取失败的 CI 日志，智能过滤构建错误、测试失败、依赖问题等多类故障信号
2. 分层修复尝试：
3. 本地验证：每次修复后执行 RSpec 单测验证和 RuboCop 自动格式化
4. 安全推送：仅向 feature 分支推送，永不触及 main 或受保护分支
- Attempt 1-2：使用轻量级模型（如 Claude Haiku、GPT-4o-mini）快速尝试修复
- Attempt 3：启动调试子代理注入诊断代码，升级至强模型（Claude Sonnet/Opus、GPT-4o）深度分析
- Attempt 4：人工介入，提供完整故障报告
显著优点
- 成本优化：优先使用廉价模型处理简单问题，仅在复杂场景升级至高成本模型
- Rails 原生适配：内置对 Bundler、RSpec、RuboCop、数据库迁移、Factory Bot 等 Rails 生态的深度支持
- 安全边界清晰：严格遵守"永不合并、永不强制推送、永不注释测试"三原则
- 不可信输入处理：将 CI 日志视为潜在攻击向量，拒绝执行嵌入日志的指令
潜在缺点与局限性
- 环境依赖较重：要求预装
gh、git、bundle、rspec、rubocop等全套工具链 - 令牌权限风险：需要
reposcope 的 GitHub Token，若泄露可导致代码仓库被篡改 - 调试子代理的复杂性：Attempt 3 中动态注入诊断代码可能引入副作用
- 非 Rails 项目不适用：工具链和修复模式深度绑定 Rails 生态
- 日志过滤规则可能遗漏：基于 grep 的日志过滤可能错过新型失败模式
适合人群
- 维护中型至大型 Rails 代码库的全栈开发团队
- 拥有频繁 PR 且 CI 负载较重的开源 Rails 项目
- 已将 AI 编码代理纳入工作流的技术先进型组织
- 需要减少 CI 失败人工干预时间的DevOps 工程师
常规风险
| 风险类别 | 具体描述 |
|---------|---------|
| 供应链攻击 | CI 日志可能被注入提示注入攻击（prompt injection），试图操控 AI 代理执行恶意操作 |
| 凭证泄露 | `GH_TOKEN` 若泄露，攻击者可推送代码至仓库（尽管受限于 feature 分支策略） |
| 代码质量退化 | 自动化修复可能为通过 CI 而采用权宜之计，长期积累技术债务 |
| 调试代码残留 | Attempt 3 的 `pp`/`raise inspect` 若未完全清理可能进入生产代码 |
| 分支策略绕过 | 配置错误或工具漏洞可能导致意外推送至受保护分支 |