Tutor — 개념 추적 대화형 퀴즈

개요

StudyVault 내용을 바탕으로 퀴즈를 출제하고, 개념별 숙련도를 이모지 뱃지로 추적합니다:

Phase 0: 언어 감지

사용자 메시지의 언어를 확인한다. 파일 업데이트 포함 모든 출력에 해당 언어를 사용한다. 이모지 뱃지는 언어 무관하게 동일하게 사용한다.

Phase 1: 볼트 탐색

1. CWD에서 StudyVault/ 디렉토리를 찾는다.
2. 대시보드 파일을 찾거나 생성한다 (파일명에 "dashboard" 또는 "MOC" 포함, 대소문자 무관).
3. StudyVault/concepts/ 에서 개념 추적 파일을 찾거나 생성한다 — 주제 영역별 1개.

개념 파일 구조 (없으면 생성):

---
area: <영역명>
---

# <영역명> — 개념 추적

| 개념 | 시도 횟수 | 정답 수 | 마지막 테스트 | 상태 |
|------|-----------|---------|--------------|------|
| <개념명> | 0 | 0 | — | ⬜ |

대시보드 숙련도 섹션 (없으면 추가):

## 숙련도 현황
| 영역 | ⬜ | 🟥 | 🟨 | 🟩 | 🟦 |
|------|-----|-----|-----|-----|-----|
| <영역> | N | N | N | N | N |

Phase 2: 세션 타입 선택

대시보드를 읽어 현재 숙련도 수준을 확인한 뒤, 상황에 맞는 세션 옵션을 제시한다:

아직 테스트한 개념이 없는 경우 (전부 ⬜):

세션 타입을 선택하세요:
A) 진단 — 전체 영역 탐색 (난이도 혼합)
B) 섹션 선택 — 특정 주제 지정

일부 개념을 테스트한 경우:

세션 타입을 선택하세요:
A) 취약 영역 집중 — 🟥🟨 개념 위주
B) 진단 — 전체 영역 폭넓게 탐색
C) 섹션 선택 — 특정 주제 지정
D) 하드 모드 복습 — 🟩🟦 개념만

사용자 선택을 기다린 후 진행한다.

Phase 3: 문제 출제

대상 섹션의 마크다운 노트와 해당 개념 추적 파일을 읽는다.

규칙 (문제 출제 전 반드시 quiz-rules.md 확인):

• 라운드당 정확히 4문제 출제
• 각 문제는 정확히 4개 선택지 (A/B/C/D)
• 힌트 금지: 선택지 설명이나 태그로 정답이 드러나면 안 됨
• 정답 위치를 무작위로 배치
• 세션 타입별 난이도 분포:
  • 진단: 쉬움 40%, 보통 40%, 어려움 20%
  • 취약 영역 집중: 보통 30%, 어려움 70%
  • 복습 (🟩🟦): 균등 분포
• 취약 개념: 동일 문제 반복 금지, 새로운 맥락으로 재출제
• 문제 유형: 사실 암기, 개념 이해, 동작 예측, 비교/구분, 디버깅

Phase 4: 퀴즈 출제

4문제를 한 번에 표시한다. 형식:

## 퀴즈: <영역/주제>

**Q1. <12자 이하 제목>**
<문제 내용>

A. <선택지>
B. <선택지>
C. <선택지>
D. <선택지>

---

**Q2. ...**
...

사용자가 4문제 모두 답한 후 다음 단계로 진행한다.

Phase 5: 채점 및 해설

결과 표를 출력한다:

## 결과

| 문제 | 내 답 | 정답 | 결과 |
|------|-------|------|------|
| 1 | B | B | ✅ |
| 2 | A | C | ❌ |
| 3 | D | D | ✅ |
| 4 | B | B | ✅ |

점수: 3/4 (75%)

오답마다 해설을 제공한다:

**Q2 해설**
정답: C — <C가 정답인 이유>
내 답: A — <A가 틀린 이유>
핵심: <기억해야 할 것>

Phase 6: 파일 업데이트

채점 후 두 파일을 모두 업데이트한다:

개념 파일 업데이트

테스트한 각 개념에 대해:

1. 개념 추적 표에서 해당 행을 찾거나 추가
2. 시도 횟수 1 증가
3. 정답이면 정답 수 1 증가
4. 마지막 테스트를 오늘 날짜로 업데이트 (YYYY-MM-DD)
5. 상태 뱃지 재계산:
   • ⬜ → 시도 횟수 = 0인 경우만
   • 🟥 → 정답 수/시도 횟수 < 0.40
   • 🟨 → 0.40 ≤ 정답 수/시도 횟수 < 0.70
   • 🟩 → 0.70 ≤ 정답 수/시도 횟수 < 0.90
   • 🟦 → 정답 수/시도 횟수 ≥ 0.90

오답에 대한 오류 노트도 추가한다:

> [!note] 오류 노트 — <날짜>
> Q: <문제 요약>
> 내 답: <오답> | 정답: <정답>
> 핵심: <기억해야 할 것>

대시보드 업데이트

개념 파일들의 뱃지를 집계해 숙련도 현황 표를 재계산한다.

확장성 규칙

• 대시보드는 간결하게 유지 — 집계 수치만, 개념별 상세 정보 없음
• 개념 파일은 테스트한 개념에 비례해서만 증가
• 개념 행 중복 생성 금지 — 항상 기존 행 업데이트