lee6147/study-vault

study-vault

교재나 PDF를 Obsidian 학습 노트로 자동 변환합니다. 텐빌더 학습 스킬 — https://github.com/ten-builder/ten-builder

실행 조건

사용자가 다음 중 하나를 요청하면 이 스킬을 실행합니다:

• /study-vault
• "학습 노트 만들어줘"
• "이 PDF를 정리해줘"
• "스터디볼트 생성"

입력

사용자로부터 다음을 확인합니다:

| 항목 | 필수 | 설명 | |------|------|------| | 학습 자료 | ✅ | PDF 파일 경로 또는 텍스트 문서 | | 출력 폴더 | ✅ | StudyVault가 생성될 디렉토리 | | 과목명 | ✅ | 볼트 이름 (예: "AWS-SAA", "React-심화") |

워크플로우

아래 단계를 순서대로 실행합니다. 각 단계 완료 후 체크리스트를 확인합니다.

1단계: 자료 분석

- [ ] 학습 자료 존재 확인 (파일 경로 유효성)
- [ ] PDF인 경우 pdftotext 설치 확인 (없으면 안내 후 중단)
- [ ] PDF인 경우 pdftotext로 텍스트 추출
- [ ] 텍스트 파일인 경우 직접 읽기
- [ ] 전체 분량 파악 (페이지 수, 예상 토픽 수)
- [ ] 핵심 주제 목록 추출 (최소 5개)

PDF 텍스트 추출:

# pdftotext 존재 확인 (없으면 설치 안내)
which pdftotext || echo "pdftotext가 필요합니다: brew install poppler (macOS) / apt install poppler-utils (Linux)"

pdftotext "파일경로.pdf" -

주의: PDF 파일을 직접 읽지 마세요. 반드시 pdftotext CLI를 사용합니다. 토큰 비용을 최소화하면서 정확한 텍스트를 얻을 수 있습니다. 텍스트 파일(.md, .txt 등)은 pdftotext 없이 직접 읽습니다.

분석 결과물: | 항목 | 내용 | |------|------| | 총 페이지 | N페이지 | | 추출 토픽 | 토픽1, 토픽2, ... | | 난이도 | 입문 / 중급 / 심화 |

2단계: 볼트 구조 생성

출력 폴더에 아래 구조를 생성합니다:

{과목명}-StudyVault/
├── 00-Dashboard.md          ← 전체 학습 현황 MOC
├── 00-빠른참조.md            ← 핵심 개념 원페이저
├── 01-{토픽1}/
│   ├── 개념노트.md
│   └── 연습문제.md
├── 02-{토픽2}/
│   ├── 개념노트.md
│   └── 연습문제.md
└── ...

- [ ] 출력 폴더 생성
- [ ] Dashboard MOC 파일 생성
- [ ] 빠른참조 파일 생성
- [ ] 토픽별 폴더 생성 (번호 접두사)

템플릿 참조: references/vault-templates.md

3단계: 개념 노트 작성

각 토픽 폴더에 개념노트.md를 생성합니다.

- [ ] 각 토픽별 핵심 개념 3-5개 정리
- [ ] Obsidian 위키링크([[]])로 관련 개념 연결
- [ ] 실무 활용 예시 1개 이상 포함
- [ ] 시험에 자주 나오는 함정 포인트 표시 (있는 경우)

4단계: 연습 문제 생성

각 토픽 폴더에 연습문제.md를 생성합니다.

- [ ] 토픽당 최소 8문제 생성
- [ ] 4지선다 형식 (정답 위치 랜덤)
- [ ] 난이도 배분: 기본 40% / 응용 40% / 심화 20%
- [ ] 각 문제에 해설 포함 (접기 블록)

퀴즈 규칙은 study-quiz 스킬의 references/quiz-policy.md를 참조합니다.

5단계: Dashboard 완성

- [ ] 전체 토픽 목록을 Dashboard에 반영
- [ ] 각 토픽에 숙달도 배지 초기화 (🔴 미학습)
- [ ] 빠른참조에 핵심 용어/공식 정리
- [ ] 위키링크 연결 검증

6단계: 품질 검증

references/quality-check.md 체크리스트를 실행합니다.

- [ ] 모든 토픽에 개념노트 + 연습문제 존재
- [ ] 토픽당 8문제 이상
- [ ] 위키링크 깨진 링크 없음
- [ ] Dashboard에 모든 토픽 표시
- [ ] 빠른참조 완성

숙달도 배지

| 배지 | 의미 | 조건 | |------|------|------| | 🔴 | 미학습 | 아직 퀴즈를 풀지 않음 | | 🟡 | 학습중 | 정답률 50% 미만 | | 🟢 | 이해함 | 정답률 50-79% | | 🔵 | 숙달 | 정답률 80% 이상 | | ⭐ | 완벽 | 정답률 100% (2회 이상) |

출력 언어

• 기본: 한국어
• 사용자가 영어 자료를 제공하더라도, 노트와 문제는 한국어로 작성
• 사용자가 영어 출력을 요청하면 영어로 전환

제한 사항

• 현재 작업 디렉토리 내에서만 파일 생성 (외부 경로 접근 금지)
• PDF 직접 읽기 금지 — pdftotext CLI만 사용
• 한 번에 최대 10개 토픽까지 처리 (초과 시 분할)

다음 단계

볼트 생성 후 사용자에게 안내합니다:

✅ StudyVault 생성 완료!

📂 {과목명}-StudyVault/
   - {N}개 토픽, {M}개 연습문제

🎯 다음 단계: /study-quiz 를 실행하면 대화형 퀴즈로 학습할 수 있어요.