用途:分析 Rails 应用并生成升级报告,覆盖破坏性变更、弃用项与分步迁移指南,支持 Rails 2.3 到 8.1。采用 FastRuby.io 升级方法:逐版本增量升级、先评估、用 next_rails 双引导测试、要求测试覆盖(目标 80%+)、用 RailsBump 检查 gem 兼容性。
主要能力:按版本的模式文件直接检测破坏性变更;生成综合升级报告(含用户实际文件中的旧/新代码对比、自定义代码警告、迁移计划、测试清单与回滚方案)和 app:update 预览(新旧配置对比、新文件列表、按 HIGH/MEDIUM/LOW 的文件影响评估);生成升级报告与配置预览模板;检查 gem 与目标 Rails 版本的兼容性,分必需升级、阻塞、已兼容三类,阻塞时提供 fork/vendor/替换方案。
使用方式:触发词包括“把 Rails 应用升级到某版本”“从 Rails x 升级到 y”“有哪些破坏性变更”“生成升级报告”等。流程为:先核对最新补丁版本(EOL 系列查静态表,活跃系列查 RubyGems API),未在最新补丁需先升级并部署;随后跑测试套件,有失败必须停止;再通过 dual-boot skill 用 next_rails 配置双引导;校验升级路径;直接检测破坏性变更;检查 gem 兼容性;生成两份报告;修复变更时双引导代码必须用 next_rails 的 NextRails.next?,不得用 respond_to? 等特性检测;更新 Gemfile、双版本跑测试、核对 CI 配置;最后交由 rails-load-defaults skill 按风险分层对齐 load_defaults。清理双引导为可选,需用户明确要求,不会自动运行。
限制:不允许跳版本,如 5.2→6.1、6.0→7.0、7.0→8.0 均非法,多跳需拆成单跳并各自出报告;依赖 dual-boot skill(github.com/ombulabs/claude-code_dual-boot-skill)与 rails-load-defaults skill(github.com/ombulabs/claude-code_rails-load-defaults-skill);本跳内不处理下一版本打印的弃用项;具体收费、平台与效果未在资料中提供。