Learning Tracker Skill

개요

Claude Code 세션 로그에서 새로운 기술, 라이브러리, 개념에 대한 학습 내용을 추출하여 TIL(Today I Learned) 형식으로 정리하는 skill.

사용 방식

독립 실행

/learning-tracker           # 어제 날짜 학습 내용 추출
/learning-tracker 2026-01-15  # 특정 날짜 학습 내용 추출

daily-work-logger 연동

daily-work-logger 실행 시 SubAgent 4로 자동 호출됨
결과가 Daily Note의 "학습 기록" 섹션에 반영됨

경로 정보

| 항목 | 경로 | |------|------| | Claude 세션 | ~/.claude/projects/ | | history.jsonl | ~/.claude/history.jsonl | | transcripts | ~/.claude/transcripts/ | | TIL 출력 | ~/DocumentsLocal/msbaek_vault/notes/dailies/ (Daily Note 내) |

학습 감지 패턴

한국어 키워드

| 패턴 | 설명 | |------|------| | "배웠", "배워" | 학습 완료 표현 | | "알게 됐", "알았" | 새로운 이해 | | "처음", "처음으로" | 최초 경험 | | "새로운", "새롭게" | 새로운 지식 | | "이해했", "이해됐" | 개념 이해 | | "몰랐던", "몰랐는데" | 기존 무지 인정 |

영어 키워드

| 패턴 | 설명 | |------|------| | "TIL", "Today I learned" | 명시적 학습 표현 | | "learned", "discovered" | 학습/발견 | | "didn't know", "now I know" | 새로운 지식 | | "first time" | 최초 경험 |

질문 패턴 (사용자 질문 → 학습 기회)

| 패턴 | 설명 | |------|------| | "이게 뭐야?", "이게 뭔가요?" | 개념 질문 | | "어떻게 해?", "어떻게 하나요?" | 방법 질문 | | "왜?", "왜 그런가요?" | 이유 질문 | | "차이가 뭐야?" | 비교 질문 | | "What is", "How to", "Why" | 영어 질문 |

기술 학습 지표

| 지표 | 설명 | |------|------| | 새 라이브러리 import | 처음 사용하는 패키지 | | 새 CLI 도구 사용 | 처음 사용하는 명령어 | | API 문서 참조 | WebFetch로 공식 문서 조회 | | 에러 해결 후 설명 | 문제 해결 과정에서 학습 |

실행 절차

Step 1: 날짜 결정

TARGET_DATE="${1:-$(date -v-1d +%Y-%m-%d)}"
NEXT_DATE=$(date -j -f "%Y-%m-%d" -v+1d "$TARGET_DATE" +%Y-%m-%d)
echo "대상 날짜: $TARGET_DATE"

Step 2: 해당 날짜 세션 로그 찾기

find ~/.claude/projects -name "*.jsonl" \
  -newermt "$TARGET_DATE 00:00:00" \
  ! -newermt "$NEXT_DATE 00:00:00" 2>/dev/null

Step 3: 세션 로그에서 학습 내용 추출

각 세션 로그에서 다음을 분석:

# 사용자 질문 추출 (학습 기회)
cat session.jsonl | jq -r '
  select(.type == "user") |
  .message.content // "" |
  select(test("뭐야|어떻게|왜|차이|What|How|Why"; "i"))
' | head -20

# 학습 키워드 포함 대화 추출
cat session.jsonl | jq -r '
  select(.type == "user" or .type == "assistant") |
  .message.content // "" |
  select(test("배웠|알게|처음|TIL|learned|discovered"; "i"))
'

Step 4: 학습 내용 분류

| 카테고리 | 설명 | 예시 | |---------|------|------| | 기술/도구 | 새 라이브러리, 프레임워크, CLI | "jq 사용법 배움" | | 개념 | 프로그래밍 개념, 패턴 | "SOLID 원칙 이해" | | 해결방법 | 에러 해결, 문제 해결 기법 | "TypeScript 타입 오류 해결" | | 팁/트릭 | 효율적인 방법, 단축키 | "vim macro 사용법" |

Step 5: 출력 형식

Daily Note 섹션용 (daily-work-logger 연동 시)

### 학습 기록

#### 기술/도구
- **jq**: JSON 파싱 CLI 도구 사용법
  - `jq -r '.field'` 형식으로 필드 추출
  - `select()` 함수로 필터링

#### 개념
- **JSONL 형식**: 줄 단위 JSON 스트리밍 형식
  - 대용량 로그 처리에 적합
  - 각 줄이 독립적인 JSON 객체

독립 실행 시 (TIL 요약)

## TIL - {TARGET_DATE}

> {TARGET_DATE}에 새로 배운 내용들

### 오늘 배운 것

1. **jq CLI 도구**
   - JSON 파싱 및 필터링 도구
   - 세션 로그 분석에 활용

2. **JSONL 형식**
   - 줄 단위 JSON 스트리밍
   - 로그 처리에 적합한 형식

daily-work-logger 서브 에이전트로 사용 시

Task 호출 파라미터

| 파라미터 | 값 | |---------|-----| | description | "학습 내용 추출" | | subagent_type | "general-purpose" | | model | "haiku" |

프롬프트 템플릿 (TARGET_DATE, NEXT_DATE 치환)

당신은 학습 내용 추출 전문가입니다. 코드를 작성하지 말고 분석만 수행하세요.

## 작업
{TARGET_DATE} 날짜의 Claude Code 세션에서 학습 관련 내용을 추출합니다.

## 경로
- Claude 세션: ~/.claude/projects/

## 학습 감지 키워드
- 한국어: 배웠, 알게, 처음, 새로운, 이해, 몰랐
- 영어: TIL, learned, discovered, first time

## 실행 단계
1. Bash로 해당 날짜 세션 로그 찾기:
   find ~/.claude/projects -name "*.jsonl" -newermt "{TARGET_DATE} 00:00:00" ! -newermt "{NEXT_DATE} 00:00:00" 2>/dev/null

2. 각 세션에서 학습 관련 대화 추출:
   - 사용자 질문 (뭐야, 어떻게, 왜, What, How, Why)
   - 학습 표현 (배웠, 알게, TIL, learned)
   - Claude의 설명/교육 내용

3. 학습 내용 분류:
   - 기술/도구: 새 라이브러리, CLI, API
   - 개념: 프로그래밍 개념, 패턴, 원칙
   - 해결방법: 에러 해결, 문제 해결 기법

## 출력 형식 (마크다운으로 반환)
### 학습 기록

#### 기술/도구
- **[도구명]**: 설명 (1줄)

#### 개념
- **[개념명]**: 설명 (1줄)

#### 해결방법
- **[문제]**: 해결 방법 요약

(학습 내용 없으면 "해당 날짜에 특별한 학습 기록 없음" 반환)

에러 처리

세션 없음: "해당 날짜에 Claude Code 세션 없음" 반환
학습 내용 없음: "특별한 학습 기록 없음" 반환
파싱 오류: 해당 세션 건너뛰고 계속 진행