| name | refactor |
| description | 사용자가 "리팩토링해줘", "refactor", "규칙 맞춰줘", "컨벤션 적용" 등을 요청하거나, PR 생성 전 코드 정리가 필요할 때 사용 |
변경된 파일에 해당하는 프로젝트 rules를 로드하고, 컨벤션 위반을 찾아 수정하는 스킬.
1단계: 변경 파일 수집
git diff --name-only
git diff --staged --name-only
두 결과를 합쳐 중복 제거한다. 변경 파일이 없으면 알리고 종료한다.
2단계: 적용할 rules 결정
| 파일 경로 패턴 | rules 파일 |
|---|
src/**/*.ts, src/**/*.tsx, *.config.ts | .claude/rules/typescript.md |
- 항상
.claude/rules/common.md를 포함한다.
- 매칭되는 rules 파일을 모두 읽는다.
3단계: 변경 내용 분석
git diff
git diff --staged
변경된 코드를 rules와 대조해 위반을 목록화한다.
4단계: 리팩토링 수행
발견된 위반을 수정한다. 수정 범위는 변경된 코드에 한정 — 변경하지 않은 기존 코드는 건드리지 않는다.
수정 대상 예시:
- 주석 언어 (한국어)
- import 순서
- 매직 넘버/문자열
- TODO/FIXME 형식 (
// TODO(이슈번호): 내용)
- 파일 역할 분리 위반
- Prettier 포맷 (single quote / semi / 120 / 2-space / es5 trailing comma)
5단계: 결과 보고
- 적용한 rules 파일
- 수정 항목별 한 줄
- 위반이 없으면 "위반 없음"
