Key Concepts

[
  {
    "section": "섹션명",
    "items": [
      {"question": "빈칸이 포함된 문장 (      )", "answer": "정답 단어"},
      {"question": "빈칸이 두 개인 문장 (      ) ... (      )", "answer": ["첫 번째 정답", "두 번째 정답"]}
    ]
  }
]

• answer는 문자열 또는 문자열 리스트 둘 다 가능하다.
• 빈칸이 1개면 문자열, 2개 이상이면 리스트(빈칸 등장 순서대로)로 작성한다.
• 빈칸 개수와 정답 개수는 반드시 일치해야 한다.

섹션 구성 규칙

• 소단원의 학습 내용을 주제별로 ■ 섹션으로 나눈다.
• 섹션명은 해당 주제를 간결하게 요약한다. (예: "지도의 의미", "방위의 의미와 필요성", "축척에 따른 지도의 정보")
• 교과서의 학습 흐름 순서를 따른다.

빈칸 채우기 규칙

1. 빈칸 표시: 정답 단어 자리를 ( )로 대체한다. 한 문장에 빈칸은 1~3개.
2. 정답: 1~3단어. 반드시 교과서 원문 텍스트에 존재하는 단어여야 한다.
3. 문장: 교과서 원문을 기반으로 하되, 빈칸 채우기에 적합하도록 간결하게 정리할 수 있다.
4. 같은 문장에서 여러 단어를 묻고 싶을 때는 빈칸을 여러 개 뚫는다. 같은 문장을 여러 번 반복해서 빈칸만 바꿔 출제하지 말 것.
   • 나쁜 예 (금지):

     {"question": "고체인 (      ), 액체인 물, 기체인 수증기", "answer": "얼음"}
     {"question": "고체인 얼음, 액체인 물, 기체인 (      )", "answer": "수증기"}
     

   • 좋은 예:

     {"question": "고체인 (      ), 액체인 물, 기체인 (      )", "answer": ["얼음", "수증기"]}
     

5. 중복 출제 금지: 같은 개념을 묻는 문제를 여러 개 만들지 않는다. 한 개념당 가장 대표적인 문제 하나만 출제한다.

출제 기준

• 출제해야 하는 것:
  • 교과서가 정의하거나 설명하는 핵심 개념과 용어
  • 학습 목표에 직접 연결되는 내용
  • "꼭 기억해요", 정리 코너 등에 등장하는 핵심 단어
  • 개념 간의 관계나 원리
• 출제하면 안 되는 것:
  • 단순 예시로 등장하는 고유명사 (특정 지역명, 인물명 등)
  • 구체적 숫자 (통계 수치, 연도 등)
  • 학습 목표와 무관한 사소한 사실
  • 활동 지시문 (써 봅시다, 이야기해 봅시다 등)
• 판단 기준: "이 단어를 모르면 이 소단원을 이해했다고 할 수 없는가?" → Yes면 출제, No면 제외

완전성 원칙 (중요)

• 섹션명에 등장하는 핵심 용어는 반드시 그 용어 자체를 정답으로 하는 문제가 있어야 한다.
  • 예: 섹션명이 "증발"이면, "물의 표면에서 물이 수증기로 상태가 변하는 현상을 ( )이라고 한다. → 증발" 같은 정의 문제가 반드시 포함되어야 한다.
• 교과서에 굵게/색깔로 강조되거나 "~라고 한다", "~을 ○○이라고 한다" 식으로 정의되는 모든 용어는 정답으로 출제한다.
• 핵심 용어가 빠지는 것보다 중복되는 것이 낫다. 빠짐없이 다 뽑는 것을 최우선으로 한다.

분량 기준

• 문제 수를 인위적으로 제한하지 말 것. 소단원에 나오는 핵심 개념을 모두 담아야 한다.
• 소단원 분량에 따라 섹션 수와 항목 수는 자유롭게 정한다.
• 부족한 것보다 풍부한 것이 낫다. 핵심 개념이라 판단되면 모두 출제한다.

출력

핵심 개념 JSON을 코드블록으로 출력한다.

Step 3: 검증

생성한 JSON을 아래 Python 코드로 검증한다. page_texts는 Step 1에서 얻은 값을 사용한다.

import sys
sys.path.insert(0, "testmaker/src")
from concept_validator import validate_concepts

concepts = <Step 2에서 생성한 JSON 리스트를 Python 리스트로 직접 대입>

errors = validate_concepts(concepts, page_texts)

if errors:
    print("검증 실패:")
    for e in errors:
        print(f"  - {e}")