next-upgrade은(는) 무엇을 하나요?
공식 마이그레이션 가이드와 codemod를 따라 Next.js를 최신 버전으로 업그레이드합니다.
개요
이 스킬은 Next.js 프로젝트를 최신 버전으로 업그레이드하는 과정을 자동화합니다. 공식 Next.js 마이그레이션 가이드와 함께 제공되는 codemod를 사용하여 호환성 문제를 해결하고 업그레이드 과정을 간소화합니다.
주요 기능
- Next.js 최신 버전 확인 및 권장 업그레이드 경로 제안
- 공식 codemod 자동 실행 (
@next/codemodCLI) - 주요 버전 간 마이그레이션 가이드 참조 (12→13, 13→14, 14→15 등)
- 종속성 업데이트 및 충돌 해결 지원
사용 방법
- 프로젝트 루트 디렉토리에서 스킬을 활성화합니다.
- 다음 명령어를 실행하여 업그레이드를 시작합니다:
npx @next/codemod@latest upgrade latest
또는 특정 버전으로 업그레이드하려면:
npx @next/codemod@latest upgrade <target-version>
지원 플랫폼
- Claude Code
- Cursor
- Codex
- 기타 AI 코딩 에이전트
참고 사항
- 업그레이드 전에 프로젝트를 백업하는 것이 좋습니다.
- codemod가 모든 변경 사항을 자동으로 적용하지 못할 수 있으므로 수동 확인이 필요할 수 있습니다.
- 일부 마이그레이션 단계는 codemod로 완전히 자동화되지 않으며, 공식 가이드를 참조해야 합니다.