프레임워크 업그레이드부터 언어 전환까지 대규모 코드베이스 마이그레이션을 계획, 추정 및 추적하기 위한 전략적 도구입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install codebase-migration-planner
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 codebase-migration-planner 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
Codebase Migration Planner란 무엇인가요?
Codebase Migration Planner는 주요 아키텍처 변화의 높은 복잡성을 처리하도록 설계된 Openclaw Skills 에코시스템 내의 전문 유틸리티입니다. 프로젝트를 JavaScript에서 TypeScript로 전환하든, 레거시 React 클래스 컴포넌트를 Hooks로 업그레이드하든, 모놀리스를 마이크로서비스로 분해하든, 이 스킬은 성공에 필요한 분석 프레임워크를 제공합니다.
자동화된 코드베이스 인벤토리 및 대상 분석을 활용하여 모호한 마이그레이션 목표를 구체적이고 단계적인 실행 계획으로 변환합니다. 팀이 관련된 총 코드 라인 수를 이해하도록 돕고, 기존 프레임워크를 감지하며, 낮은 테스트 커버리지 또는 호환되지 않는 API 패턴과 같은 특정 위험을 식별하여 마이그레이션 프로세스가 처음부터 끝까지 예측 가능하고 측정 가능하도록 보장합니다.
Codebase Migration Planner 활용 사례
- 레거시 프론트엔드를 React 클래스 컴포넌트에서 현대적인 함수형 hooks로 전환하는 계획 수립.
- 대규모 JavaScript 저장소 내에서 TypeScript의 점진적 도입 매핑.
- Express에서 Fastify 또는 Koa로 이동하는 것과 같이 프레임워크 간 백엔드 서비스 전환.
- Webpack 또는 Rollup에서 Vite로 마이그레이션하여 빌드 파이프라인 현대화.
- 도메인 주도 설계를 사용하여 모놀리식 애플리케이션을 마이크로서비스 아키텍처로 분해.
Codebase Migration Planner 작동 원리
- 사용자가 현재 언어 분포, 총 코드 라인 수 및 프레임워크 종속성을 인벤토리화하기 위해 평가를 시작합니다.
- 스킬이 마이그레이션 대상 분석을 수행하여 API 표면 차이 및 호환되지 않는 코드 패턴을 식별합니다.
- 준비, 기초, 핵심 라이브러리 및 기능 마이그레이션으로 작업을 분류하여 단계별 마이그레이션 계획이 생성됩니다.
- 수동 노력을 줄이기 위해 사용 가능한 codemods 및 자동화된 변환 도구를 식별합니다.
- 종속성 호환성을 확인하고 테스트 커버리지가 부족한 중요한 파일을 식별하여 위험을 평가합니다.
- 코드베이스 전체의 완료 백분율을 추적하는 동적 MIGRATION.md 파일을 통해 진행 상황을 관리합니다.
Codebase Migration Planner 설정 가이드
사용자 환경에서 이 특정 스킬을 사용하려면 Openclaw Skills 프레임워크가 구성되어 있는지 확인하세요. 프로젝트 루트에서 다음 명령을 실행하여 마이그레이션 평가를 초기화할 수 있습니다.
# Analyze the current codebase state
# This will inventory languages, lines of code, and dependencies
skill codebase-migration-planner assess
# Generate a phased migration roadmap
skill codebase-migration-planner plan --from javascript --to typescript
Codebase Migration Planner 데이터 스키마 및 분류 체계
이 스킬은 마이그레이션 가시성을 유지하기 위해 구조화된 데이터를 생성하고 관리합니다. 주요 데이터 출력은 다음과 같습니다.
| 구성 요소 | 형식 | 설명 |
|---|---|---|
| MIGRATION.md | Markdown | 파일별 진행 상황, 상태 및 남은 작업을 추적하는 팀용 문서. |
| Migration Plan | Markdown/JSON | 단계별 일정, 노력 추정치 및 위험 수준을 포함한 상세 로드맵. |
| Inventory Report | Text | 파일 유형, 코드 라인 수 및 감지된 프레임워크 버전의 분석. |
| Risk Matrix | Table | 복잡성이나 테스트 부족으로 인해 수동 확인이 필요한 종속성 및 파일의 매핑. |
Codebase Migration Planner 고급 기능
- 파일 복잡성과 테스트 커버리지를 기반으로 공수를 계산하는 휴리스틱 기반 노력 추정.
- React, Vue 및 TypeScript 마이그레이션을 위한 커뮤니티 표준 codemods 자동 검색.
- 기존 CI/CD 파이프라인을 중단하지 않고 점진적 마이그레이션을 허용하는 듀얼 스택 구성 계획 지원.
- 이해관계자용 Markdown 테이블 및 다른 Openclaw Skills에 통합하기 위한 기계 판독 가능 JSON을 포함한 다중 형식 출력 지원.
SKILL.md
로드 중
관련 Openclaw 스킬
API Changelog Generator
OpenAPI 사양을 비교하고 소비자용 변경 로그 및 마이그레이션 가이드를 생성하는 강력한 유틸리티입니다.
Ollama Task Orchestrator
SSH를 통해 Ollama 작업 대기열 및 자동화된 코드 생성을 관리하기 위한 원격 실행 엔진입니다.
Dockerignore Linter
.dockerignore 파일의 구문 오류, 보안 누출 및 빌드 컨텍스트 비대화를 검증하기 위해 설계된 포괄적인 감사 도구입니다.
EditorConfig Linter
.editorconfig 구문을 검증하고 소스 파일의 스타일 위반 사항을 자동으로 수정하는 강력한 유틸리티입니다.
Pre-Commit Config Validator
구조, hook 및 모범 사례 전반에 걸쳐 23가지 고유한 규칙을 적용하는 .pre-commit-config.yaml 파일 전용 유효성 검사 도구입니다.
ArgoCD Deployment Analyzer
ArgoCD로 관리되는 애플리케이션의 동기화 드리프트를 식별하고, 배포 실패를 진단하며, 보안을 감사하기 위한 종합적인 진단 도구입니다.
DevContainer Validator
구조적 오류, 보안 위험 및 구성 모범 사례를 확인하는 devcontainer.json 파일용 Python 기반 CLI 검증기입니다.
Release Readiness Checker
소프트웨어를 출시하기 전에 코드 품질, 버전 관리, 보안 및 문서를 검증하는 포괄적인 출시 전 감사 도구입니다.
추천*
