ten-builder/study-quiz

study-quiz

StudyVault에서 대화형 퀴즈를 출제하고 숙달도를 추적합니다. 텐빌더 학습 스킬 — https://github.com/ten-builder/ten-builder

실행 조건

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

• /study-quiz
• "퀴즈 풀래"
• "학습 테스트"
• "복습하자"

입력

| 항목 | 필수 | 설명 | |------|------|------| | StudyVault 경로 | ✅ | /study-vault으로 생성한 볼트 폴더 | | 토픽 선택 | 선택 | 특정 토픽만 풀기 (미지정 시 약한 토픽 자동 선택) | | 문제 수 | 선택 | 기본 4문제 |

워크플로우 (4단계)

1단계: 감지

- [ ] StudyVault 폴더 존재 확인
- [ ] Dashboard에서 숙달도 현황 읽기
- [ ] 토픽별 연습문제 파일 확인

토픽 자동 선택 우선순위:

| 순위 | 조건 | 이유 | |------|------|------| | 1 | 🔴 미학습 토픽 | 아직 한 번도 안 풀었음 | | 2 | 🟡 학습중 토픽 | 정답률이 낮아 보강 필요 | | 3 | 🟢 이해함 토픽 | 숙달까지 한 단계 남음 | | 4 | 🔵 숙달 토픽 | 유지 복습 |

2단계: 출제

연습문제 파일에서 문제를 선택하여 대화형으로 출제합니다.

출제 형식:

📝 [{토픽명}] Q{번호} / {전체}

{문제 내용}

A) {선택지}
B) {선택지}
C) {선택지}
D) {선택지}

정답을 입력하세요 (A/B/C/D):

- [ ] 선택된 토픽에서 문제 추출
- [ ] 이전에 맞힌 문제는 제외 (가능한 경우)
- [ ] 한 문제씩 순서대로 출제
- [ ] 사용자 답변 대기

출제 정책: references/quiz-policy.md 참조

3단계: 채점

사용자가 답변하면 즉시 피드백합니다:

정답일 때:

✅ 정답! {간단한 보충 설명}

오답일 때:

❌ 오답 — 정답은 {X})입니다.

💡 {해설 — 왜 이것이 정답인지}
📌 {오답을 고른 이유와 흔한 실수 설명}

- [ ] 정답/오답 즉시 판정
- [ ] 해설 제공 (오답 시 상세, 정답 시 간략)
- [ ] 다음 문제로 자동 진행
- [ ] 마지막 문제 후 결과 요약

4단계: 업데이트

퀴즈 완료 후 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% 미만이면 학습중(🟡)으로 하향

출력 언어

• 기본: 한국어
• 사용자 언어를 자동 감지하여 맞춤 (한/영/일)
• 문제 원문이 영어여도 해설은 사용자 언어로 제공

대화 규칙

1. 한 번에 한 문제만 — 여러 문제를 한꺼번에 출제하지 않음
2. 답변 대기 — 문제 출제 후 반드시 사용자 입력을 기다림
3. 격려하되 과하지 않게 — "잘했어요!" 수준, 과도한 칭찬 금지
4. 힌트 제공 금지 — 문제 자체에서 정답 유추 불가해야 함

다음 단계

모든 토픽이 🟢 이상이면:

🎉 모든 토픽을 이해했어요!

🔵 숙달 도전: 80% 이상을 목표로 다시 풀어보세요.
⭐ 완벽 도전: 같은 토픽에서 2회 연속 100%를 달성하세요.