short-drama-develop

1# 短剧开发
2 
3把创作者的意图变成能持续制造**选择、代价与状态变化**的故事系统，保留创作者对题材、结局和尺度的选择。流行套路只能作为候选方法。
4 
5## Quick Start
6 
7离线验证多集整稿的精确索引、按集切分和源文件变更检测：
8 
9```bash
10python3 {技能目录}/scripts/selftest.py
11python3 {技能目录}/scripts/episode_intake.py index <多集整稿> --out <episode-intake-index.json>
12```
13 
14## 开始前
15 
16本技能可独立运行；若在 `short-drama` 项目内且项目工具可用，可读取 `status` 并使用其发布生命周期。[阶段契约](references/stage-contract.md) 定义本阶段边界、制作形态输入与规则表，无需读取其他技能的文件。
17 
18## 先判断入口
19 
201. **只有想法、题材或情绪目标**：完成方向探索，再建立创作简报与故事引擎。
212. **已有梗概、小说、改编材料或系列笔记**：保存来源并列出已承诺事实、可改范围、来源片段与待确认项。长材料先做语义分段、功能账本和候选分集，不用正则命中直接发布剧集或资产。
223. **方向已定，只需规划分集**：读取既有简报与引擎，直接制作或修订分集地图。
234. **已有单集剧本**：不补造开发材料；写/改剧本交给 `$short-drama-write`，拆资产或后续制作从对应技能直接进入。
245. **已有多集整稿，要生成或补分集地图**：保留原文件，只加载 [多集整稿接入与断点续跑](references/multi-episode-intake.md)。由 Agent 按文件实际结构决定边界与本轮批次；脚本只做精确索引、单集切分、校验和续跑。
25 
26信息足够时直接工作；仅当缺口会改变主角、冲突引擎、结局承诺或改编边界时才提问。
27 
28## 每次执行
29 
30### 1. 锁定创作者契约
31 
32读取创作者输入和已接受文件，区分：不可改的事实/主题/角色/结局承诺、可探索的空白、形式与制作边界、目标观众反复获得的回报。新项目复制 [creative-brief.md](assets/creative-brief.md)；若改动已接受事实，先展示语义差异与下游影响，不直接覆盖。
33 
34### 2. 探索真正不同的方向
35 
36方向未定时，提出少量**机制不同**的候选（改变主角策略、对抗来源、代价或冲突持续方式，而非只换标题或职业）；方向明确时直接深化。每个候选说明戏剧承诺、主角追求、对抗机制、反复回报、可升级状态、终止条件与制作负担，交创作者选择或组合并记录理由（未选方案不进入既定事实）。
37 
38- 深化承诺与冲突机制：读 [story-craft.md](references/story-craft.md)。
39- 题材已确定时：从 [genre-cards.md](references/genre-cards.md) 按索引取**一张**题材卡校准压力来源、场面细节与制作负担（仅作内部参考，不进入交付物）。
40- 主角带已知经历或外部授权能力开局时：另读 [premise-devices.md](references/premise-devices.md) 为装置设定边界与代价。
41 
42### 3. 建立故事引擎
43…