리팩토링 가이드
코딩고급
지정된 코드를 분석하여 중복 코드, 긴 함수, 복잡한 조건문 등 코드 스멜을 감지합니다. 각 이슈에 대해 단계별 리팩토링 방법과 예상 개선 효과를 제시합니다.
트리거
/refactor [file]사용빈도필요 시
레거시 코드를 넘겨받았는데 어디부터 손대야 할지 모를 때라면? /refactor로 우선순위 + 단계별 계획 확보
리팩토링코드 품질설계
작동 흐름
/refactor [파일] 실행
↓
Phase 1: 4개 측정 병렬
length-check
함수 길이 측정
complexity
순환 복잡도 분석
dup-detect
코드 중복 감지
nesting-check
중첩 깊이 체크
↓
건강 점수 산정 → 개선 계획 수립
↓
✓ 건강 점수 X/10 + 단계별 리팩토링 계획
스킬 코드
# Refactor Guide Skill
## Trigger: /refactor [file]
When invoked:
1. Analyze code quality:
- Function length (flag > 30 lines)
- Cyclomatic complexity
- Duplicate code blocks
- Deep nesting (> 3 levels)
- Parameter count (flag > 4)
2. Identify patterns:
- Extract Method opportunities
- Replace Conditional with Polymorphism
- Introduce Parameter Object
- Move Method / Extract Class
3. Output format:
---
## ♻️ Refactoring Report
### Code Health Score: [X/10]
### Issues Found
1. **[Issue Type]** at line [N]
- Problem: [description]
- Suggestion: [refactoring technique]
- Impact: [readability / performance / maintainability]
### Refactoring Plan
Step 1: [action] — [why]
Step 2: [action] — [why]
### Before / After Preview
[code comparison]
---
복사해서 CLAUDE.md에 붙여넣으면 바로 사용할 수 있습니다.
리팩토링 가이드 작동 방식
Refactor Guide는 대상 파일의 코드 스멜(긴 함수, 깊은 중첩, 중복 로직, God 객체 등)을 스캔하고, 각 변경의 비포/애프터 예시와 리스크 평가를 포함한 단계별 리팩토링 계획을 생성합니다.
리팩토링 가이드이(가) 빛나는 순간
테스트가 없는 레거시 코드베이스에서 기존 동작을 깨뜨리지 않고 구조를 개선해야 할 때 최적입니다. 각 리팩토링 단계가 안전하고 되돌릴 수 있어야 하는 상황에서 효과적입니다.
핵심 특장점
- 여러 코드 스멜 카테고리를 자동 감지
- 안전하고 점진적인 리팩토링 단계를 생성
- 각 제안 변경에 대한 리스크 평가 포함
- 명확성을 위한 비포/애프터 예시 제공