[AI] Claude - 커스텀 명령어로 커밋 프롬프트 자동화하기

안녕하세요! 개발 과정에서 AI 어시스턴트를 활용하다 보면,

매번 비슷하거나 똑같은 프롬프트를 반복해서 입력해야 할 때가 많습니다.

특히 깃(Git) 커밋 메시지를 작성하거나 코드 리뷰를 요청할 때, 매번 긴 규칙을 설명하는 것은 상당히 번거로운 일입니다.

 

오늘은 이런 번거로움을 한 번에 해결해 줄 '커스텀 슬래시 명령어' 설정 방법에 대해 알아보겠습니다.

한 번만 설정해 두면 업무 효율을 비약적으로 끌어올릴 수 있습니다! 🚀

---

🛠️ 커스텀 슬래시 명령어란?

커스텀 슬래시 명령어는 자주 사용하는 긴 프롬프트를 하나의 짧은 명령어로 단축하여 사용하는 기능입니다.

예를 들어, 길고 복잡한 커밋 생성 프롬프트를 /commit 이라는 짧은 명령어 하나로 호출할 수 있게 해줍니다.

⚙️ 설정 방법

설정 방법은 매우 간단합니다. 사용 중인 프로젝트 폴더 루트 영역에 폴더와 마크다운 파일만 추가해 주시면 됩니다.

1. 명령어 폴더 생성

프로젝트의 루트 디렉토리에 .claude/commands/ 폴더를 생성합니다.

2. 마크다운(.md) 파일 추가

해당 폴더 안에 명령어 이름으로 사용할 마크다운 파일을 생성합니다.

폴더 구조 예시

.claude/
└── commands/
    └── commit.md     <-- 이 파일이 /commit 명령어가 됩니다.

📝 활용 예시 : 자동 커밋 및 푸시 명령어 (commit.md)

제가 주로 사용하는 커밋 메시지 자동화 프롬프트를 예시로 보여드리겠습니다. 아래 내용을 방금 만든 commit.md 파일에 복사해서 붙여넣어 보세요.

# Commit and Push

1. 변경된 파일들을 확인해줘 
2. 각 기능들을 나누어서 아래 컨벤션에 맞춰 의미 있는 커밋 메시지를 작성해줘 (한국어)
- feat : 새로운 기능 추가, 기존의 기능을 요구 사항에 맞추어 수정
- fix : 기능에 대한 버그 수정
- build : 빌드 관련 수정
- chore : 패키지 매니저 수정, 그 외 기타 수정 ex) .gitignore
- ci : CI 관련 설정 수정
- docs : 문서 수정 (README, 주석, 문서 파일 변경 시)
- style : 코드 스타일, 포맷팅에 대한 수정
- refactor : 기능의 변화가 아닌 코드 리팩터링 ex) 변수 이름 변경
- test : 테스트 코드 추가/수정
- release : 버전 릴리즈
3. 커밋하고 현재 브랜치에 푸시해줘

✨ 어떻게 사용하나요?

이제 설정이 모두 끝났습니다! 채팅창에서 다음과 같이 입력해 보세요.

 

👉 /commit

AI가 자동으로 commit.md에 작성해둔 컨벤션 규칙을 읽어들이고, 현재 변경된 파일들을 분석하여 알맞은 커밋 메시지를 생성한 뒤 푸시까지 일괄적으로 처리해 줍니다.

💡 마무리하며

이번 글에서는 커밋 메시지를 예시로 들었지만, 여러분의 작업 스타일에 맞춰 얼마든지 다양하게 응용할 수 있습니다.

• /review : 사내 코드 리뷰 규칙을 정해두고 검사 목적으로 사용하기
• /test : 특정 프레임워크 기반의 유닛 테스트 코드 템플릿 생성하기
• /refactor : 회사 컨벤션에 맞춰서 일괄적으로 코드 리팩토링 지시하기

자주 반복되는 타이핑에 지치셨다면,

지금 바로 커스텀 명령어를 도입하셔서 개발 생산성을 한 단계 높여보시길 강력하게 추천합니다! 😊