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줄 요약을 정리한다.