Rails Upgrade

Wykrywa zmiany powodujące niezgodność w Rails i generuje raporty aktualizacji dla wersji Rails 2.3-8.1

Autor: ombulabs · ombulabs/claude-code_rails-upgrade-skill

Testowano · Działa ★ 8.8/10

Rails Upgrade — Wykrywa zmiany powodujące niezgodność w Rails i generuje raporty aktualizacji dla wersji Rails 2.3-8.1

Co robi ten skill

Analizuje bazę kodu Rails pod kątem plików wzorców grep specyficznych dla wersji, aby znaleźć zmiany powodujące niezgodność, deprecjacje i elementy migracji, a następnie kompiluje je w pogrupowany raport aktualizacji z poprawkami dla każdego znalezionego problemu dla każdego sekwencyjnego przeskoku z Rails 2.3 do 8.1. Wyzwala się, gdy użytkownik prosi o aktualizację aplikacji Rails, planuje aktualizację wieloetapową lub pyta o zmiany powodujące niezgodność w konkretnej wersji Rails. Wymusza sekwencyjne (bez pomijania) aktualizacje i deleguje pracę związaną z dual-boot i load_defaults do umiejętności towarzyszących.

Raport z testu

Zlokalizowałem SKILL.md w rails-upgrade/SKILL.md (repozytorium ma dwie umiejętności; slug pasuje do tego katalogu). Frontmatter parsował z name+description; sprawdziłem 3 pliki referencyjne (direct-detection-workflow.md, rails-70-patterns.yml, upgrade-report-template.md), wszystkie HTTP 200; brak zagrożeń bezpieczeństwa. Do testu wyjścia zbudowałem aplikację Rails 6.1 (Gemfile z webpacker/spring/turbolinks/ruby 2.6.5, widok form_with local:true, Rails.application.secrets w kontrolerze, model enum) i wykonałem workflow bezpośredniego wykrywania umiejętności, przeszukując każdy wzorzec w rails-70-patterns.yml: wszystkie 7 wzorców pasowało z dokładnym plikiem:linią. Linia bazowa (moja własna wiedza o Rails, bez umiejętności) wykryła główne kategorie, ale nie podała żadnego zakotwiczenia pliku i pominęła znaleziska secrets.yml i enum, które umiejętność ujawniła z liniami i niuansami zgodnymi z wersją (np. secrets działa w 7.0, ale jest przestarzałe w 7.1).

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

Instalacja

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.

Komendy i przykładowe prompty

/rails-upgradeWykrywa zmiany powodujące niezgodność w Rails i generuje raporty aktualizacji dla wersji Rails 2.3-8.1

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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

Pełny raport →