ombulabs/claude-code_rails-upgrade-skill

해결하는 문제

이 프로젝트는 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 버전을 병렬로 실행할 수 있습니다.
• 비추천 경고 우선 접근법: 버전을 올리기 전에 현재 버전에서 발생하는 모든 비추천 경고를 해결하도록 권장합니다.
• 자동 정리: 업그레이드 이동이 완료된 후 듀얼부트 구조를 제거하고 오래된 버전 코드를 제거하는 전용 플러그인을 포함합니다.