venom: Skill for Claude Code

회고(Retro) 스킬

숫자는 거짓말하지 않는다. git과 메모리가 말하는 것을 들어라. 회고는 자책이 아니라 다음 주를 더 잘 보내기 위한 데이터 수집이다.

트리거

• "회고해줘" / "이번 주 어땠어" / "retro" / "/retro"
• 주간 또는 세션 종료 시점
• 릴리스 직후 ("이번 배포 정리해줘")

입력 파싱

기간을 지정하지 않으면 지난 7일이 기본. 명시적 기간 예시:

• "오늘 회고" → 오늘 0시 이후
• "이번 주 회고" → 지난 7일
• "이번 스프린트" → 사용자에게 시작 날짜를 묻는다
• "v1.2 릴리스 이후" → 해당 태그 이후

절차

1단계: git 통계 수집 (병렬)

# 커밋 수 및 메시지
git log --oneline --since="7 days ago" --no-merges

# 파일별 변경량
git diff --stat HEAD~$(git log --oneline --since="7 days ago" --no-merges | wc -l) HEAD 2>/dev/null || \
git log --since="7 days ago" --no-merges --numstat --format="" | awk '{add+=$1; del+=$2} END {print "+"add" -"del}'

# 변경된 파일 목록
git log --since="7 days ago" --no-merges --name-only --format="" | sort -u | head -30

# 작업한 브랜치
git log --since="7 days ago" --no-merges --format="%D" | tr ',' '\n' | grep -v '^$' | sort -u | head -10

# 커밋 타입 분포 (conventional commits 기준)
git log --since="7 days ago" --no-merges --format="%s" | grep -oP '^(feat|fix|docs|refactor|test|chore|perf|build|ci)' | sort | uniq -c | sort -rn

기간 내 커밋이 0개이면 파라미터를 늘려 재시도하고, 그래도 없으면 사용자에게 알린다.

2단계: 메모리 패턴 분석

a) .claude/memory/mistakes.md 에서 해당 기간 항목 추출
   - 새로 기록된 실수 개수
   - 반복 태그 있는지 (진화 트리거 확인)

b) .claude/memory/lessons.md 에서 새 항목 확인

c) .claude/memory/decisions.md 에서 기간 내 ADR 확인

3단계: 진화 신호 감지

아래 조건이 감지되면 진화 권고 섹션에 명시:

신호	의미
mistakes.md 동일 태그 2회 이상	해당 영역 규칙/hook 강화 필요
같은 커밋 타입이 전체의 60% 이상	특정 작업 패턴 → 스킬 추출 고려
fix 커밋이 feat 커밋보다 많음	테스트 커버리지 또는 설계 문제 신호
문서 관련 커밋이 0개	코드-문서 불일치 누적 가능성

4단계: 리포트 생성

출력 형식

## 🔁 회고 — YYYY-MM-DD ~ YYYY-MM-DD

### 📊 숫자
| 항목 | 값 |
|---|---|
| 커밋 | N개 |
| 추가 라인 | +X |
| 삭제 라인 | -Y |
| 순 변화 | +Z |
| 변경 파일 | N개 |
| 테스트 커밋 비율 | N% |

### 🏗️ 무엇을 했나
커밋 타입별 요약. 가장 많이 건드린 영역 3개.

### 🐛 실수와 학습
- 이번 기간 mistakes.md에 기록된 실수: N개
- 새 교훈(lessons.md): N개
- 반복 태그: <있으면 나열 / 없음>

### 🚧 막힌 곳
fix 커밋이 많거나 같은 파일을 반복 수정한 경우 식별.

### ⚡ 진화 권고
<감지된 진화 신호가 있으면 나열. 없으면 "이번 기간 진화 트리거 없음">

### 📝 다음 주 제안
데이터 기반으로 1~3개 제안. 추측 금지 — 숫자에서 도출한 것만.