Weekly Review Skill
Claude Code 세션 로그(~/.claude/session-logs/*.jsonl)의 시계열 데이터를 분석하여 프롬프팅 습관의 변화를 추적한다.
다른 도구(prompt-coach-skill 등)가 "지금 상태의 스냅샷"을 제공한다면, 이 스킬은 "지난주 대비 나아졌는가"에 답한다.
<!-- include:LOG-SPEC --> <!-- include:BACKLOG-SPEC -->- 최소 2주간의 데이터가 있어야 의미 있는 비교가 가능하다. 1주만 있으면 베이스라인 설정으로 안내한다.
실행 절차
1단계: 로그 수집
이번 주와 지난주(또는 사용자가 지정한 두 기간)의 로그를 모두 읽는다.
반드시 아래의 find | while read 패턴을 사용한다. brace expansion({0,1,2})이나 glob으로 날짜를 나열하면, 해당 날짜에 로그 파일이 없을 때 [ -f ] 실패로 exit code 1이 발생한다. find는 존재하는 파일만 매칭하므로 이 문제가 없다.
# 이번 주 로그 (예: 월~일)
find ~/.claude/session-logs/ -name "*.jsonl" | sort | while read f; do
d=$(basename "$f" .jsonl)
if [[ ! "$d" < "2026-03-23" && ! "$d" > "2026-03-29" ]]; then cat "$f"; fi
done
# 지난주 로그
find ~/.claude/session-logs/ -name "*.jsonl" | sort | while read f; do
d=$(basename "$f" .jsonl)
if [[ ! "$d" < "2026-03-16" && ! "$d" > "2026-03-22" ]]; then cat "$f"; fi
done
로그가 없는 날짜 안내
수집 후, 대상 기간 중 로그 파일이 존재하지 않는 날짜를 확인하여 안내한다. 주말이나 휴일에 세션을 실행하지 않았을 수 있으므로 경고가 아닌 참고 정보로 제시한다.
참고: 이번 주 중 다음 날짜에는 세션 로그가 없습니다: 04-11 (금), 04-12 (토)
Ctrl+C 강제 종료 세션은 Stop hook이 실행되지 않아 로그가 누락될 수 있다. 평일에 로그가 빠져 있고 세션을 실행한 기억이 있다면 이 가능성을 함께 안내한다.
데이터가 1주만 있으면 "이번이 첫 회고입니다. 이번 주 데이터를 베이스라인으로 설정합니다. 다음 주부터 비교가 가능합니다."로 안내하고, 베이스라인 스냅샷만 제시한다.
2단계: 주간 지표 비교
이번 주와 지난주의 지표를 나란히 비교한다. 절대값보다 변화율과 방향이 중요하다.
핵심 추적 지표
| 지표 | 계산 방법 | 개선 방향 |
|---|---|---|
| 한 줄 프롬프트 비율 | 20자 이하 프롬프트 수 / 전체 프롬프트 수 | 낮을수록 좋음 |
| 평균 턴 수 | 전체 turn_count 합 / 세션 수 | 낮을수록 좋음 (목표 달성이 빠르다는 의미) |
| high-turn 세션 비율 | turn_count >= 6인 세션 수 / 전체 세션 수 | 낮을수록 좋음 |
| 도구 효율 | tool_total / turn_count의 세션 평균 | 높을수록 좋음 (턴당 실질 작업이 많다) |
| 평균 활성 작업 시간 | active_elapsed_seconds 평균 (idle gap 5분+ 제외) | 맥락에 따라 다름 |
출력 형식
지표 지난주 이번 주 변화
한 줄 프롬프트 비율 32% 18% -14%p (개선)
평균 턴 수 4.2 3.1 -1.1 (개선)
high-turn 세션 비율 28% 15% -13%p (개선)
도구 효율 2.1 2.8 +0.7 (개선)
평균 활성 작업 시간 8m 20s 6m 10s -2m 10s
변화가 없거나 악화된 지표가 있으면 해당 항목을 별도로 표시한다.
3단계: 습관 변화 분석
숫자 비교에 그치지 않고, 프롬프트 텍스트의 패턴 변화를 확인한다.
프롬프트 품질 판단 기준
패턴 변화를 분석할 때 아래 기준을 사용한다. prompt-deep-dive 스킬의 진단 유형과 동일한 프레임이다.
| 기준 | 좋은 신호 | 나쁜 신호 |
|---|---|---|
| 맥락 제공 | 파일 경로, 에러 메시지, 기대 결과 포함 | "에러 나는데", "이거 고쳐줘" |
| 범위 설정 | 한 세션에 하나의 명확한 목표 | 주제가 2회 이상 전환 |
| 일회성 완결 | 1-2턴에 목표 달성 | 같은 의도의 프롬프트를 3회 이상 재시도 |
| 형식 지정 | 원하는 출력 형식을 미리 명시 | 형식 미지정 후 "이거 말고" 반복 |
3-1. 개선된 패턴 식별
지난주 로그와 이번 주 로그의 프롬프트 텍스트를 직접 비교하여, 이번 주에 새롭게 나타난 좋은 패턴을 찾는다:
- 파일 경로를 포함하는 프롬프트가 늘었는가
- 제약 조건이나 기대 결과를 명시하는 프롬프트가 늘었는가
- 지난주에 빈번했던 문제 유형(한 줄 프롬프트, 맥락 부족 등)이 이번 주에 줄었는가
실제 프롬프트 예시를 인용하여 근거를 제시한다.
이전 회고 리포트는 별도 저장하지 않으므로, 개선 여부는 항상 두 기간의 로그 원본을 직접 비교하여 판단한다.
3-2. 반복되는 문제 식별
두 주의 로그를 대조하여, 지난주에도 있었고 이번 주에도 있는 문제 패턴을 찾는다:
- 여전히 한 줄짜리로 시작하는 세션 유형이 있는가
- 특정 작업(예: 노션 업로드, 환경 설정)에서 반복적으로 맥락을 빠뜨리는가
반복되는 문제는 CLAUDE.md나 slash command로 해결할 수 있는지 제안한다.
3-3. 비정상 세션 샘플
이번 주에서 가장 비효율적이었던 세션 1-2개를 골라 턴별 흐름을 간단히 보여준다.
- 어느 턴에서 방향이 꼬였는지
- Before(원래 프롬프트) / After(개선 버전) 제안
- 변경 이유를 한 줄로
이 부분은 전수 조사가 아니라 대표 사례 위주로 간결하게 한다.
4단계: 학습 포인트 소비 현황
~/.claude/learning-backlog.md에서 미소비 항목과 이번 주 기간에 새로 추가된 항목을 집계한다.
"이번 주"의 날짜 범위는 1단계에서 정한 이번 주 시작일~종료일을 그대로 재사용한다 (사용자가 별도 기간을 지정한 경우에도 동일). 4단계에서 새로 주 경계를 계산하지 않는다.
cat ~/.claude/learning-backlog.md
파일이 없거나 데이터 행이 없으면 이 섹션을 생략한다.
집계 항목
| 항목 | 계산 방법 |
|---|---|
| 이번 주 신규 | 날짜 열이 1단계의 이번 주 시작일 ≤ d ≤ 종료일 범위인 행 수 |
| 미소비 (전공) | 상태가 비어있고 깊이가 "전공"인 행 수 |
| 미소비 (학습중) | 상태가 비어있고 깊이가 "학습중"인 행 수 |
| 미소비 (교양) | 상태가 비어있고 깊이가 "교양"인 행 수 |
| 총 소비 완료 | 상태가 "done"인 행 수 |
출력 형식
## 학습 포인트 소비 현황
이번 주 신규: N개
미소비 누적: 전공 A개 / 학습중 B개 / 교양 C개
### 미소비 전공 항목 (우선 확인 권장)
- [2026-04-10] NCCL ring allreduce 토폴로지 최적화 — NCCL docs topology detection 섹션
- ...
### 이번 주 신규 항목
- [2026-04-13] CNI 플러그인 성능 차이 (학습중) — Cilium 벤치마크 문서
- ...
전공 미소비 항목이 5개 이상 쌓이면 경고를 추가한다 (임계값 5는 경험적 기본값이며, 사용자가 회고에서 더 타이트/느슨하게 쓰고 싶다고 하면 그에 맞춰 조정한다):
⚠ 전공 영역 미소비 항목이 N개 누적되어 있습니다. 지식 격차가 커지기 전에 우선순위를 정해 소비하는 것을 권장합니다.
5단계: 리포트 작성
아래 구조로 출력한다.
# 주간 회고: {이번 주 시작일} ~ {종료일}
## 지표 비교
(2단계의 비교 테이블)
## 이번 주 잘한 점
(개선된 패턴 + 실제 프롬프트 예시)
## 아직 남은 과제
(반복되는 문제 패턴 + 구조적 해결 제안)
## 이번 주의 비효율 세션
(1-2개 대표 사례의 Before/After)
## 학습 포인트 소비 현황
(4단계의 집계 결과 — 백로그 파일이 없거나 항목이 없으면 생략)
## 다음 주 액션 아이템
(실행 가능한 1-2개, 구체적으로)
6단계: 장기 추이 (4주 이상 데이터가 있을 때)
4주 이상 데이터가 쌓이면, 핵심 지표의 주차별 추이를 추가로 보여준다.
주차 한 줄 비율 평균 턴 high-turn 비율
W1 (03/02~) 35% 4.5 30%
W2 (03/09~) 28% 3.8 22%
W3 (03/16~) 32% 4.2 28%
W4 (03/23~) 18% 3.1 15%
추이에서 의미 있는 패턴이 보이면 코멘트한다:
- 꾸준히 개선되고 있는 지표
- 한 주 개선 후 다시 악화된 지표 (왜 그런지 해당 주의 프롬프트를 샘플링)
- 정체된 지표 (이미 충분히 좋은 건지, 구조적 한계인지)
주의사항
- 프롬프트 원문에 민감 정보가 포함될 수 있다. 인용 시 API 키, 비밀번호 등은 마스킹한다.
- 비판이 아닌 개선 제안의 톤을 유지한다. "나빠졌다"가 아니라 "이 부분에 다시 주의를 기울이면 좋겠다"로 표현한다.
- 지표가 악화되었더라도 작업 성격 변화(탐색적 작업, 리팩토링 등이 많았던 주 등)가 원인일 수 있으므로, 숫자만으로 판단하지 않는다.
- Ctrl+C 강제 종료 세션은 로그에 포함되지 않는다. 세션 수가 체감보다 적으면 이를 안내한다.
- 비교 대상 주에 세션이 3개 미만이면 통계적으로 의미가 적으므로 "데이터 부족"을 명시한다.
- 리포트 출력 후, 결과를 저장하고 싶은 사용자를 위해 다음 안내를 추가한다: "이 리뷰를 저장하려면
/export-review를 사용하세요." - 학습 포인트 소비 현황 섹션이 포함된 경우, 다음 안내를 추가한다: "학습을 마친 항목은
~/.claude/learning-backlog.md에서 상태 열에done을 기입하세요."