generate-script

使用 Gemini API 生成 JSON 剧本。此 skill 由 create-episode-script subagent 调用，不直接面向用户。

前置条件

1. 项目目录下存在 project.json（包含 style、overview、characters、clues）
2. 已完成 Step 1 预处理：
   • narration：drafts/episode_N/step1_segments.md
   • drama：drafts/episode_N/step1_normalized_script.md

用法

# 生成指定剧集的剧本
python .claude/skills/generate-script/scripts/generate_script.py --episode {N}

# 自定义输出路径
python .claude/skills/generate-script/scripts/generate_script.py --episode {N} --output scripts/ep1.json

# 预览 Prompt（不实际调用 API）
python .claude/skills/generate-script/scripts/generate_script.py --episode {N} --dry-run

生成流程

脚本内部通过 ScriptGenerator 完成以下步骤：

1. 加载 project.json — 读取 content_mode、characters、clues、overview、style
2. 加载 Step 1 中间文件 — 根据 content_mode 选择 step1_segments.md（narration）或 step1_normalized_script.md（drama）
3. 构建 Prompt — 将项目概述、风格、角色、线索和中间文件内容组合成完整 prompt
4. 调用 Gemini API — 使用 gemini-3-flash-preview 模型，传入 Pydantic schema 作为 response_schema 约束输出格式
5. Pydantic 验证 — 用 NarrationEpisodeScript（narration）或 DramaEpisodeScript（drama）校验返回 JSON
6. 补充元数据 — 写入 episode、content_mode、统计信息（片段/场景数、总时长）、时间戳

输出格式

生成的 JSON 文件保存至 scripts/episode_N.json，核心结构：

• episode、content_mode、novel（title、chapter、source_file）
• narration 模式：segments 数组（每个片段包含 visual、novel_text、duration_seconds 等）
• drama 模式：scenes 数组（每个场景包含 visual、dialogue、action、duration_seconds 等）
• metadata：total_segments/total_scenes、created_at、generator
• duration_seconds：全集总时长（秒）

--dry-run 输出

打印将发送给 Gemini 的完整 prompt 文本，不调用 API、不写文件。用于检查 prompt 质量和长度。

支持的两种模式规格详见 .claude/references/content-modes.md。