Rails CI Fixer

🔧 自动修复 Rails CI,智能分层永不越权

自动化修复 Rails PR 的 CI 失败,支持 RSpec、RuboCop、构建环境等问题,采用分层模型升级策略,失败时自动通知人工处理。

收藏
4.8k
安装
1k
版本
1.1.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Rails CI Fixer 是一个专为 Rails 项目设计的自动化 CI 修复技能,能够在无需人工干预的情况下处理 Pull Request 中的各类 CI 失败问题。该技能通过 GitHub CLI 拉取失败日志,识别问题类型(包括 RSpec 测试失败、RuboCop 代码风格违规、数据库迁移错误、工厂配置问题、种子数据异常以及构建环境故障如 yarn/npm/Tailwind 依赖问题),并采用分层模型策略进行修复。

工作流程:

1. 第 1-2 轮尝试:使用快速/低成本模型分析日志并修复

  • 拉取失败日志并过滤关键错误信息
  • 本地验证修复:bundle exec rspec + bundle exec rubocop -A
  • 代码风格修复单独提交
  • 推送至功能分支并监控 CI 状态

2. 第 3 轮尝试:启动调试子代理 + 升级至更强模型

  • 在失败点插入 pp/raise inspect 进行深度调试
  • 基于调试发现升级模型进行修复

3. 第 4 轮:停止并通知人工,提供完整失败报告与尝试记录

显著优点

  • 全自动化闭环:从日志拉取到修复验证再到推送监控,无需人工介入
  • 智能分层策略:优先使用低成本模型控制成本,复杂问题自动升级
  • 严格安全边界:禁止注释测试、禁止推送到主分支、禁止自动合并
  • 多故障类型覆盖:涵盖测试、代码风格、构建环境、前端资源等常见 Rails CI 问题

潜在缺点与局限性

  • 依赖外部工具链:需要完整的 gh、git、bundle、rubocop 环境配置
  • GH_TOKEN 权限要求:需要 repo 范围的 GitHub Token,存在潜在泄露风险
  • 日志解析的脆弱性:基于正则过滤日志可能遗漏非标准格式的错误
  • 模型能力天花板:复杂业务逻辑错误或架构级问题可能无法自动修复
  • 调试侵入性:第 3 轮的 pp/raise 插入会临时修改代码

适合人群

  • 维护活跃 Rails 项目的开发团队
  • 需要减少 CI 修复人工成本的工程组织
  • 拥有标准化 CI 流程和良好测试覆盖的成熟项目

常规风险

  • Token 泄露风险:GH_TOKEN 需要妥善保管,避免硬编码
  • 意外推送风险:虽禁止主分支推送,但仍需确认分支策略配置
  • 日志注入风险:CI 日志被视为不可信输入,技能明确禁止执行日志中的指令
  • 修复质量风险:自动修复可能引入语义正确但风格或设计不佳的代码
  • 成本累积风险:反复尝试可能导致 API 调用成本上升

Rails CI Fixer 内容

references文件夹
手动下载zip · 4.5 kB
common-failures.mdtext/markdown
请选择文件