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 版本，實現更安全的過渡。
  • 棄用警告優先策略：鼓勵在升級版本前，先修復當前版本中的所有棄用警告。
  • 自動清理：包含專用外掛，在升級跳躍完成後拆除雙啟動架構並移除舊版本程式碼。

相關