Imported from zenstory-ai/drama-skills (
skills/short-drama-novel-analyze/SKILL.md) via skills.sh. Install upstream withnpx skills add zenstory-ai/drama-skills --skill short-drama-novel-analyze. Copyright stays with the author (MIT).
长篇原著分析
从长材料中提取可追溯的戏剧功能，说明各段如何改变角色选择、信息、权力或关系，以及这些功能怎样用于竖屏短剧改编。
分析结果供创作者取舍：保留哪条线、合并哪些人、从哪里开篇，由创作者决定，再交给
$short-drama-develop 写成改编契约。本技能不批准自己的产物。
Quick Start
离线验证章节索引、采样和源文件变更检测：
python3 {技能目录}/scripts/selftest.py
python3 {技能目录}/scripts/novel_index.py index <原著.txt> --out <chapter-index.json>开始前
本技能可独立运行；若当前目录是 short-drama 项目且项目工具可用，可读取 status 并使用其发布生命周期。完整边界与规则见 阶段契约，无需读取其他技能的文件。
材料前提
只分析创作者合法持有、拥有使用权的作品。分析是只读的转化性工作：记录 locator、span 与去引用的功能摘要，不把原文成段复制进分析或下游产物；需要证据时只引用最短必要片段。交付包不得带出原始材料。
通俗题材里的暴力、复仇、背叛、情爱张力与黑暗伦理照常做结构化提取。个别片段无法处理时跳过该段并记录范围，不中止整章或整本。
先判断入口
- 只有书名，没有原文：请创作者提供文件路径或粘贴正文，不凭书名回忆情节。
- 有原文，未建项目：建立只读输入目录
输入/与输出目录项目开发/source-analysis/_work/，把原文字节复制到输入/并记录原始位置，再用novel_index.py建索引（$short-drama可用时可选用它初始化目录）。 - 有原文，项目已在：直接进入管道。
- 已有部分分析：读
项目开发/source-analysis/_progress.md从断点续跑，不重跑已完成阶段。
管道
输入/ 只读，全部产出落在 项目开发/source-analysis/。S1–S5 的产物均先写到 source-analysis/_work/（并发子代理只写 _work/），主线程完成本阶段机械检查后再原子替换或通过 project_tool.py publish 发布到正式路径。_progress.md 跨阶段共用固定 artifact-id source-analysis:progress。
| 阶段 | 做什么 | 产出 | 停靠 |
|---|---|---|---|
| S0 | 建章节索引（脚本） | _index.json、_progress.md |
索引有问题就停 |
| S1 | 改编价值快评（抽样） | triage.md |
停靠问创作者 |
| S2 | 逐章功能提取 | chapters/ch-<N>-extract.md |
覆盖率不足就停 |
| S3 | 剧情单元与节奏聚合 | story-units.md、rhythm-and-emotion.md |
阈值不达标就复核 |
| S4 | 人物归并与设定 | characters.md、world.md |
— |
| S5 | 改编价值与分集候选 | adaptation-value.md、episode-candidates.jsonl |
交接 develop |
S0 章节索引
各阶段共用 章节索引脚本 建立的章节边界，不各自重新切分。
python3 {技能目录}/scripts/novel_index.py index 输入/{原文文件} \
--out 项目开发/source-analysis/_work/_index.next.json
python3 {技能目录}/scripts/novel_index.py verify \
项目开发/source-analysis/_work/_index.next.json 输入/{原文文件}
# 项目工具可用时可选：
python3 {core 技能目录}/scripts/project_tool.py publish {项目根} \
--owner short-drama-novel-analyze --artifact-id source-analysis:index \
--output 项目开发/source-analysis/_index.json=项目开发/source-analysis/_work/_index.next.json \
--input 输入/{原文文件}独立运行时，将验证通过的 _work/_index.next.json 原子替换到正式的 _index.json，再进入 S1。
脚本识别阿拉伯数字与中文数字章号（含 千 / 两），只认一种编号单位（按 章、回、节 由粗到细，取最粗且至少出现两次的单位，其余记进 ignored_heading_units），只把短的独立行当标题（以章号开头的正文段落记进 long_heading_lines_skipped），剔除开头目录块并按卷分段校验编号。
problems 非空就停下报告，不带错表进 S1。常见五种：章号跳号、同卷内重号、正文极少的章（目录残留或卷首页）、无法解析的章号、第一章前有大段未归属文字（text_before_first_chapter，不含目录行；确认是楔子后在 _work/_index.next.json 开头手写一行从第 1 行起覆盖，source_number 留 null，其余 sequence 顺延加一再跑 verify）。另核对 chapter_unit 与 ignored_heading_units（防用 第N章 分章、第N节 分小节的书被反判），以及 long_heading_lines_skipped（明显偏大时与创作者确认是否长标题并手写边界）。
原文无章节标题时索引返回空表，与创作者确认切分方式后把边界（含 sequence / line_start / line_end）写入 _work/_index.next.json，通过 verify 后发布。改了原文必须重建索引（verify 查章号与行号覆盖，不查同行数原地改写）。
S1 改编价值快评
按 改编价值快评 用 novel_index.py sample --count 12 抽样评估改编密度并写出 triage.md（首行写 coverage_ratio，结论限于抽样范围）。写完后给出快评与全量拆解预计耗时，停靠问创作者是否继续（_progress.md 状态写 paused_after_triage，断点写「下一步：S2 逐章提取」）；创作者已声明「一次跑完」时仍写 triage.md 供 S5 回填对照，但不停靠。
S2 逐章功能提取
按 章节提取 提取每章到 chapters/ch-<N>-extract.md（<N> 为索引 sequence）。能并发子代理则每批 5–8 章并发，否则串行。全部落盘后检查覆盖率：
python3 {技能目录}/scripts/novel_index.py coverage \
项目开发/source-analysis/_index.json 项目开发/source-analysis/chapters先修正 unmatched_files 中的命名错误，再补跑 missing 章。单章连续失败两次先记入 _progress.md 继续提取其余章，S2 结束前统一补齐；仍有缺章时停在 S2 报告缺失范围，不进入 S3。
S3 剧情单元与节奏
从逐章提取聚合（事实或指代不清时按定位回查原文，不通读全书）。按 聚合与实体 先识别故事框架，再产出 story-units.md 与 rhythm-and-emotion.md（含按观众收益排名的爽点表），最后执行三条阈值自检与散落情节兜底。
S4 人物与设定
按 聚合与实体 归并人物（跨章去重、别名归一、分级）并归纳世界规则、力量体系与势力。人物归并条目带 unresolved 与来源引用，仅为供 $short-drama-develop 决策的候选；正式资产身份须等 $short-drama-write 写进剧本后由 $short-drama-assets 建立。
S5 改编价值与分集候选
按 改编价值 产出 adaptation-value.md（开头回填对照 S1 快评中印证或推翻的判断）与 episode-candidates.jsonl（按爽点分布、当集戏剧结果与精确交接切分，样例见 分集候选样例）。
交接
S5 完成后向创作者汇报拆解章数、跳过范围、候选集数、三处最大改编风险及快评对照结果，再交给 $short-drama-develop 生成 项目开发/adaptation-map.jsonl 与改编契约。需要独立审查时调用 $short-drama-review（范围 source_analysis）。
产物与边界
本技能只拥有 项目开发/source-analysis/ 下的阶段产物（见上表），不改写 输入/、不写其他技能产物、不签发终审结论；分析产物语言跟随 short-drama.json#/language（独立运行时跟随用户语言），详见 阶段契约。
