메뉴
기존 코드의 안전한 리팩토링. Characterization Test로 동작을 보존하며 구조 개선. Use when 리팩토링, 레거시 코드 개선, 동작 보존, 구조 개선, 기존 코드 정리, characterization test 작성 시. Do NOT use for 새 기능 개발이나 버그 수정 (일반 편집 사용).
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/ssiumha/dots --skill refactoring명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SOC 직업 분류 기준
SKILL.md 표시 중
| name | refactoring |
| description | 기존 코드의 안전한 리팩토링. Characterization Test로 동작을 보존하며 구조 개선. Use when 리팩토링, 레거시 코드 개선, 동작 보존, 구조 개선, 기존 코드 정리, characterization test 작성 시. Do NOT use for 새 기능 개발이나 버그 수정 (일반 편집 사용). |
| user-invocable | true |
기존 코드를 안전하게 리팩토링하는 ANALYZE-PRESERVE-IMPROVE 워크플로우.
| tidy | refactoring | |
|---|---|---|
| 규모 | 분 단위 소규모 정리 | 시간~일 단위 구조 변경 |
| 테스트 | 기존 테스트 의존 | Characterization Test 새로 작성 |
| 범위 | 단일 패턴 (guard clause, dead code 등) | 모듈 추출, 클래스 분리, API 마이그레이션 |
| 커밋 | 1 tidying = 1 commit | 단계별 incremental commit |
| tdd | refactoring | |
|---|---|---|
| 대상 | 새 기능 (코드 없음) | 기존 코드 (동작 있음) |
| 테스트 | Specification Test (기대 동작 정의) | Characterization Test (현재 동작 캡처) |
| 사이클 | RED-GREEN-REFACTOR | ANALYZE-PRESERVE-IMPROVE |
현재 코드 구조를 파악하고 리팩토링 대상을 식별한다.
구조 분석:
/vis-graph 활용)문제 패턴 식별 (ast-grep 활용):
산출물: 현재 구조 + 문제 영역 + 리팩토링 대상 + 리스크 평가
변경 전 안전망을 구축한다. 이 단계를 건너뛰지 않는다.
Characterization Test 작성:
Characterization Test는 "정답"을 검증하는 게 아니라 **"현재 동작"**을 기록한다. 리팩토링 후 이 테스트가 깨지면 동작이 바뀐 것이다.
네이밍: test_characterize_{component}_{scenario}
Characterization Test의 품질은
/principles check TEST-BEHAVIOR(외부 행위 기반 검증) 및/principles check TEST-SMELLS(Sensitive Equality — 부동소수점·직렬화 포맷 주의) 참조.
Behavior Snapshot (복잡한 출력일 때):
Safety Net 검증:
한 번에 큰 변경을 하지 않는다. 패턴:
가장 작은 구조 변경 → 전체 테스트 → 실패 시 즉시 revert → 성공 시 commit → 반복
안전한 리팩토링 패턴:
각 변환 후 검증:
1. 리팩토링 범위 확인 (SPEC 또는 사용자 요청)
2. ANALYZE: 대상 코드 구조 분석
3. PRESERVE: Characterization Test 작성 + 기존 테스트 통과 확인
4. IMPROVE: 점진적 변환 (각 단계마다 테스트 + 커밋)
5. 검증: 전후 메트릭 비교 + 모든 테스트 통과
리팩토링의 황금률: 관찰 가능한 동작이 전후 동일해야 한다.
테스트 실패 시: 즉시 revert → 어떤 테스트가 왜 실패했는지 분석 → 더 작은 단위로 재시도
Characterization Test가 flaky: 비결정적 요소 식별 → 외부 의존성 mock → 시간/순서 의존 제거
성능 저하: 전후 프로파일링 → 핫 패스 확인 → 최적화 또는 트레이드오프 문서화
/tidy — 분 단위 소규모 코드 정리/plan-review tdd — 새 기능의 테스트 주도 개발/vis-graph — 파일 간 의존성 시각화/strategic-thinking — 리팩토링 범위 결정 시 체계적 판단Origin: moai-adk workflow-ddd (ANALYZE-PRESERVE-IMPROVE cycle) 기반, dots 스타일로 재구성
프로젝트 운영 성숙도 순차 진단. 로깅 → 메트릭·트레이싱 → 알림·SLO → 배포 안전성 → 운영 준비도 → 용량·비용 6축을 저장소 정적 분석으로 점검하여 누락 항목과 개선 제안을 리포트. Use when SRE 점검, 운영 점검, 관측성 진단, observability audit, SLO 점검, 알림 규칙 점검, 배포 안전성, 롤백 경로, 런북, 백업·복구 검증, 에러 응답 계약 (problem details, RFC 9457), 운영 준비도, "이 프로젝트에 뭐가 빠졌는지 봐줘", 프로젝트 전체 진단. Do NOT use for CI/CD·Docker 설정 생성 (use devops), 보안 취약점 (use security), 코드 품질·lint·타입 (use code-review), IaC 안전성 (use terraform).
Code review hub. 타입 안전성 (TypeScript, Python), lint 감사, 죽은 코드, 테스트 품질 리뷰 (smell, overfitting, 커버리지, 통합/E2E), Terraform/IaC 안전성 (lifecycle, state, credentials). 자기설명 코드 리뷰 (문서·주석에만 있는 계약, 실행되지 않는 문서 예제, 미강제 구조 규칙). 병렬 에이전트 모드로 다각적 분석 지원. 코드 리뷰, 타입 체크, lint, 테스트 리뷰, terraform, IaC, 문서 드리프트.
Audits, improves, and tracks Claude Code agent harness (CLAUDE.md, rules, hooks, skills, agents, settings, memory, architecture, knowledge base). Use when reviewing harness quality, adding constraints/rules/hooks, designing agent teams/orchestration, optimizing agent performance, diagnosing agent misbehavior, setting up harness for a new repository, or managing documentation freshness. Do NOT use for creating new skills (use my-skill-creator) or basic Claude Code setup (use claude-guide).