| 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줄 요약을 정리한다.
Step 3: 씬 후보 식별
각 본문 단위를 읽으며 scene-design-guide.md의 6대 기준을 적용:
- 시간적 앵커: 구체적 연도/시점(예: "기원전 490년")
- 인물 행동: "이름 + 동사"(예: "다리우스 1세는 전국을 20여 개 주로 나누었다")
- 물리적 공간: 이미지로 옮길 수 있는 장소/유물(궁전·신전·전장 등)
- 극적 긴장감: 전쟁·반란·전환점 등 감정이 고조되는 순간
- 시각적 고유성: 다른 후보와 구도/톤이 구분되는지
- 서사적 역할: 기/승/전/결 중 어디인지
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)로 진행.
