my-history-insight
과거 Claude Code 세션 기록에서 패턴을 찾아 인사이트를 추출한다. "일기장을 꺼내서 이번 달 돌아보기"와 같은 역할.
Execution Flow
┌─────────────────────────────────────────────┐
│ Step 1. 세션 파일 탐색 │
│ ~/.claude/projects/ 에서 .jsonl 파일 목록 │
└──────────────────────┬──────────────────────┘
│
┌──────────────────────▼──────────────────────┐
│ Step 2. 사용자 메시지만 추출 │
│ (전체의 ~6% — 나머지 94%는 부속 자료) │
└──────────────────────┬──────────────────────┘
│
┌──────────────────────▼──────────────────────┐
│ Step 3. 병렬 분석 (3개 에이전트 동시) │
│ ┌──────────────┬──────────────┐ │
│ │session- │pattern- │ │
│ │summarizer │finder │ │
│ ├──────────────┴──────────────┤ │
│ │growth-tracker │ │
│ └─────────────────────────────┘ │
└──────────────────────┬──────────────────────┘
│
┌──────────────────────▼──────────────────────┐
│ Step 4. 인사이트 리포트 출력 │
└─────────────────────────────────────────────┘
Step 1: 세션 파일 탐색
현재 프로젝트의 세션 파일 목록을 확인한다.
- 위치:
~/.claude/projects/하위 폴더 - 파일 형식: UUID 형태의
.jsonl파일 - subagents/ 폴더 안의 파일은 제외 (서브에이전트 기록)
- 파일 수와 전체 크기를 파악해서 분석 범위 결정
파일이 너무 많으면 (20개 이상) 최근 10개만 분석한다.
Step 2: 사용자 메시지 추출
각 .jsonl 파일에서 실제 대화 내용만 추출한다.
- jsonl 파일의 각 줄은 JSON 객체
"role":"user"인 항목의 content만 추출- tool_use, tool_result, system 메시지는 모두 제외
- 추출된 텍스트로 세션의 주제를 파악
핵심: 세션 파일의 ~94%는 파일 변경 이력, 도구 실행 로그 등 부속 자료. 실제 사용자 대화는 ~6%뿐이므로 이것만 추출해서 빠르게 분석한다.
Step 3: 병렬 분석 (3개 에이전트 동시 실행)
추출한 대화 내용을 3개 에이전트가 동시에 분석한다.
Agent 1: session-summarizer
- 역할: 각 세션이 어떤 작업이었는지 한 줄로 요약
- 출력: 세션별 요약 목록 (날짜 + 주제)
Agent 2: pattern-finder
- 역할: 전체 세션에서 반복되는 패턴 탐지
- 확인 항목:
- 가장 자주 한 작업 유형 (자동화, 문서 작성, API 연동 등)
- 반복되는 에러나 재시도 패턴
- 자주 사용하는 도구나 기술
- 출력: 패턴 Top 3 + 근거
Agent 3: growth-tracker
- 역할: 시간에 따른 변화와 성장을 추적
- 확인 항목:
- 초기 세션 vs 최근 세션의 작업 복잡도 변화
- 새로 추가된 기술 또는 도구
- 반복되던 작업이 자동화된 흔적
- 출력: 성장 포인트 2~3개
Step 4: 인사이트 리포트 출력
3개 에이전트 결과를 통합해서 아래 형식으로 출력한다.
📊 히스토리 인사이트 리포트
분석 세션: XX개 | 기간: YYYY-MM-DD ~ YYYY-MM-DD
━━━━━━━━━━━━━━━━━━━━━━━━
📅 세션별 요약 (최근 순)
- [날짜] 세션명: 한 줄 요약
- ...
━━━━━━━━━━━━━━━━━━━━━━━━
🔍 반복 패턴 Top 3
1. [패턴명]: 설명
2. [패턴명]: 설명
3. [패턴명]: 설명
━━━━━━━━━━━━━━━━━━━━━━━━
📈 성장 트래킹
- [성장 포인트 1]
- [성장 포인트 2]
- [성장 포인트 3]
━━━━━━━━━━━━━━━━━━━━━━━━
💡 핵심 인사이트
[전체를 관통하는 핵심 한 문장]
분석 범위 옵션
스킬 실행 시 AskUserQuestion으로 범위를 선택받는다:
AskUserQuestion({
"questions": [{
"question": "어떤 범위로 분석할까요?",
"header": "분석 범위",
"options": [
{"label": "현재 프로젝트만", "description": "지금 작업 중인 프로젝트 세션만 분석"},
{"label": "최근 10개 세션", "description": "가장 최근 10개 세션만 빠르게 분석"},
{"label": "전체 세션", "description": "모든 Claude Code 세션 분석 (시간 더 소요)"}
],
"multiSelect": false
}]
})
Quick Reference
- 언제: 월간 회고, 프로젝트 전환 시, "내가 뭘 해왔지?" 궁금할 때
- 소요 시간: ~2분 (현재 프로젝트 기준)
- 출력 파일:
sync/history-insight-YYYY-MM-DD.md(선택)