| name | learning-tracker |
| description | Use when user says "learning summary", "what I learned today", "오늘 뭐 배웠지", "session summary", "학습 정리", or wants to extract learnings from current session. Do NOT use for session handoff (use session-handoff), development work logs (use devlog), or direct TIL/note creation (use til or obsidian-note). |
Learning Tracker Skill
Claude Code 세션에서 새로운 기술, 라이브러리, 개념에 대한 학습 내용을 추출하여 TIL 형식으로 정리합니다.
사용법
/learning-tracker
/learning-tracker "주제"
Instructions
Step 1: 세션 로그 분석
현재 대화 세션에서 다음 패턴을 찾습니다:
학습 감지 패턴
한국어 키워드:
| 패턴 | 설명 |
|---|
| "배웠", "배워" | 학습 완료 표현 |
| "알게 됐", "알았" | 새로운 이해 |
| "처음", "처음으로" | 최초 경험 |
| "새로운", "새롭게" | 새로운 지식 |
| "이해했", "이해됐" | 개념 이해 |
| "몰랐던", "몰랐는데" | 기존 무지 인정 |
| "이렇게 하는구나" | 방법 습득 |
영어 키워드:
| 패턴 | 설명 |
|---|
| "TIL", "Today I learned" | 명시적 학습 표현 |
| "learned", "discovered" | 학습/발견 |
| "didn't know", "now I know" | 새로운 지식 |
| "first time" | 최초 경험 |
질문 패턴 (사용자 질문 → 학습 기회):
| 패턴 | 설명 |
|---|
| "이게 뭐야?", "이게 뭔가요?" | 개념 질문 |
| "어떻게 해?", "어떻게 하나요?" | 방법 질문 |
| "왜?", "왜 그런가요?" | 이유 질문 |
| "차이가 뭐야?" | 비교 질문 |
기술 학습 지표:
| 지표 | 설명 |
|---|
| 새 라이브러리 import | 처음 사용하는 패키지 |
| 새 CLI 도구 사용 | 처음 사용하는 명령어 |
| API 문서 참조 | WebFetch로 공식 문서 조회 |
| 에러 해결 후 설명 | 문제 해결 과정에서 학습 |
| 코드 설명 요청 | "이 코드가 뭐야?" |
Step 2: 학습 내용 분류
추출한 내용을 카테고리별로 분류합니다:
| 카테고리 | 키워드/패턴 |
|---|
python | Python, pip, pytest, FastAPI, Django, pandas |
java | Java, Spring, Maven, Gradle, JUnit |
spring | Spring Boot, Spring Security, JPA |
nodejs | Node.js, npm, Express, libuv |
ai | LangChain, LangGraph, OpenAI, LLM, embedding |
security | 보안, 암호화, 인증, OAuth, JWT |
computer-science | 알고리즘, 자료구조, 동시성, 병렬성 |
database | SQL, PostgreSQL, MySQL, Redis |
devops | Docker, Kubernetes, CI/CD, GitHub Actions |
Step 3: 학습 내용 요약 생성
추출한 학습 내용을 구조화하여 정리합니다 (저장용 포맷은 각 스킬이 담당):
주제: [학습 주제]
카테고리: [python, java, spring, ai, etc.]
한줄요약: [핵심 내용 1문장]
학습_포인트:
- [핵심 개념 1]: [설명]
- [핵심 개념 2]: [설명]
코드_예시: |
[세션에서 작성/참조한 코드]
배경: [왜 이걸 배우게 됐는지]
출처: [참조한 문서/링크]
참고: 이 요약은 /til 스킬에 전달되며, 최종 포맷은 해당 스킬이 적용합니다.
Step 4: 사용자 확인
생성된 초안을 사용자에게 보여주고 확인 요청:
📚 학습 내용 추출 완료!
**감지된 학습 주제:**
1. [주제 1] - python 카테고리
2. [주제 2] - spring 카테고리
**TIL로 저장할까요?**
→ `/til` 스킬 호출
Step 5: 저장 (다른 스킬에 위임)
사용자 선택에 따라 해당 스킬을 호출하여 저장을 위임:
| 선택 | 호출 스킬 | 전달 내용 |
|---|
| TIL 문서 | /til | 추출된 주제, 카테고리, 학습 내용 요약 |
중요: learning-tracker는 직접 파일을 저장하지 않음. 포맷과 저장 규칙은 /til 스킬이 담당.
자동 추출 예시
예시 1: 라이브러리 사용
세션 대화:
사용자: httpx로 비동기 요청 어떻게 해?
Claude: httpx.AsyncClient를 사용하면 됩니다...
추출 결과:
# Python httpx로 비동기 HTTP 요청하기
## 결론부터 말하면
httpx는 requests와 유사한 API를 제공하면서 async/await를 지원하는 HTTP 클라이언트다.
`AsyncClient`를 context manager로 사용하면 connection pooling까지 자동 관리된다.
예시 2: 개념 이해
세션 대화:
사용자: 왜 Spring에서 @Transactional이 private 메서드에서 안 먹어?
Claude: Spring AOP는 프록시 기반이라서...
추출 결과:
# Spring @Transactional이 private 메서드에서 작동하지 않는 이유
## 결론부터 말하면
Spring의 @Transactional은 프록시 기반 AOP로 동작한다.
private 메서드는 프록시가 가로챌 수 없어서 트랜잭션이 적용되지 않는다.
예시 3: 문제 해결
세션 대화:
사용자: pytest에서 fixture 스코프가 뭐야?
Claude: fixture의 생명주기를 결정합니다. function, class, module, session...
추출 결과:
# pytest fixture scope 이해하기
## 결론부터 말하면
fixture scope는 fixture 인스턴스의 생명주기를 결정한다.
function(기본값)은 매 테스트마다, session은 전체 테스트 실행 중 한 번만 생성된다.
워크플로우
learning-tracker는 추출 전용 스킬로, 저장은 다른 스킬에 위임:
/learning-tracker
↓
세션 분석 & 학습 내용 추출
↓
사용자에게 추출 결과 확인
↓
TIL 저장
└─ TIL 문서 → /til 스킬 호출 → ~/dev/TIL/{category}/
핵심 원칙: 포맷/저장 규칙은 /til 스킬이 담당. learning-tracker는 추출만 수행.
주의사항
- learning-tracker는 추출만 수행. 파일 저장은
/til 스킬이 담당
- 민감한 정보(API 키, 비밀번호 등)가 포함된 내용은 추출에서 제외
- 저장 관련 규칙(파일명, 경로, git 작업 등)은 각 스킬의 지침을 따름
