typo3-extension-upgrade-skill은(는) 무엇을 하나요?
TYPO3 확장 프로그램을 최신 LTS 버전으로 체계적으로 업그레이드하기 위한 에이전트 스킬 (Claude Code 호환)
개요
이 스킬은 Claude Code와 같은 AI 코딩 어시스턴트가 TYPO3 확장 프로그램을 오래된 LTS(Long Term Support) 버전에서 더 최신 LTS 버전으로 마이그레이션할 수 있도록 설계되었습니다.
지원되는 버전
- TYPO3 6.2 LTS → 7.6 LTS
- TYPO3 7.6 LTS → 8.7 LTS
- TYPO3 8.7 LTS → 9.5 LTS
- TYPO3 9.5 LTS → 10.4 LTS
- TYPO3 10.4 LTS → 11.5 LTS
- TYPO3 11.5 LTS → 12.4 LTS
- TYPO3 12.4 LTS → 13.4 LTS (준비 중)
주요 기능
- 의존성 분석: 확장 프로그램의
composer.json및ext_emconf.php파일을 스캔하여 현재 의존성과 대상 버전과의 호환성을 확인합니다. - 변경 로그 검토: 각 업그레이드 단계에 대한 TYPO3 ChangeLog 및 Breaking Changes 문서를 자동으로 검색하여 중요한 변경 사항을 식별합니다.
- API 변경 사항 식별: 대상 TYPO3 버전에서 제거되거나 변경된 API 호출, 클래스, 메서드를 감지합니다.
- 업그레이드 스크립트 실행: 필요한 데이터베이스 스키마 변경 및 파일 구조 변경을 자동으로 적용합니다.
- 코드 리팩토링: TYPO3의 새로운 API와 코딩 표준에 맞게 확장 프로그램 코드를 자동으로 업데이트합니다.
사용 방법
Claude Code에서 이 스킬을 활성화하려면 다음과 같이 요청하세요:
/claude:skill netresearch/typo3-extension-upgrade-skill
그런 다음 업그레이드하려는 확장 프로그램의 경로와 대상 TYPO3 버전을 지정하세요:
이 확장 프로그램을 TYPO3 9.5 LTS에서 10.4 LTS로 업그레이드해 주세요.
경로: /var/www/html/typo3conf/ext/my_extension
워크플로우
- 사전 점검: 현재 TYPO3 및 확장 프로그램 버전 확인
- 업그레이드 계획 수립: 필요한 모든 단계와 예상되는 변경 사항 목록 생성
- 백업 생성: 중요한 파일 및 데이터베이스 백업 권장
- 업그레이드 실행: 자동화된 스크립트를 통한 실제 업그레이드 수행
- 검증: 업그레이드 후 확장 프로그램의 기본 기능 테스트
- 문서화: 모든 변경 사항과 발견된 문제 기록
환경 변수
| 변수명 | 설명 | 필수 여부 |
|---|---|---|
TYPO3_PATH_ROOT | TYPO3 설치 루트 경로 | 예 |
TYPO3_VERSION_TARGET | 대상 TYPO3 LTS 버전 | 예 |
BACKUP_DIR | 백업 파일을 저장할 디렉터리 (선택 사항) | 아니요 |
참고 사항
- 이 스킬은 공식 TYPO3 업그레이드 가이드와 호환됩니다.
- 모든 업그레이드는 개발 환경에서 먼저 테스트하는 것이 좋습니다.
- 복잡한 사용자 정의 확장 프로그램의 경우 수동 개입이 필요할 수 있습니다.
라이선스
MIT