퀴즈 메이커은(는) 무엇을 하나요?
좋은 퀴즈는 두 가지 일을 동시에 합니다: 학습자가 무엇을 알고 있는지 테스트하고, 틀렸을 때 바로 가르쳐줍니다. 대부분의 자동 생성 퀴즈는 첫 번째 기능만 수행합니다 — 간단한 질문, 정답, 그리고 학습자가 왜 틀렸는지 이해하도록 돕는 것은 없습니다. 이 스킬은 두 번째 기능을 잘 수행하기 위해 존재합니다. 모든 질문에는 학습자가 실제로 따라갈 수 있는 단순화된 설명, 정량적 주제의 경우 그 뒤에 있는 방정식 또는 유도 과정, 그리고 더 깊이 파고들고 답을 신뢰할 수 있도록 실제 인용문이 포함됩니다.
출력물은 사용자가 브라우저에서 열고, 자신의 속도로 답하고, 스스로 확인하고, 작업된 유도 과정을 펼쳐 보고, 점수를 매길 수 있는 단일 대화형 HTML 파일입니다. 잘 만들어진 학습 도구처럼 느껴져야 하며, 단순한 인쇄물처럼 느껴져서는 안 됩니다.
무엇보다 먼저 지켜야 할 규칙: 만들기 전에 난이도를 물어보세요
난이도는 퀴즈의 모든 것을 바꿉니다 — 어휘, 유도 과정을 보여줄지 아니면 단순히 결과만 말할지, 문제의 단계 수, 독자가 이미 알고 있다고 가정하는 수준 등. 따라서 수준을 알기 전까지는 단 하나의 좋은 질문도 작성할 수 없습니다. 퀴즈를 생성하기 전에 사용자가 원하는 수준을 물어보세요, AskUserQuestion 도구를 사용하여 다음 다섯 가지 옵션을 제시하십시오:
- 기초(Foundational) — 첫 노출. 평이한 언어, 구체적인 예, 최소한의 전문 용어, 유도 과정 없이 결과만 제시. 호기심 많은 초보자 또는 초기 고등학생 수준을 생각하면 됩니다.
- 중급(Intermediate) — 기본에 익숙함. 표준 용어와 간단한 1~2단계 추론을 도입. 강한 고등학생 또는 초기 학부생 수준을 생각하면 됩니다.
- 고급(Advanced) — 탄탄한 실무 지식. 다단계 문제, 핵심 형식에 능숙함 기대, 짧은 유도 과정 제시. 학부 고학년 수준을 생각하면 됩니다.
- 전문가(Expert) — 깊은 이해. 명확하지 않은 예외 사례, 아이디어 간의 연결, 완전한 유도 과정 기대. 대학원 수준을 생각하면 됩니다.
- 박사/연구(PhD/Research) — 최전선. 미묘한 가정, 현재의 논쟁, 엄격한 유도 과정, 일차 문헌 인용. 자격 시험 또는 연구 세미나 수준을 생각하면 됩니다.
사용자가 메시지에서 이미 수준을 언급했다면 ("저에게 어려운 박사 수준 퀴즈를 만들어 주세요..."), 가장 가까운 옵션에 매핑하고 다시 묻지 않고 확인하십시오. 난이도를 묻는 동안, 같은 AskUserQuestion 호출에서 주제(모호한 경우)와 원하는 질문 수(기본값 8개)도 함께 확인하는 것이 효율적입니다 — 하지만 난이도는 절대 건너뛰어서는 안 되는 것입니다.
주제를 정확히 파악하세요
묻기 전에 상황을 읽으십시오. 주제는 이미 사용자의 메시지, 프로젝트 지침, 폴더 내 파일 또는 지금까지의 대화에서 분명할 수 있습니다. 사용자가 전문 분야에서 일하는 경우 (프로필이나 CLAUDE.md에 종종 명시됨), 일반적인 예시 대신 해당 분야의 예시를 제시하십시오 — 물리학자에게는 "언덕을 굴러 내려가는 공"이 아니라 반물질과 충돌 단면적을 예시로 들어야 합니다. 물론 그들이 공에 대해 물어본 경우는 예외입니다. 주제가 진정으로 모호하거나 일관된 퀴즈를 만들기에는 너무 광범위할 때만 명확히 묻도록 하십시오 ("과학"은 너무 광범위합니다; "특수 상대성 이론 — 시간 지연과 길이 수축"은 퀴즈 주제입니다).
조사하고 인용하세요 — 절대 지어내지 마세요
모든 설명에는 인용문이 있으며, 그 인용문은 실제여야 합니다. 이것이 신뢰할 수 있는 학습 도구와 그럴듯해 보이는 환각의 차이입니다.
기술적, 과학적, 의학적, 역사적 또는 빠르게 변화하는 주제의 경우, 설명의 근거를 마련하고 검증 가능한 출처를 확보하기 위해 웹을 검색하십시오 — 판과 장이 있는 교과서, DOI가 있는 리뷰 논문, 표준 기관, 평판 좋은 참고 사이트. 블로그보다는 일차적이고 권위 있는 출처를 선호하십시오. 인용문이 연결될 수 있도록 실제 URL 또는 DOI를 포착하십시오.
안정적이고 일반 상식 주제의 경우 (기초 산술, 잘 정립된 정의) 높은 확신을 가지고 있다면 라이브 검색 없이 지식에서 표준 참고문헌을 인용해도 괜찮습니다 — 하지만 구체적이고 확인 가능한 출처를 명시하십시오 (예: "Griffiths, Introduction to Electrodynamics, 4판, §2.3"), 막연한 "교과서"나 지어낸 페이지 번호는 안 됩니다.
주장에 대한 실제 출처를 찾을 수 없다면, 그 주장이 불안정할 수 있다는 신호입니다 — 인용문을 지어내기보다는 출처를 찾을 수 있는 내용을 중심으로 질문을 바꾸십시오. 인용문을 위조하는 것은 인용문이 없는 것보다 더 나쁩니다.
질문을 작성하세요
단순한 암기가 아닌 실제 이해를 테스트하는 혼합을 목표로 하십시오. 좋은 퀴즈는 학습자가 아이디어를 적용하도록 만드는 질문에 중점을 둡니다. 형식을 다양화하십시오:
- 객관식은 기본입니다 — 자동 채점이 가능하며, 오답은 가르칠 기회를 제공합니다. 오답 선택지를 그럴듯하게 만드십시오: 각 오답은 특정하고 흔한 실수나 오해에 대응해야 하며, 선택함으로써 학습자에게 무언가를 알려줍니다. 가벼운 농담 선택지나 명백히 틀린 선택지는 피하십시오.
- 숫자 / 단답형 질문은 정량적 주제에 적합합니다 — 학습자가 직접 풀고 작업된 해법과 함께 답을 확인합니다.
- 서술형 / 유도 질문은 학습자가 추론하거나 유도하도록 요청한 후, 스스로 평가할 모범 답안을 공개합니다. 높은 난이도에서 사용하십시오.
각 질문에 대해 다음을 작성하십시오:
- 명확한 프롬프트. 모든 수학에 LaTeX를 사용하십시오 (형식 섹션 참조) — 인라인
\( ... \)또는 디스플레이\[ ... \]. - 정답에 대한 단순화된 설명 — 스킬의 핵심입니다. 선택된 수준에 맞는 좋은 튜터가 설명하는 방식으로 설명하십시오: 평이하고 직접적이며, 이미 알고 있는 내용을 바탕으로 합니다. 언어를 단순화하되, 정확성은 단순화하지 마십시오.
- 정량적인 경우, 유도 과정: 첫 번째 원리에서 결과까지의 순서가 정리된 단계 목록, 각 단계는 짧은 추론 라인과 방정식으로 구성됩니다. HTML은 학습자가 엿보기 전에 시도해 볼 수 있도록 한 번에 하나씩 블록을 공개합니다.
- 하나 이상의 인용문, 각각 레이블과 (이상적으로는) URL/DOI가 포함됩니다.
난이도에 맞게 깊이를 조정하십시오: 기초 수준에서는 유도 과정을 생략하고 직관적인 비유를 제공할 수 있습니다; 박사 수준에서는 유도 과정이 엄격하고 인용문은 일차 출처입니다.
대화형 HTML 구축
매번 페이지를 직접 만드는 대신 번들된 템플릿을 사용하십시오 — 이미 MathJax 렌더링, 답변 확인, 점수 유지, 진행 상황, 접을 수 있는 유도 과정 및 인용 링크를 처리하며 깔끔하게 보입니다. references/html-format.md를 읽어 전체 빌드 절차와 정확한 QUIZ 데이터 스키마를 확인한 다음, 템플릿의 데이터 블록을 질문으로 채우십시오. 처음부터 템플릿의 CSS/JS를 다시 작성하지 마십시오; 내용만 제공하면 됩니다.
완성된 페이지는 학습자가 다음을 할 수 있어야 합니다: 방정식이 제대로 렌더링된 질문 읽기, 답 선택 또는 공개, 즉각적인 정답/오답 피드백 받기, 설명과 단계별 유도 과정 펼쳐보기, 인용 링크 따라가기, 그리고 끝에 요약과 함께 진행 점수 확인. 상단에는 난이도 배지가 있어 자신이 무엇을 하고 있는지 알 수 있습니다.
전달
완성된 퀴즈를 사용자가 선호하는 스킬 출력 폴더(프로젝트/메모리 규칙에 따라)에 단일 .html 파일로 저장하고, 설명적인 이름(quiz-<topic>-<difficulty>.html)을 지정한 후 사용자에게 제시하여 직접 열 수 있도록 하십시오. 마무리 메시지는 짧게 유지하십시오 — 퀴즈가 스스로 말해줍니다. 난이도 조정, 질문 추가 또는 주제 범위 축소를 자연스러운 후속 조치로 제안하십시오.
가정 사항 표시
정확성에 영향을 미치는 판단을 내려야 했다면 — 규칙(부호, 단위, 표기법)을 가정했거나, 실제로 논쟁이 있는 주제의 한쪽을 선택했거나, 출처를 완전히 확인할 수 없었다면 — 퀴즈를 전달할 때 간략히 언급하여 사용자가 검증할 수 있도록 하십시오. 학습 도구에서의 암묵적 가정은 학습자가 배우는 내용으로 전파됩니다.