analyze-chapter

name	analyze-chapter
description	챕터 마크다운 파일을 읽고 구조를 분석하여, 영상 씬으로 변환할 수 있는 장면 후보를 식별하고 추천 씬 라인업을 제안한다. 시리즈 가이드(_series_guide.json)와 절 목록(_manifest.json)이 있으면 장르·청중·scenes_per_episode를 참조한다. 사용자가 챕터를 첨부하거나 '분석해줘', '씬 나눠줘', '대본 만들어줘'라고 요청하면 이 스킬을 사용한다.

챕터 분석 + 씬 선별

챕터 원고를 읽고, knowledge/scene-design-guide.md의 6대 기준에 따라 씬 후보를 식별하고, 서사적 아크와 시험 범위 커버리지를 고려하여 18–26씬의 본편 라인업을 제안한다.

목적은 시청자의 이해·암기(예: 시험 학습)다. 따라서 원고의 핵심(인물·연도·제도·사건·인과)을 빠짐없이 안배한다.

사전 조건

• 챕터 MD 파일이 sample/ 폴더에 있어야 한다
• output/_series_guide.json이 있으면 장르/청중/씬 수/속도를 자동 참조
• output/_manifest.json이 있으면 해당 절의 prefix·part·section·title을 참조 (파일명·스키마용)
• 둘 다 없으면 사용자에게 장르/청중을 직접 물어본다

환각 방지 (최우선)

• 해당 절 원고에 실제로 있는 내용만 씬으로 만든다. 다른 단원·외부 지식의 사건/지명/인물을 끌어오지 않는다.
• 원고는 OCR 정제본이라 깨진 단편이 섞일 수 있다 → 의미가 명확한 사실만 채택하고 깨진 조각은 무시한다.
• 인물·연도·용어는 원고 표기를 그대로 사용한다(임의 변형·추측 금지).

분석 절차

Step 1: 메타데이터 추출

_manifest.json에서 해당 절의 prefix / part / section / title을 가져온다. 챕터 MD 파일 첫 부분에서 보조 정보를 보강한다:

• > 제N단원 N절 또는 > 제N부: 제목 (시대) — 단원/부(Part) 정보
• # N장. 제목 — 제목
• _부제목_ — 핵심 메시지(subtitle 후보)

Step 2: 섹션 구조 파싱

씬 추출 대상 본문 범위(관용적으로 적용):

1. ## 본문 이하 전체, 또는 ## 참고문헌/# 인물부록 이전까지가 본문
2. 위 마커가 없으면 문서 전체를 본문으로 본다
3. # 인물부록 이후는 인물 정보 확인용(씬 추출 대상 아님)

본문을 의미 단위(소주제)로 나눈다. 이 원고들은 ## 본문 단일 블록 안에 여러 소주제가 이어질 수 있으므로, 헤더가 아니라 내용의 주제 전환을 기준으로 분절한다. 각 단위에 대해 제목·분량·1–2줄 요약을 정리한다.

Step 3: 씬 후보 식별

각 본문 단위를 읽으며 scene-design-guide.md의 6대 기준을 적용:

1. 시간적 앵커: 구체적 연도/시점(예: "기원전 490년")
2. 인물 행동: "이름 + 동사"(예: "다리우스 1세는 전국을 20여 개 주로 나누었다")
3. 물리적 공간: 이미지로 옮길 수 있는 장소/유물(궁전·신전·전장 등)
4. 극적 긴장감: 전쟁·반란·전환점 등 감정이 고조되는 순간
5. 시각적 고유성: 다른 후보와 구도/톤이 구분되는지
6. 서사적 역할: 기/승/전/결 중 어디인지

Step 4: 씬 라인업 제안 (18–26씬 본편 구조)

시리즈 가이드의 scenes_per_episode(기본 18–26) 범위에 맞춰 구조 유형을 배치한다:

씬 유형	수량	역할
opening_title	1	오프닝(에피소드 제목·도입)
part_intro	1–3	새 주제/시대/인물 전환 도입
body	12–18	본문 핵심 서사(대부분)
bridge	1–2	중간 정리·질문 던지기
climax	1–2	전환점·결정적 사건
closing	1	정리·여운
next_preview	1	다음 편 예고

배치 원칙:

• 시간순 정렬(기본): body 씬은 가급적 **역사적 시간 흐름(연도 순)**으로 배치한다. 이해·암기에 유리하고 다큐 내러티브가 자연스럽다. 단, 원고가 주제별로 묶여 있거나 인과 설명상 필요하면 예외를 둘 수 있다.
• 시험 범위 커버리지: 절의 핵심 개념(인물·연도·제도·사건·인과)을 빠짐없이 안배. 같은 사건/전투/인물을 두 씬에 중복 배치하지 않는다.
• 서사 아크: 기(배경)→승(전개)→전(전환점)→결(여운)이 되도록.
• 시각적 다양성: 같은 구도/톤의 씬이 연속되지 않게(와이드·초상·다이어그램·유물 클로즈업 등 섞기).

Step 5: 라인업 보고

📋 챕터 분석: [prefix]. [제목]
   단원/부: 제N단원 N절 | 본문 단위: M개 | 목표 씬: N개 (18–26)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎬 추천 씬 라인업 (N개)

 1. [opening_title] 고대 세계의 문이 열리다
    출처: 본문 도입
    핵심: [1줄]
    예상 시간: 18초

 2. [body] 아케메네스 페르시아의 통일
    출처: 페르시아 제국이 성장하다
    핵심: 키루스 2세의 통일과 관용 정책
    서사 역할: 승 | 예상 시간: 48초
 ...

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

💡 총 예상 시간: N분 N초 (목표 15~30분)
   시험 범위 커버: [핵심 개념들이 모두 들어갔는지 1줄]
   수정하시려면 씬 추가/삭제/순서변경을 말씀해주세요.

사용자 수정 대응

• "씬 추가해줘: [설명]" → 해당 단위에서 추가 후보 식별
• "3번 빼줘" → 제거 후 서사 아크 재확인
• "순서 바꿔: 2→4" → 재배치
• "씬 좀 더 넣어줘 / 줄여줘" → 목표 씬 수 조정(18–26 범위 유지 권장)

확정되면 다음 단계(prompt-craft)로 진행.