| name | catchup |
| description | Git 저장소의 변경사항을 추적하고 요약합니다. 미커밋 코드, 최근 커밋, 커밋 히스토리를 확인할 때 사용하세요. catchup, 변경사항, git diff, 커밋 히스토리, 작업 내용 파악 등의 키워드에 반응합니다. |
| allowed-tools | Bash |
Catchup - Git 변경사항 추적 스킬
현재 작업 중인 코드의 변경사항을 빠르게 파악하여 컨텍스트를 제공하는 스킬입니다.
주요 기능
모든 기능은 scripts\git-helper.bat를 통해 접근합니다.
| 작업 | 명령어 | 설명 |
|---|---|---|
| 미커밋 변경사항 | scripts\git-helper.bat status |
Staged + Unstaged 변경사항 확인 |
| 직전 커밋 | scripts\git-helper.bat last |
가장 최근 커밋 상세 정보 |
| 최근 커밋 목록 | scripts\git-helper.bat log [n] |
최근 n개 커밋 목록 (기본값: 10) |
| 커밋 범위 비교 | scripts\git-helper.bat diff <start> <end> |
두 커밋 사이의 변경사항 |
필터링 옵션
명령어 앞에 다음 옵션을 추가할 수 있습니다:
| 옵션 | 설명 | 사용 예시 |
|---|---|---|
--code-only |
코드 파일만 표시 (문서, 설정 파일 제외) | ./scripts/git-helper.sh --code-only status |
--no-meta-commits |
메타 커밋 제외 (docs, prompt, config 등) | scripts\git-helper.bat --no-meta-commits log |
필터링 대상 (--code-only):
- 제외:
docs/*,.claude/*,.gemini/*,*.md,*.toml,.gitignore,.katarc - 포함: 실제 코드 파일 (
.py,.bat등)
필터링 커밋 (--no-meta-commits):
- 제외:
^prompt,^📌,^docs,^📝,^config,^🔧,^chore,^style,^refactor,^test,^build,^ci
사용 예시
예시 1: 현재 작업 파악
사용자 요청:
"지금까지 뭐 작업했는지 catchup 해줘"
스킬 동작:
REM 미커밋 변경사항
scripts\git-helper.bat status
REM 최근 커밋
scripts\git-helper.bat last
예시 2: 코드만 확인
사용자 요청:
"문서 빼고 코드 변경사항만 보여줘"
스킬 동작:
scripts\git-helper.bat --code-only status
예시 3: 최근 히스토리 확인
사용자 요청:
"최근에 어떤 작업들을 했는지 커밋 목록 보여줘"
스킬 동작:
scripts\git-helper.bat log 10
예시 4: 의미있는 커밋만 확인
사용자 요청:
"문서 커밋 빼고 실제 기능 커밋만 보여줘"
스킬 동작:
scripts\git-helper.bat --no-meta-commits log 20
예시 5: 특정 범위 조사
사용자 요청:
"커밋 abc123부터 def456까지 뭐가 바뀌었는지 보여줘"
스킬 동작:
scripts\git-helper.bat diff abc123 def456
예시 6: 코드만 + 메타 커밋 제외
사용자 요청:
"실제 기능 구현 코드만 최근 10개 커밋 보여줘"
스킬 동작:
scripts\git-helper.bat --code-only --no-meta-commits log 10
출력 형식
status 명령어
📝 Unstaged changes:
hidden-number/domain/game.py | 10 +++++-----
✅ Staged changes:
hidden-number/tests/test_game.py | 5 +++++
last 명령어
🔖 Latest commit:
a760d78 - 📝docs : 드라이버 가이드문서 업데이트 (2 hours ago)
docs/driver-guide.md | 25 +++++++++++++++++++++++++
log 명령어
📋 Recent 10 commits:
a760d78 📝docs : 드라이버 가이드문서 업데이트
ae467b4 📌prompt : update 드라이버 가이드
2d257c1 📌prompt : update 드라이버 가이드
diff 명령어
📊 Commit range: abc123..def456
abc124 ✨feat : Game 클래스 구현
def456 ✅test : Game 테스트 추가
📝 Detailed changes per commit:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔖 abc124 - ✨feat : Game 클래스 구현
👤 takgyun (2 hours ago)
hidden-number/domain/game.py | 50 ++++++++++++++++++++++++++++++++
주의사항
- Git 저장소 루트에서 실행되어야 합니다
- 한글 파일명/커밋 메시지가 포함된 경우 UTF-8 인코딩 자동 설정됨
- 큰 diff는
--stat으로 요약하여 컨텍스트 절약 - 필요시에만 전체 diff 내용을 제공하도록 선택적으로 사용
한글 인코딩 설정
스크립트 내부에서 자동으로 설정됩니다:
export LC_ALL=C.UTF-8
GIT_OPTS="-c core.quotepath=false"