SKILL.md
Catchup - Git 변경사항 추적 스킬
현재 작업 중인 코드의 변경사항을 빠르게 파악하여 컨텍스트를 제공하는 스킬입니다.
주요 기능
모든 기능은 ./scripts/git-helper.sh를 통해 접근합니다.
| 작업 | 명령어 | 설명 |
|---|---|---|
| 미커밋 변경사항 | ./scripts/git-helper.sh status |
Staged + Unstaged 변경사항 확인 |
| 직전 커밋 | ./scripts/git-helper.sh last |
가장 최근 커밋 상세 정보 |
| 최근 커밋 목록 | ./scripts/git-helper.sh log [n] |
최근 n개 커밋 목록 (기본값: 10) |
| 커밋 범위 비교 | ./scripts/git-helper.sh diff <start> <end> |
두 커밋 사이의 변경사항 |
필터링 옵션
명령어 앞에 다음 옵션을 추가할 수 있습니다:
| 옵션 | 설명 | 사용 예시 |
|---|---|---|
--code-only |
코드 파일만 표시 (문서, 설정 파일 제외) | ./scripts/git-helper.sh --code-only status |
--no-meta-commits |
메타 커밋 제외 (docs, prompt, config 등) | ./scripts/git-helper.sh --no-meta-commits log |
필터링 대상 (--code-only):
- 제외:
docs/,.claude/,.gemini/,.md,*.toml,.gitignore,.katarc - 포함: 실제 코드 파일 (
.py,.sh등)
필터링 커밋 (--no-meta-commits):
- 제외:
^prompt,^📌,^docs,^📝,^config,^🔧,^chore,^style,^refactor,^test,^build,^ci
사용 예시
예시 1: 현재 작업 파악
사용자 요청:
"지금까지 뭐 작업했는지 catchup 해줘"
스킬 동작:
# 미커밋 변경사항
./scripts/git-helper.sh status
# 최근 커밋
./scripts/git-helper.sh last예시 2: 코드만 확인
사용자 요청:
"문서 빼고 코드 변경사항만 보여줘"
스킬 동작:
./scripts/git-helper.sh --code-only status예시 3: 최근 히스토리 확인
사용자 요청:
"최근에 어떤 작업들을 했는지 커밋 목록 보여줘"
스킬 동작:
./scripts/git-helper.sh log 10예시 4: 의미있는 커밋만 확인
사용자 요청:
"문서 커밋 빼고 실제 기능 커밋만 보여줘"
스킬 동작:
./scripts/git-helper.sh --no-meta-commits log 20예시 5: 특정 범위 조사
사용자 요청:
"커밋 abc123부터 def456까지 뭐가 바뀌었는지 보여줘"
스킬 동작:
./scripts/git-helper.sh diff abc123 def456예시 6: 코드만 + 메타 커밋 제외
사용자 요청:
"실제 기능 구현 코드만 최근 10개 커밋 보여줘"
스킬 동작:
./scripts/git-helper.sh --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"