Rails Upgrade

Erkennt Rails Breaking Changes und generiert Versionssprung-Upgrade-Berichte für Rails 2.3-8.1

von ombulabs · ombulabs/claude-code_rails-upgrade-skill

Getestet · Funktioniert ★ 8.8/10

Rails Upgrade — Erkennt Rails Breaking Changes und generiert Versionssprung-Upgrade-Berichte für Rails 2.3-8.1

Was es kann

Analysiert eine Rails-Codebasis anhand versionsspezifischer grep-Musterdateien, um Breaking Changes, Deprecations und Migrationselemente zu finden, und kompiliert diese dann in einen kategorisierten Upgrade-Bericht mit pro-Ergebnis-Fixes für jeden sequenziellen Sprung von Rails 2.3 bis 8.1. Wird ausgelöst, wenn der Benutzer eine Rails-App aktualisieren, ein Multi-Hop-Upgrade planen oder Breaking Changes in einer bestimmten Rails-Version abfragen möchte. Erzwingt sequenzielle (keine Überspringen) Upgrades und delegiert Dual-Boot- und load_defaults-Arbeiten an Begleit-Skills.

Testbericht

SKILL.md unter rails-upgrade/SKILL.md gefunden (Repo hat zwei Skills; Slug passt zu diesem Verzeichnis). Frontmatter wird mit name+description geparst; 3 im Body referenzierte Dateien (direct-detection-workflow.md, rails-70-patterns.yml, upgrade-report-template.md) stichprobenartig überprüft, alle HTTP 200; keine Sicherheitsmängel. Für die Ausgabe erstellte ich eine Rails 6.1-App (Gemfile mit webpacker/spring/turbolinks/ruby 2.6.5, eine form_with local:true View, Rails.application.secrets in einem Controller, ein Enum-Modell) und führte den direkten Erkennungs-Workflow des Skills aus, indem ich jedes Muster in rails-70-patterns.yml grepte: alle 7 Muster passten mit exakter Datei:Zeile. Die Basislinie (mein eigenes Rails-Wissen, kein Skill) erfasste die Hauptkategorien, lieferte aber keine Dateiverankerung und ließ die secrets.yml- und Enum-Ergebnisse aus, die der Skill mit Zeilen und versionsgenauer Nuance (z. B. secrets funktioniert bei 7.0, ist aber bei 7.1 veraltet) aufzeigte.

Getestet am: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

git clone --depth 1 https://github.com/ombulabs/claude-code_rails-upgrade-skill.git /tmp/rails-upgrade-src
mkdir -p ~/.claude/skills
cp -R /tmp/rails-upgrade-src/rails-upgrade ~/.claude/skills/rails-upgrade
# SKILL.md lands at ~/.claude/skills/rails-upgrade/SKILL.md
# Optional companion skills for the full end-to-end workflow (not needed for detection/report):
#   dual-boot skill        -> github.com/ombulabs/claude-code_dual-boot-skill (Step 2)
#   rails-load-defaults    -> github.com/ombulabs/claude-code_rails-load-defaults-skill (Step 7)
#   upgrade-cleanup plugin -> shipped in /tmp/rails-upgrade-src/upgrade-cleanup (Step 8)
# Full upgrade execution also needs the target Rails app checked out with a runnable test suite.

Befehle & Beispiel-Prompts

/rails-upgradeErkennt Rails Breaking Changes und generiert Versionssprung-Upgrade-Berichte für Rails 2.3-8.1

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

Plan our upgrade from Rails 6 to Rails 7
What breaks when we upgrade to Rails 7.1
Generate a migration guide for this Rails hop

Vollständiger Testbericht (Englisch) →