StudyVault 기반 대화형 퀴즈 + 숙달도 추적
StudyVault에서 대화형 퀴즈를 출제하고 숙달도를 추적합니다. 텐빌더 학습 스킬 — https://github.com/ten-builder/ten-builder
사용자가 다음 중 하나를 요청하면 이 스킬을 실행합니다:
/study-quiz| 항목 | 필수 | 설명 |
|---|---|---|
| StudyVault 경로 | ✅ | /study-vault으로 생성한 볼트 폴더 |
| 토픽 선택 | 선택 | 특정 토픽만 풀기 (미지정 시 약한 토픽 자동 선택) |
| 문제 수 | 선택 | 기본 4문제 |
- [ ] StudyVault 폴더 존재 확인
- [ ] Dashboard에서 숙달도 현황 읽기
- [ ] 토픽별 연습문제 파일 확인
토픽 자동 선택 우선순위:
| 순위 | 조건 | 이유 |
|---|---|---|
| 1 | 🔴 미학습 토픽 | 아직 한 번도 안 풀었음 |
| 2 | 🟡 학습중 토픽 | 정답률이 낮아 보강 필요 |
| 3 | 🟢 이해함 토픽 | 숙달까지 한 단계 남음 |
| 4 | 🔵 숙달 토픽 | 유지 복습 |
연습문제 파일에서 문제를 선택하여 대화형으로 출제합니다.
출제 형식:
📝 [{토픽명}] Q{번호} / {전체}
{문제 내용}
A) {선택지}
B) {선택지}
C) {선택지}
D) {선택지}
정답을 입력하세요 (A/B/C/D):
- [ ] 선택된 토픽에서 문제 추출
- [ ] 이전에 맞힌 문제는 제외 (가능한 경우)
- [ ] 한 문제씩 순서대로 출제
- [ ] 사용자 답변 대기
출제 정책: references/quiz-policy.md 참조
사용자가 답변하면 즉시 피드백합니다:
정답일 때:
✅ 정답! {간단한 보충 설명}
오답일 때:
❌ 오답 — 정답은 {X})입니다.
💡 {해설 — 왜 이것이 정답인지}
📌 {오답을 고른 이유와 흔한 실수 설명}
- [ ] 정답/오답 즉시 판정
- [ ] 해설 제공 (오답 시 상세, 정답 시 간략)
- [ ] 다음 문제로 자동 진행
- [ ] 마지막 문제 후 결과 요약
퀴즈 완료 후 Dashboard 숙달도를 갱신합니다:
- [ ] 정답률 계산
- [ ] 숙달도 배지 업데이트 (Dashboard 테이블의 숙달도 열 수정)
- [ ] 최근 학습 날짜 갱신 (Dashboard 테이블의 최근 학습 열)
- [ ] 결과 요약 출력
Dashboard 갱신 방법:
00-Dashboard.md의 학습 현황 테이블에서 해당 토픽 행을 직접 수정합니다:
# 변경 전
| 1 | [[01-VPC/개념노트|VPC]] | 🔴 | 8 | - |
# 변경 후 (예: 75% 정답률)
| 1 | [[01-VPC/개념노트|VPC]] | 🟢 | 8 | 2026-03-06 |
결과 요약 형식:
📊 퀴즈 결과 — {토픽명}
정답: {N}/{M} ({퍼센트}%)
숙달도: {이전 배지} → {새 배지}
{약한 부분에 대한 학습 조언}
🔄 다시 풀기: /study-quiz
📚 다른 토픽: /study-quiz {다른토픽}
| 배지 | 레이블 | 정답률 | 갱신 조건 |
|---|---|---|---|
| 🔴 | 미학습 | - | 퀴즈 미실행 |
| 🟡 | 학습중 | ~49% | 최근 퀴즈 기준 |
| 🟢 | 이해함 | 50~79% | 최근 퀴즈 기준 |
| 🔵 | 숙달 | 80~99% | 최근 퀴즈 기준 |
| ⭐ | 완벽 | 100% | 2회 연속 만점 |
하향 가능: 숙달(🔵) 상태에서 다시 풀어 50% 미만이면 학습중(🟡)으로 하향
모든 토픽이 🟢 이상이면:
🎉 모든 토픽을 이해했어요!
🔵 숙달 도전: 80% 이상을 목표로 다시 풀어보세요.
⭐ 완벽 도전: 같은 토픽에서 2회 연속 100%를 달성하세요.