Rails Upgrade

Rileva modifiche che rompono la compatibilità di Rails e genera report di upgrade per Rails 2.3-8.1

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

Promosso ★ 8.8/10

Rails Upgrade — Rileva modifiche che rompono la compatibilità di Rails e genera report di upgrade per Rails 2.3-8.1

Cosa fa

Analizza una codebase Rails rispetto a file di pattern grep specifici per versione per trovare modifiche che rompono la compatibilità, deprecazioni e elementi di migrazione, quindi li compila in un report di upgrade categorizzato con correzioni per ogni risultato per qualsiasi salto sequenziale da Rails 2.3 a 8.1. Si attiva quando l'utente chiede di aggiornare un'app Rails, pianificare un upgrade multi-hop o interrogare modifiche che rompono la compatibilità in una specifica versione di Rails. Applica upgrade sequenziali (senza salti) e delega il lavoro di dual-boot e load_defaults a skill complementari.

Rapporto di test

Ho localizzato SKILL.md in rails-upgrade/SKILL.md (il repository ha due skill; lo slug corrisponde a questa directory). Il frontmatter si analizza con name+description; ho controllato a campione 3 file di riferimento nel corpo (direct-detection-workflow.md, rails-70-patterns.yml, upgrade-report-template.md), tutti HTTP 200; nessun problema di sicurezza. Per l'output ho costruito un'applicazione Rails 6.1 fittizia (Gemfile con webpacker/spring/turbolinks/ruby 2.6.5, una vista form_with local:true, Rails.application.secrets in un controller, un modello enum) e ho eseguito il workflow di rilevamento diretto della skill cercando ogni pattern in rails-70-patterns.yml: tutti e 7 i pattern corrispondevano con file:line esatti. La base (la mia conoscenza di Rails, senza skill) ha catturato le categorie principali ma non ha fornito alcun ancoraggio di file e ha omesso i risultati secrets.yml e enum che la skill ha evidenziato con linee e sfumature accurate per versione (es. secrets funziona con 7.0 ma è deprecato con 7.1).

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

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.

Comandi e prompt di esempio

/rails-upgradeRileva modifiche che rompono la compatibilità di Rails e genera report di upgrade per Rails 2.3-8.1

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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

Rapporto completo →