Refactor (지능형 리팩터링 파이프라인)

무엇을 해주나

무작정 찾아 바꾸기(search & replace)식 리팩터링을 막고, 정해진 6단계 절차를 따르게 만드는 스킬입니다.

• PHASE 0 의도 게이트: "정리 좀 해줘"처럼 모호한 요청은 바로 실행하지 않고 목표·범위·성공 기준을 되묻습니다.
• PHASE 1~2 코드베이스 분석 & 코드맵: 탐색 에이전트를 병렬로 띄우고 LSP(정의 이동, 참조 찾기)와 ast-grep으로 대상·의존성·유사 패턴·테스트를 모두 매핑해 영향 범위 표를 만듭니다.
• PHASE 3 테스트 평가: 커버리지가 낮거나 없으면 공격적 리팩터링을 거부하고 테스트 먼저 작성할지 물어봅니다.
• PHASE 4~5 계획 & 실행: 원자적 단계로 쪼갠 계획을 만들고, 각 단계마다 진단(lsp_diagnostics) → 테스트 → 타입체크를 통과해야만 다음으로 넘어갑니다. 실패 시 즉시 되돌립니다.
• PHASE 6 최종 검증: 전체 테스트·타입체크·린트·빌드를 돌리고 변경 요약 리포트를 냅니다.
• 팀 모드: team_* 도구가 있는 환경에서는 quick 2명 + unspecified-low 2명 구성의 병렬 리팩터링 팀을 만들고, 검증자는 팀 밖에서 별도로 돌립니다.

이런 분께 추천

• 레거시 코드를 손대야 하는데 AI가 멋대로 범위를 넓히는 게 불안한 개발자
• 테스트 없는 코드에 대한 리팩터링을 시스템적으로 막고 싶은 팀 리드
• TypeScript/Python/Go 등 LSP·테스트 명령이 갖춰진 프로젝트를 운영하는 분
• oh-my-openagent(OMO) 환경을 이미 쓰고 있는 사용자 (일부 기능은 이 환경 전용)

활용 예시

1. /refactor src/auth/handler.ts --scope=file --strategy=safe — 단일 파일 안에서 검증 로직을 별도 함수로 추출하고, 매 단계 테스트를 돌려 회귀가 없는지 확인.
2. /refactor "AuthService 클래스를 인터페이스 기반으로 분리" --scope=module — 참조 찾기로 모든 소비자를 매핑한 뒤 순서를 정해 단계적으로 옮기고 커밋 체크포인트를 남김.
3. /refactor "deprecated API를 쓰는 모든 함수 현대화" --scope=project — librarian으로 최신 대체 API를 조사하고 ast-grep 미리보기 후 일괄 치환, 마지막에 전체 테스트·빌드 검증.

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 code-yeongyu/oh-my-openagent 의 packages/shared-skills/skills/refactor 폴더를 내 ~/.claude/skills/refactor/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.