# Analyze Chapter

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

- Skill: `leedonwoo2827-ship-it/analyze-chapter` (Agent Skill)
- Install (CLI): `npx skillmds@latest add leedonwoo2827-ship-it/analyze-chapter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/leedonwoo2827-ship-it/analyze-chapter/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: leedonwoo2827-ship-it (https://skillmd.com/u/leedonwoo2827-ship-it)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/leedonwoo2827-ship-it/analyze-chapter

---


# 챕터 분석 + 씬 선별

챕터 원고를 읽고, 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)로 진행.