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を使用して2つのRailsバージョンを同時に実行する「デュアルブート」戦略を採用しています。これにより、最終的なバージョンアップの前に、後方互換性のある変更をテスト・デプロイできます。

このスキルは、rails-load-defaultsdual-bootupgrade-cleanup(バージョンアップが完了した後にデュアルブートの基盤を削除する)の3つの補助スキルと連携して動作します。

対象ユーザー

レガシーなアプリケーションを維持しているRuby on Rails開発者やチームで、ダウンタイムやリスクを最小限に抑えながらフレームワークのバージョンをアップグレードしたい方。

特徴

  • 順次アップグレードパス: スキップ不可の厳格なポリシー(例:6.0 → 6.1 → 7.0)を採用し、複合的なバグを回避します。
  • コードベース固有のレポート: ユーザーのプロジェクトから直接抽出された「旧コード vs 新コード」の例を含む移行ガイドを生成します。
  • デュアルブート統合: より安全な移行のため、2つのRailsバージョンを並行して実行できます。
  • 非推奨警告優先アプローチ: バージョンを上げる前に、現在のバージョンでのすべての非推奨警告を修正することを推奨します。
  • 自動クリーンアップ: アップグレードの移行が完了した後、デュアルブートの基盤を削除し、古いバージョンのコードを廃止する専用プラグインを含んでいます。

関連