auto-refactor

name	auto-refactor
description	자동 리팩토링 — 긴 함수 분리, 중복 제거, import 정리
user_invocable	true

/auto-refactor — 코드 리팩토링 도우미

코드 품질을 자동으로 개선합니다. 큰 변경은 사전 확인 후 적용.

사용법

/auto-refactor scan           → 리팩토링 후보 전체 스캔
/auto-refactor functions      → 100줄+ 함수만 추출
/auto-refactor duplicates     → 중복 코드 블록 감지
/auto-refactor imports        → unused import 제거 + 정렬
/auto-refactor file <path>    → 특정 파일 리팩토링

리팩토링 룰

1) 긴 함수 분리

• 100줄+ 함수 → 논리 단위로 sub-function 추출
• if-else 5단계+ → early return으로 평탄화
• 중첩 try-except 3단계+ → 컨텍스트 매니저 분리

2) 중복 코드 (DRY)

• 동일 5줄+ 블록 2회+ 발견 → 공통 함수 제안
• 채널별 분기 패턴 → _for_channel(ch) 패턴 통일
• 매직 넘버 → 상수 추출

3) Import 정리

• unused import 제거
• 표준 라이브러리 → 서드파티 → 로컬 순서 정렬
• from x import * 감지 + 경고

4) 타입 힌트 보강

• 함수 반환 타입 누락 → 추론하여 추가
• dict → dict[str, Any] 명시
• Optional 누락 → | None 추가

안전 가드

• dry-run 우선: 변경 미리보기 출력 후 확인 요청
• 백업: 큰 리팩토링은 git stash 후 적용
• 테스트 자동: 리팩토링 후 /auto-test changed 자동 실행

담당 파일

• modules/ 전체
• 우선 대상: cutter/generator.py, auto_deploy.py, api_server.py

예시 출력

[auto-refactor scan] 후보 발견:
🔴 cutter/generator.py:generate_cuts() — 484줄 (분리 권장)
🟡 auto_deploy.py:run_auto_deploy() — 187줄 (재검토)
🟡 topic_generator.py:중복 4건 (LLM 호출 패턴 통일 권장)
🟢 quality.py — 정상