Rails Upgrade Assistant 是一个面向 Rails 应用升级的技能,目标是从 Rails 2.3 到 8.1 提供智能升级支持。它采用模块化结构,包含外部工作流和示例,升级策略为顺序升级,不允许跳过版本。方法论基于 FastRuby.io 的升级最佳实践和《The Complete Guide to Upgrade Rails》电子书。
主要能力包括:分析 Rails 应用并生成升级报告,涵盖破坏性变更、弃用警告和分步迁移指南;提供版本特定指南(如 3.2→4.0、4.2→5.0、5.2→6.0、6.1→7.0、7.2→8.0 等);支持双启动测试(依赖 dual-boot 技能和 next_rails gem);检查 gem 兼容性;生成 app:update 预览;同步 CI 配置;对齐 load_defaults(依赖 rails-load-defaults 技能)。
使用方式:按顺序执行工作流,从验证最新补丁、运行测试套件、解决弃用警告、验证升级路径、设置 next_rails、检测破坏性变更、检查 gem 兼容性、启动冒烟测试、生成升级报告、生成 app:update 预览、实施升级、同步 CI 配置、对齐 load_defaults 到清理。工作流文件位于 workflows/ 目录,参考材料位于 references/ 目录,检测脚本位于 detection-scripts/ 目录。
适用场景:需要升级 Rails 版本的应用,尤其是希望获得结构化升级报告和迁移指南的团队。限制:必须顺序升级,不能跳过版本;需要安装 dual-boot 和 rails-load-defaults 技能;需要足够的测试覆盖率(建议 80% 以上);部分工作流有门禁条件。具体收费、价格、平台等信息暂未提供。