learning-tracker

name	learning-tracker
description	세션에서 새로운 기술/라이브러리/개념 학습 내용을 추출하여 TIL(Today I Learned) 문서로 정리. 독립 실행 또는 daily-work-logger의 서브 에이전트로 호출 가능. "학습 정리", "TIL", "오늘 배운 것", "learning" 등의 요청 시 자동 적용.

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 출력	~/OneDrive/my-obsidian-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 세션 없음" 반환
• 학습 내용 없음: "특별한 학습 기록 없음" 반환
• 파싱 오류: 해당 세션 건너뛰고 계속 진행

---

관련 Skill

• daily-work-logger: 일일 작업 로그 (이 skill의 호출자)
• weekly-claude-analytics: 주간 사용 분석
• obsidian-vault: vault 작업 기본 가이드