codebase-cleanup-refactor-clean
코드를 깔끔하고 SOLID 아키텍처로 리팩토링
기술 부채, 중복 코드, 유지보수가 어려운 시스템으로 고민 중이신가요? 이 스킬은 검증된 리팩토링 패턴과 SOLID 원칙을 적용하여 지저분한 코드베이스를 깔끔하고 모듈화되며 테스트 가능한 아키텍처로 변환합니다.
스킬 ZIP 다운로드
Claude에서 업로드
설정 → 기능 → 스킬 → 스킬 업로드로 이동
토글을 켜고 사용 시작
테스트해 보기
"codebase-cleanup-refactor-clean" 사용 중입니다. 검증, 결제, 배송, 이메일 알림을 하나의 메서드에서 모두 처리하는 200 줄의 OrderProcessor 클래스를 리팩토링하세요.
예상 결과:
OrderValidator, PaymentService, ShippingCalculator, EmailNotificationService, OrderOrchestrator 등 5 개의 집중된 클래스로 분리했습니다. 메서드당 복잡도를 45 에서 8 로 감소시켰습니다. 92% 커버리지의 18 개 단위 테스트를 추가했습니다.
"codebase-cleanup-refactor-clean" 사용 중입니다. 코드베이스에 30% 의 중복이 있으며, 특히 서비스 간 에러 핸들링과 데이터베이스 쿼리에서 심합니다.
예상 결과:
6 개의 사용자 정의 예외 타입과 함께 공통 에러 핸들링을 BaseExceptionHandler 로 추출했습니다. CRUD 연산을 가진 GenericRepository 를 생성했습니다. 기능을 유지하면서 중복의 28% 를 제거하고 코드베이스를 1,400 줄 줄였습니다.
보안 감사
안전All 89 static analysis findings are false positives. The skill contains only markdown documentation with code examples for educational purposes. Detected patterns (backticks, file operations, network references) are part of fenced code blocks demonstrating refactoring concepts in Python, TypeScript, Go, and Java. No executable code, prompt injection attempts, or malicious patterns found. Safe for publication.
품질 점수
만들 수 있는 것
레거시 모놀리스 현대화
500 줄의 모놀리식 함수를 검증, 비즈니스 로직, 데이터 접근을 위한 관심사 분리가 된 깔끔하고 모듈화된 아키텍처로 변환합니다.
기술 부채 정리 스프린트
코드 중복을 체계적으로 제거하고, 매직 넘버를 상수로 추출하며, 고위험 및 자주 수정되는 모듈에 SOLID 원칙을 적용합니다.
기능 추가 전 아키텍처 리뷰
주요 기능 작업 전 코드베이스 품질을 평가하여 구현 위험을 줄이고 확장성을 개선할 수 있는 리팩토링 기회를 식별합니다.
이 프롬프트를 사용해 보세요
코드베이스에서 코드 스멜과 빠른 개선점을 리뷰하세요. 매직 넘버를 식별하고, 변수명을 개선하며, 사용하지 않는 코드를 제거하고, 중복 코드를 재사용 가능한 함수로 추출하세요.
이 코드를 SOLID 위반에 대해 분석하세요. 단일 책임, 개방/폐쇄, 리스코프 치환, 인터페이스 분리, 의존성 역전 원칙을 따르도록 리팩토링하세요. before/after 비교를 보여주세요.
이 모놀리식 시스템을 도메인 엔티티, 리포지토리, 서비스, 검증자로 구성된 깔끔한 레이어로 분해하세요. 의존성 주입을 적용하고 관심사를 완전히 분리하세요. 종합 테스트를 생성하세요.
전체 코드베이스를 감사하여 비즈니스 영향도와 위험도를 기준으로 기술 부채의 우선순위를 지정하세요. 노력 추정치, ROI 분석, 권장 스프린트 일정을 포함한 리팩토링 로드맵을 제공하세요.
모범 사례
- 컨텍스트와 비즈니스 로직을 이해하기 위해 변경을 제안하기 전에 항상 기존 코드를 읽으세요
- 매직 넘버 추출과 이름 개선과 같은 영향도가 높고 노력이 적은 리팩토링부터 시작하세요
- 동작 보존을 보장하기 위해 리팩토링 전에 종합 테스트를 생성하세요
- 대규모 리팩토링을 독립적으로 테스트할 수 있는 작고 리뷰 가능한 커밋으로 분할하세요
피하기
- 기존 요구사항을 이해하지 않고 모듈 전체를 처음부터 다시 작성하지 마세요
- 디자인 패턴을 모든 곳에 적용하지 마세요 - 실제 문제를 해결할 때만 사용하세요
- 테스트나 기능 동등성을 검증할 메커니즘이 없으면 리팩토링하지 마세요
- 단일 리팩토링 반복에서 여러 개의 관련 없는 관심사를 동시에 변경하지 마세요