zenstory-ai/drama-skills / skills/short-drama-develop
short-drama-develop
Unverified将短剧/漫剧点子、梗概、已拆解的原著材料或多集完整剧本整理为改编方案、立项简报、导演阐述、核心冲突设定与分集大纲。用户说“开发短剧”“做故事设定/分集规划”“写导演阐述”“从多集剧本补分集大纲”时使用;不含长篇拆书、项目配置或单集写作。
references/multi-episode-intake.md
View on GitHub# 多集完整剧本导入与分段续拆
当创作者给来一份已经写好的多集完整剧本、散稿、局部选集或合订稿,希望据此生成或更新 `项目开发/episode-map.jsonl` 时走本流程。**Agent 判断这份文件实际怎样分集、每集讲了什么;脚本负责记准行号字节位置,免得返工重拆**。
## 硬性边界
- 原稿原封不动保存在 `输入/`;字节跨度按原始字节计算,CRLF 换行符不做改写,绝不为迁就脚本去改创作者原稿。
- 不把整部多集剧本或整季分集大纲一次性塞进单次对话上下文、heredoc 或命令行参数。
- `episode_intake.py` 不生成转折、回报、钩子等创作字段。它只负责建索引、做校验、切单集片段、推算待拆集数,以及把 Agent 写好的分集记录安全合并写入文件。
- 批次没有通用固定值。Agent 先看索引里各集的 `byte_length`、剧情复杂度和当前剩余上下文空间,再为本轮敲定合适的 `--batch-size`。
## 1. 建候选索引(支持非第 1 集起步与跳集选拆)
```text
<PYTHON> <SKILL_DIR>/scripts/episode_intake.py index \
输入/<完整剧本> \
--source-ref 输入/<完整剧本> \
--out 项目开发/_work/episode-intake-index.next.json
```
脚本自动识别独立短行的 `第N集`、`第N集 标题` 与 Markdown `# EP N`,转为标准 `EP001` 格式。索引**允许不从第 1 集起步,也允许跳集**(例如只导入第 5~10 集分卷稿,或只抽第 1、8、12 集试拆高潮集);退出码 `0` 表示集号按源码出现顺序严格递增且无重号、无空集,退出码 `2` 表示存在重号、倒序、空集或未识别出标题等问题。
`unmapped_spans` 会标出第一个分集标题之前的序言与目录位置,但夹在两集之间的制作备注或尾注会归入前一集末尾。Agent 须查看 `unmapped_spans` 并抽读切口前后几行文字确认分集边界;遇到幕标题、分隔线等非标准写法时,手写简短的边界 JSONL(填标准 `episode_id`、`line_start` 及可选 `line_end`)生成精确索引:
```jsonl
{"episode_id":"EP005","line_start":12}
{"episode_id":"EP008","line_start":58}
```
```text
<PYTHON> <SKILL_DIR>/scripts/episode_intake.py manual-index \
输入/<完整剧本> <临时边界.jsonl> \
--source-ref 输入/<完整剧本> \
--out 项目开发/_work/episode-intake-index.next.json
```
候选索引跑通 `verify` 后存到正式路径 `项目开发/episode-intake-index.json`:
```text
<PYTHON> <SKILL_DIR>/scripts/episode_intake.py verify \
项目开发/_work/episode-intake-index.next.json 输入/<完整剧本>
```
## 2. 每次只切当前批次要读的那几集
切单集文本前先跑 `verify`(原稿一旦改动必须重建索引,不拿旧位置硬切):
```text
<PYTHON> <SKILL_DIR>/scripts/episode_intake.py verify \
项目开发/episode-intake-index.json 输入/<完整剧本>
<PYTHON> <SKILL_DIR>/scripts/episode_intake.py progress \
项目开发/episode-intake-index.json 输入/<完整剧本> \
项目开发/episode-map.jsonl --batch-size <本轮由 Agent 决定>
<PYTHON> <SKILL_DIR>/scripts/episode_intake.py slice \
项目开发/episode-intake-index.json 输入/<完整剧本> EP001 \
--out <临时单集文件>
```
每次只读 `next_batch` 列出的那几集切片与上一集末尾交接,写完一集追加进本轮临时 batch JSONL。
## 3. 合并保存、修订覆盖与分段续拆
`merge` 把现有分集大纲与本轮 batch 按集号数值升序合并保存:**允许用新批次中的同 `episode_id` 记录覆盖更新已有分集记录**(返回 `added` 与 `updated` 列表;内容完全一致的记录重复合入时自动跳过),并**保留既有 `episode-map.jsonl` 中属于其他分卷的合法集号**;同时严守核心护栏——**拒绝本轮 batch 写入不在当前索引 `episodes` 声明范围内的未知集号**、同批重复集号或超出 `--batch-size` 上限的批次:
```text
<PYTHON> <SKILL_DIR>/scripts/episode_intake.py merge \
项目开发/episode-intake-index.json 输入/<完整剧本> \
<本轮 batch.jsonl> 项目开发/episode-map.jsonl \
--out 项目开发/episode-map.next.jsonl \
--batch-size <本轮由 Agent 决定>
```
核对无误后保存至 `项目开发/episode-map.jsonl` 并清理临时文件。中途断开后重跑 `progress`,自动按磁盘现有记录推导剩余 `pending` 集号。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |