ombulabs/claude-code_rails-upgrade-skill

🤖 The one and only Claude Code Skill to Upgrade Rails by FastRuby.io -- Based on 60,000 dev/hours of experience upgrading Rails from 2.3 all the way to 8.1. Dual boot your Rails application and gradually upgrade one minor version at a time. 🚀

解决的问题

本项目为 Claude Code 提供一个专用技能，可自动化分析和规划 Ruby on Rails 应用程序的升级（从版本 2.3 到 8.1）。该技能通过强制执行逐版本、顺序升级策略，并提供针对代码库的定制化迁移指南，消除了升级旧版 Rails 应用程序时的猜测和风险。

如何工作

该技能分析用户实际的代码库，生成全面的升级报告和配置变更预览（通过 app:update）。它实现了 FastRuby.io 升级方法论，采用“双启动”策略——使用 next_rails gem 同时运行两个 Rails 版本，以在最终版本升级前测试和部署向后兼容的变更。

该技能与另外三个配套技能协同工作：rails-load-defaults、dual-boot 和 upgrade-cleanup（在完成版本跳转后处理双启动结构的清理工作）。

适用人群

需要在最小化停机时间和风险的前提下升级框架版本的 Ruby on Rails 开发者和团队，尤其是维护旧版应用的人员。

主要亮点

  • 顺序升级路径：强制执行严格不可跳过的策略（例如：6.0 → 6.1 → 7.0），避免复合型错误。
  • 代码库专属报告：生成包含“旧代码 vs 新代码”示例的迁移指南，示例直接来自用户项目。
  • 双启动集成：支持并行运行两个 Rails 版本，实现更安全的过渡。
  • 弃用警告优先策略：鼓励在升级版本前，先修复当前版本中的所有弃用警告。
  • 自动清理：包含专用插件，在升级跳转完成后拆除双启动结构并移除旧版本代码。

相关