2026년 9월 6일 일요일

[교과 연계] 교과서 PDF → Blooket 퀴즈 배틀 - 산과 염기·정치 발전 복습 & 메타인지 오답 정복



교과서 정리 PDF가 배틀 게임이 되는 1분 — Blooket 퀴즈 배틀 & 메타인지 오답 정복 완전 정복

⚔️ 단원 학습이 끝난 교과서 단원 정리 PDF를 제미나이 프롬프트에 넣으면 문제은행이 나오고, 그 서식(엑셀·CSV)을 Blooket에 올리면 타워 디펜스 퀴즈 배틀이 1분 만에 시작됩니다. 과학 '산과 염기', 사회 '우리나라의 정치 발전' 단원 복습 수업이 경기장처럼 바뀝니다.

배틀의 잔해(틀린 문제)가 다시 학습지가 됩니다 — 오답만 모아 오답 정복 학습지로 만들어 인쇄하면, '나는 무엇을 모르는가'를 스스로 찾는 메타인지(meta-cognition — 자기 사고를 알아보는 능력) 수업이 완성됩니다. 학생은 닉네임으로 참가하고, 오답 데이터는 로컬 문서·종이로 정리합니다.

📖 한 줄 정의

심기 모드(데이터 임베딩): API 데이터를 미리 받아 HTML 파일 안 상수로 박아두는 방식(앱 실행 중 외부 통신 0).

학내망 원칙: 학교 배포 웹앱은 개인정보 수집·저장·전송 없음(외부 CDN·API 호출 0, 단일 파일) — 학생은 학내망에서 교사 PC 서버에 접속.

1. 3대 핵심 분석 비교표

무엇이 바뀌었나요? / 영역 초보자를 위한 쉬운 설명 이렇게 한번 써보세요!
수업 워크플로 단원 마무리 → 정리 PDF 텍스트 복사 → 제미나이 문제은행 생성 → Blooket 서식 붙여넣기 → 학급 대항전 → 오답 정복 학습지. 6단계가 1차시 안에 답긴다. 오늘 수업에 바로 적용 — 워크플로 4단 순서표.
PDF → 문제은행 PDF 텍스트를 제미나이에 넣고 서식 프롬프트로 객관식 15문항 생성. 보기 균형과 정답 배분은 프롬프트 규칙이 검증한다. 아래 제미나이 전용 프롬프트 복사 → 텍스트 붙여넣기.
Blooket 서식 CSV 여섯 칸 — question, answer1, answer2, answer3, answer4, correctAnswerNum(공식 템플릿 기준). 문제은행을 이 열 구조에 맞춰 붙여넣고 업로드하면 타워 디펜스 모드로 학급 대항전 시작. 문제은행 CSV → Blooket 문제집 만들기 → 업로드 → 게임 코드 공유.
메타인지 오답 정복 배틀 결과 화면에서 틀린 문항만 추려 '오답 카드'로 — 문제·내 답·정답·한 줄 정리 네 칸으로 구성하고 짝·모둠 토크로 원인을 말로 풀어낸 뒤 형성평가 학습지로 인쇄합니다. 오답 목록 → 오답 카드 프롬프트 → 학습지 HTML 생성 → 인쇄.
원칙·정합 학생 참가는 닉네임만(이름 저장 0), 오답 데이터는 로컬 문서·종이로 정리 — 외부 플랫폼에 학생 개인정보를 두지 않는 반 규칙. 외부 플랫폼 사용은 학교·교육청 정책 기준을 따릅니다. 반 규칙 3줄(닉네임 / 로컬 정리 / 정책 확인) — 학급 회의에서 확정.

2. 핵심 아키텍처 해설 — 배틀은 어떻게 만들어지나

① 워크플로 4단 해설

1단 정리(PDF 텍스트 확보) → 2단 제미나이 문제은행 → 3단 Blooket 서식 변환·업로드 → 4단 배틀·오답 정복. 각 단의 산출물이 다음 단의 입력이 되는 파이프라인입니다 — 코드 한 줄 없이도 '데이터가 서식을 따라 흐른다'는 엔지니어링 감각을 몸으로 배웁니다.

② 제미나이 문제은행 프롬프트

[역할] 너는 초등 5~6학년 문제 출제 전문가다.
[입력] 아래는 교과서 단원 정리(PDF에서 복사한 텍스트)다.
[요구] 같은 내용으로 객관식 15문항을 만들어 아래 서식으로 출력한다:
문제,보기1,보기2,보기3,보기4,정답번호
[규칙]
1. 보기 4개의 난이도가 비슷해야 하고, '모두/모두 아니다' 같은 보기는 금지한다.
2. 산·염기는 실험 결과와 원인을 함께 묻고, 정치 발전은 변화의 순서를 묻는다.
3. 문항 간 중복이 없어야 하고, 정답번호는 1~4 중 하나다.
4. // TODO, /* 생략 */ 금지 — 끝까지 완성한다.

③ Blooket 서식 이해

Blooket은 문제집(question set)을 CSV 파일로 일괄 등록할 수 있습니다. 공식 템플릿의 열은 여섯 칸 — question(문제), answer1~answer4(보기), correctAnswerNum(정답 번호). 제미나이가 내준 '문제,보기1,보기2,보기3,보기4,정답번호' 서식과 열 순서가 정확히 같으므로, 엑셀에 붙여넣어 CSV로 저장하면 바로 업로드됩니다. 쉼표가 문장 안에 들어가면 셀이 흩어지므로, 문항 문장에서 쉼표는 ·(가운뎃점)로 바꿔 저장하는 것이 안전합니다.

④ 오답 정복 루틴

배틀이 끝나면 결과 화면의 틀린 문항 목록을 확보합니다. 여기서 두 번째 제미나이 프롬프트가 등장합니다 — 틀린 문항을 '오답 카드'로 재구성하는 것입니다. 오답 카드는 네 칸: 문제·내 답·정답·한 줄 정리. 학생이 '한 줄 정리' 칸을 직접 채우는 것이 메타인지의 핵심 동작입니다.

⑤ 원칙·정합

  • 닉네임 참가 — 게임룸 입장은 닉네임만. 실명·학번은 외부 플랫폼에 두지 않습니다(이름 저장 0).
  • 오답 데이터는 로컬 — 틀린 문항 정리는 교사 PC 문서·종이 학습지로. 외부 서비스에 학생별 기록을 영구 보관하지 않습니다.
  • 정책 확인 — 외부 플랫폼 사용은 학교·교육청 정책 기준을 따릅니다.

3. 초보자를 위한 바이브 코딩 실전 사용 예시

  1. 프롬프트 복사 — 아래 제미나이 전용 에러 제로 프롬프트를 복사해 Gemini에 붙여넣습니다.
  2. 역질문 답변 — Gemini가 묻는 문항 수·난이도·단원 범위에 답합니다.
  3. 서식 변환·배틀 — 나온 표를 엑셀에 붙여넣어 CSV 저장 → Blooket 문제집 업로드 → 게임 코드로 학급 대항전.

제미나이 전용 에러 제로 프롬프트

[🚨 에러 방지 기본 안전장치]
1. 산출물은 표 형태(문제,보기1,보기2,보기3,보기4,정답번호)로만 출력한다 — HTML 코드가 아니라 문제은행 데이터다.
2. 문장 안의 쉼표는 가운뎃점(·)으로 바꾸어 CSV 셀이 흩어지지 않게 한다.
3. 정답번호는 반드시 1~4 사이의 숫자 하나다. 보기 안에 정답이 중복되거나 비어 있으면 안 된다.
4. 문항은 단원 정리 내용 안에 근거가 있는 것만 — 교과서에 없는 지식을 갖다 붙이지 않는다.
5. 오답 카드 모드가 요청되면 문제·내 답(빈칸)·정답·한 줄 정리(빈칸) 네 칸 표로 출력한다.
6. // TODO, /* 생략 */ 금지 — 끝까지 완성한다.

[❓ 역질문 유도]
코드를 바로 만들지 말고, 아래 3가지를 먼저 나에게 질문한 뒤 내 답변으로 설계를 확정한다.
Q1. 문항 수와 난이도는? (기본: 15문항, 보기 4개)
Q2. 오답 카드 학습지 모드도 지금 함께 만들까? (기본: 함께)
Q3. 학습지 인쇄용 HTML이 필요하면 같이 줄까? (기본: 준다 — 단일 HTML, 인쇄 CSS 포함)

🎯 에디터 한줄평

'복습 시간'이 '배틀 시간'이 되고, 배틀의 잔해(틀린 문제)가 다시 학습지로 돌아옵니다 — 경쟁과 성찰의 순환이 곧 메타인지입니다. 이 워크플로의 진짜 미덕은 문제은행의 재사용성입니다. 한 번 만든 서식은 다음 학기에도 그대로 살아 있고, 오답 카드는 학생마다 다르게 열리는 개인 정복 지도가 됩니다. '오답이 사라져야 수업이 끝난다'는 문화가 반에 자리 잡히면, 배틀은 놀이가 아니라 진단이 됩니다.

📚 기술·교육 참고 링크

  • Blooket 공식 사이트 — 퀴즈 배틀 플랫폼(이 글 검증 시점 브라우저 접속 200 OK 실측)
  • 에이스 퀴즈 랩 등 국내 퀴즈 도구 — 도구명으로 검색해 공식 사이트에서 최신 주소와 엑셀 서식을 반드시 확인하세요(이 글 검증 시점에는 주소를 확인하지 못했습니다 — 정확한 도구명으로 직접 확인이 안전합니다).
  • 교육과정 연계: 과학(산과 염기 — 실험 결과·원인 문항), 사회(우리나라의 정치 발전 — 변화 순서 문항), 실과·정보(문제은행 서식 변환)와 함께 활용
By 시간: