Cmd. /simplify
변경 코드에서 재사용·단순화·효율·추상화 수준을 정리하는 cleanup 명령
핵심 요약
/simplify는 변경 코드를 재사용·단순화·효율·추상화 수준에서 정리하는 번들 스킬로, 리뷰 에이전트 네 개가 병렬로 실행됩니다.- v2.1.154부터 correctness bug를 찾지 않으므로, 버그 탐지가 목적이면
/code-review를 사용해야 합니다. - 인자는 자유 서술 지시문이 아니라 점검 대상(path 또는 PR 참조)이며, 생략하면 현재 diff 전체가 대상입니다.
- 그 이전 버전에서는
/code-review --fix와 동등하게 동작했습니다. - 자동 수정 결과를 그대로 머지하지 말고 팀 기준으로 검토하세요.
명령어 원본 선언
/simplify [target][target]: 특정 대상을 점검하고 싶을 때 경로(path) 또는 PR 참조(PR reference)를 전달합니다. 생략하면 현재 변경분(diff)을 대상으로 합니다.
공식 설명 요약
/simplify는 Claude Code가 기본 제공하는 번들 스킬(bundled skill) 명령으로,
변경된 코드를 cleanup(정리) 관점에서 점검하고 수정을 자동으로 반영합니다.
공식 문서에 따르면 네 개의 리뷰 에이전트가 병렬로 실행되며 각각 다음을 담당합니다.
- 재사용(reuse of existing helpers): 이미 존재하는 헬퍼/유틸을 활용할 수 있는지
- 단순화(simplification): 더 간단하게 표현할 수 있는지
- 효율(efficiency): 비효율적인 구현이 있는지
- 추상화 수준(altitude / level of abstraction): 변경이 적절한 추상화 수준에 위치하는지
v2.1.154부터 이 리뷰는 correctness bug(정확성 버그)를 찾지 않습니다. 버그 탐지가 필요하면
/code-review를 사용해야 합니다. 그 이전 버전에서는 /simplify가 /code-review --fix와
동일하게 동작했습니다.
분류
/simplify는 built-in command가 아니라 bundled skill입니다. 인터랙티브
모드의 / 메뉴에서 함께 노출됩니다.
최소 지원 버전
- 공식 문서 명령 표 기준
v2.1.154(min-version 주석) v2.1.154부터 cleanup-only 동작으로 역할 분리 (버그 탐지는/code-review로 이관)- 그 이전 버전에서는
/code-review --fix와 동등하게 동작
사용법
현재 변경분 전체를 정리:
/simplify특정 경로를 대상으로 정리:
/simplify src/utils/parser.ts특정 PR을 대상으로 정리:
/simplify #123인자는 path 또는 PR 참조
/simplify의 인자는 자유 서술 지시문이 아니라 점검할 대상(target) 입니다. 경로나 PR 참조를
전달해 범위를 좁힐 수 있습니다.
좋은 사용 예
- 기능 구현 직후 품질 정리 단계에서 변경분 전체를
/simplify로 정리 - 특정 파일/디렉터리만 다듬고 싶을 때 경로를 인자로 지정
- 머지 전 PR 단위로 cleanup을 적용해 일관된 코드 품질 유지
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/compact | 기존 대화 요약 중심 | 컨텍스트를 줄이고 싶을 때 |
/review | PR 중심 품질 검토 | PR 관점 코드 리뷰가 필요할 때 |
/code-review | correctness bug + cleanup 검토 (--fix로 적용, --comment로 PR 코멘트) | 버그를 찾고 싶을 때 |
/simplify | cleanup-only 후처리 자동화 (버그 미탐지) | 구현 직후 품질/중복/효율/추상화 정리가 필요할 때 |
활용 사례
- 기능 구현 후 중복 로직 정리 및 기존 헬퍼 재사용 유도
- 비효율 코드 탐지 및 개선
- 추상화 수준이 어긋난 변경 정돈
- 코드 품질 후처리 자동화
주의사항
- 버그 탐지가 목적이면
/simplify가 아니라/code-review를 사용 (v2.1.154부터/simplify는 버그를 찾지 않음) - 인자는 자유 서술 지시문이 아니라 path 또는 PR 참조임에 유의
- 대규모 변경 전에는 diff 검토 루틴(
/review,/code-review)과 함께 사용 - 자동 수정 결과를 그대로 머지하지 말고 팀 기준으로 검토
출처
- Claude Code Docs — Commands: https://code.claude.com/docs/en/commands
- Claude Code Docs — Bundled skills: https://code.claude.com/docs/en/skills