@oh-story/dsh 0.1.3 → 0.1.5

package/lib/drama/skills/short-drama-write/SKILL.md

@@ -1,284 +1,90 @@
 ---
 name: short-drama-write
-description: 编剧环节：创作或修订中文短剧、漫剧单集卡、因果节拍与可拍摄的 Markdown 剧本，也负责把现有中文剧本以保留原文、预览语义差异、创作者接受后发布的方式规范化。用户提出“写/改一集短剧”“把大纲写成剧本”“优化场景/对白”“去模板感地修订”“去 AI 味润色”“续写下一集”或提供现成剧本要求进入后续制作时使用；不负责资产、分镜、媒体提示词或终审。
+description: 编写或修订可拍摄的中文短剧、漫剧单集 Markdown 剧本，也负责保留作者原文地规范化现成剧本。用户提出“写/改一集短剧”“把大纲写成剧本”“优化场景/对白”“去模板感”“去 AI 味润色”“续写下一集”或提供剧本要求进入后续制作时使用；不负责资产、分镜、媒体提示词或终审。
 license: MIT
 ---
 
 # 短剧写作
 
-把单集意图写成可表演、可追踪且会改变故事状态的场景。`screenplay.md` 是唯一可编辑剧本源；卡片和节拍帮助推理，不是另一份正文。
+把单集意图写成可表演、可拍摄、会改变故事状态的 `剧集/<EP>/剧本.md`。
 
 ## Quick Start
 
-离线验证剧本分块索引与录音表逐字投影：
-
-```bash
-python3 {技能目录}/scripts/selftest.py
-python3 {技能目录}/scripts/screenplay_index.py <screenplay.md> --output <screenplay-index.jsonl>
-```
-
-## 估算本集时长
-
-写完一集后，可以按**项目自己声明的速率**估算它有多长。套件不带跨项目速率，也不设容差带：
-
-```bash
-python3 {技能目录}/scripts/duration_estimate.py <screenplay.md> \
-  --index <screenplay-index.jsonl> --project <short-drama.json>
-```
-
-脚本见 [duration_estimate.py](scripts/duration_estimate.py)。**它不自己读剧本格式**：哪一段是
-台词、哪一段是动作、哪一行是注释，全部按 `screenplay-index.jsonl` 的分块来，所以先建索引再估算。
-一个格式两个读法就是两套答案——此前它自带的那套把 `[VO]` 计零秒、把 Markdown 注释当台词计时、
-把带冒号的动作段读成对白、把一个多行动作段按行数重复计算。索引与剧本字节对不上时脚本拒绝估算；
-索引里还有没归类的文本时，报告里会多出 `incomplete`，说明这个秒数没覆盖全篇。速率写在 `short-drama.json` 的
-`format.pacing`（`spoken_characters_per_second` 与 `seconds_per_action_paragraph`），
-由创作者按本项目的戏来定——密集争辩和沉默劳作不是同一个折算比。没有声明速率时，脚本只报
-台词字数与动作段数，不猜秒数。
-
-结果是**给创作者看的数字，不是门槛**：偏离目标不阻断交付。它的价值在于让"这一集到底多长"
-在剧本阶段就能回答，而不是等到分镜环节才发现装不下——那时戏已经写完了。
-
-## 开始前
-
-本技能可独立安装和执行。先读取用户明确提供的单集材料与本任务直接输入；若当前目录是
-`short-drama` 项目且项目工具可用，可以读取 `status` 并使用其发布生命周期，但缺少 core
-或任何其他技能都不是写作工作的阻断条件。[阶段契约](references/stage-contract.md) 给出
-本阶段边界与规则表，无需读取其他技能的文件。
-
-## 先判断入口
-
-1. **有已接受的分集规划**：读取本集进入状态、承诺和交接事实后写作。
-2. **只有想法或口述大纲**：在本技能内制作最小单集卡与因果节拍；只有系列方向本身未定时才转 `$short-drama-develop`。
-3. **已有规范剧本**：保留作者语言，做定点修订；先说明改动意图和影响。
-4. **已有非规范文本，目的是进入后续制作**：保存原始字节；只提议场景标题、对白/动作分块、生产标签与索引所需的最小规范化。展示语义新增、删除、改写、未映射段落与不确定处，得到创作者接受后才能发布。不得补造故事引擎、节拍或新剧情。
-
-## 每轮的工作单元
-
-一轮写一个明确的场景或场景组。“把整集写完”也按场景边界拆成若干轮，每轮：
-
-1. 只读这个单元的直接输入，写或改它的正文，跑本地结构检查；
-2. 落盘这个单元，其余范围保持原样；
-3. 报告已覆盖范围、剩余范围、未决决定和下一个值得做的单元；
-4. 交还控制权，等创作者的下一次请求。
-
-资产拆解、生产和审查各自是独立的工作单元，由创作者明确请求时开始。
-
-## 每次执行
-
-### 1. 读取当前真相
-
-确认创作者约束、已接受的上游事实、本集进入状态和待兑现铺垫。若修订已有剧本，引用当前文件而不是凭对话记忆重写。本阶段拥有什么、继承什么见 [阶段契约](references/stage-contract.md)。
-
-### 2. 确定单集契约的唯一 owner
-
-- **有 accepted `项目开发/episode-map.jsonl` 记录**：复制
-  [episode-card.json](assets/episode-card.json)。它在 `sources` 里声明上游快照，用
-  `{"src": "episode-map", "record_id": "EP001"}` 指向那条记录，其余只保存写作执行选择；
-  不复制、不改写 incoming/objective/turn/payoff/handoff。
-- **没有 development map 的 script-first 项目**：复制
-  [episode-card-standalone.json](assets/episode-card-standalone.json)，以 `write_standalone`
-  模式拥有最小单集契约。
-
-同一集不得同时激活两个模式。若后续建立 development map，先做语义
-diff，让创作者明确选择 authority 迁移，将 standalone 契约标记 superseded，
-再换成 pointer 卡。若上游契约需改，发 develop owner revision；不在 execution
-字段里偷改。不要用悬念替代整集回报。
-
-单集契约进入本阶段时必须包含哪些字段、缺失时怎么办，见
-[阶段契约](references/stage-contract.md) 的“单集契约与题材边界”。若只做原文规范化，
-跳过本步，不推断缺失剧情。
-从想法或 `write_standalone` 直接写作时，本阶段执行已接受的题材与钩子取向，不自行给项目
-归类题材；没有已接受取向时按同一节的做法处理，不为贴题材标签另造公式。
-
-### 3. 建立因果节拍
-
-复制 [beats.jsonl](assets/beats.jsonl)，让每条节拍回答：
-
-- 因为什么，谁现在要什么；
-- 谁或什么阻挡；
-- 观众能看见/听见的行动是什么；
-- 信息、权力、关系、情绪、物理状态或风险怎样变化；
-- 这个结果怎样制造下一股压力。
-
-若节拍开启新线，明确声明；不要把“然后发生”伪装成“因此发生”。数量与长短服从本集动作，而非统一模板。
-
-关系字段遵守同一约定：同一 `beats.jsonl` 内的前因、铺垫与兑现只写稳定
-`because_of_ids`/`setup_ids`/`payoff_ids`，避免自引用文件哈希；来自 episode map、
-前集或其他 owner artifact 的关系写 canonical `because_of_refs`/`setup_refs`/
-`payoff_refs`。`*_refs` 只放引用对象。
-
-引用这样写：文件首行的 `{"record_type": "sources", "schema_version": "1.0.0",
-"sources": {...}}` 记录把每个上游快照声明一次，`sources` 的每个短键映射到
-`{"owner": ..., "artifact": ...}`；每条引用写
-`{"src": "<sources 键>", "record_id": "<记录 ID>"}`，需要时再加 `field` 指向该记录内
-的 JSON pointer。指向整个 artifact 时只写 `{"src": "<sources 键>"}`。同一份文件里
-同一个键始终指同一个快照。`.json` 文件把同样的 `sources` 对象写在顶层。
-
-### 4. 先定场景功能，再写正文
-
-对每个场景先回答：为什么必须存在、谁的议程对撞、哪个可见动作承载冲突、哪里发生方向性变化、退出状态给下游留下什么。需要场景与可见行动方法时读取 [script-craft.md](references/script-craft.md)。
-
-写对白前读取 [dialogue-craft.md](references/dialogue-craft.md)，尤其检查人物策略、潜台词、信息争夺和声音差异。
-当声源、环境撤出、主动留白、画外存在或相邻场 sound bridge 承担戏剧转向时，读取
-[scene-sound-dramaturgy.md](references/scene-sound-dramaturgy.md)。剧本只拥有故事必需的声音事实，
-不替分镜设计逐镜声轨，也不用配乐替代表演。
-
-创作者指出某个兑现的呈现方式**可能需要更换**时，读取
-[substitutable-realization.md](references/substitutable-realization.md)，把功能、当前实现
-与备选实现分开写下来。**不要因此提前磨平任何内容**：先按最想要的拍法写，备选只在真的
-需要时启用。创作者没有标注时不做这一步，也不替创作者预判。
-
-长单集需要跨多轮续写、上下文即将切换或中断恢复时，读取
-[scene-handoff-capsule.md](references/scene-handoff-capsule.md)，只保存从当前剧本派生的
-最小场景交接；一次完成或局部修订时不要额外建立第二份摘要。
-
-### 5. 写唯一剧本源
-
-复制 [screenplay.md](assets/screenplay.md)，严格按 [screenplay-format.md](references/screenplay-format.md) 写：
-
-- `## EP001-SC001 内 · 地点 · 时间`；
-- 现在时、可见可表演的动作；
-- `角色（可表演提示）：台词`；
-- 仅对故事必需事实使用 `[VO]`、`[OS]`、`[SFX]`、`[画面文字]`、`[转场]`、`[连续性]`。
-
-识别创作者交来的行业通行方言（`△` 动作行、`【卡点】` 等）、做原文规范化映射，
-或按创作者要求以方言交付时，读取
-[production-format-dialect.md](references/production-format-dialect.md)。
-
-不要把镜头、资产全集、模型参数或提示词写进剧本。私密想法要转成行为、证据、空间后果，或明确标记的声音表达。
-
-正文发布后，用 [screenplay_index.py](scripts/screenplay_index.py) 生成只读派生索引；工具只识别格式契约中的场景标题、动作、对白、六种生产标签和注释，并保留 UTF-8 byte offsets 与行范围：
-
-```bash
-python3 <skill-dir>/scripts/screenplay_index.py 剧集/EP001/screenplay.md \
-  --output 剧集/EP001/screenplay-index.jsonl \
-  --source-ref 剧集/EP001/screenplay.md \
-  --speaker 葛晴 --speaker 游森
-```
-
-由 write owner 阅读当前剧本后，把本集实际说话者逐个传给 `--speaker`；索引器只做精确
-标签核对，不用冒号正则猜人物。未登记的 `前缀：内容` 写成 `ambiguous_dialogue_or_action`。
-
-**它不会作为块进入索引**，所以覆盖、时长与配音本都看不到它——必须处理掉，不能留着。
-三种处理方式：补入说话者清单（它确实是台词）、改用 `[画面文字]` 等生产标签、或改写这一行
-让它不再是「前缀：内容」的形状（动作段里的全角冒号可以改成破折号或拆成两句）。
-留着不处理时，分镜阶段的覆盖检查会报 `SHT01_SCREENPLAY_IS_NOT_FULLY_INDEXED`，
-时长估算的报告会带上 `incomplete`。
-
-规范化预览尚未获 creator acceptance 时加 `--authority candidate`，使 meta、block 与
-source issue 的 refs 都保持 candidate；accepted 剧本发布后再以默认 accepted authority
-重建，不得只手改状态字段。
-
-修订后**必须把上一版一起交给索引器**，两个参数成对出现：
-
-```bash
-python3 <skill-dir>/scripts/screenplay_index.py 剧集/EP001/screenplay.md \
-  --output 剧集/EP001/screenplay-index.jsonl \
-  --previous-index 剧集/EP001/screenplay-index.jsonl \
-  --previous-source <改稿前的剧本字节> \
-  --source-ref 剧集/EP001/screenplay.md --speaker 葛晴 --speaker 游森
-```
-
-这样**正文块按内容保 ID**——内容没变的块保住自己的 ID，被改写的块**换新 ID 并让旧 ID 退役**，
-于是指向它的下游引用会失败而不是静默改指。同时多一层拆分/合并识别：歧义写入
-`mapping_review_request`，必须显式重映射。
-**场景标题是例外**：它按 `scene_id` 保 ID，改写标题不换 ID（同一场戏仍是同一场，内容由标题下面
-的块承载）。说话者清单从上一版索引读回，与这次传的 `--speaker` 取并集，修订时只传新增的人即可。
-
-**退役是永久的，不只是对下一版**。索引 meta 里的 `block_id_high_water` 记着每个场景、每种块
-用到过的最大编号，逐版往下传。没有它时，编号只从上一版索引推：某个场景里某一类块一旦全部消失，
-下一版就从 01 重新发号，把一个曾经属于别的内容的编号发给新块——下游引用照样解析得开，
-指的却是另一段戏。
-
-**输出路径上已经有索引、却没有告诉索引器上一版是什么时，命令会指名该文件并停下**。
-这一条不是礼貌提示：不带上一版重建，ID 按位置重新发放，被改写的块会拿回前一个块退役的编号，
-指向它的下游引用于是解析得开、内容却换了一个——而解析得开正是正确引用的样子，下游看不出来。
-确实要从零重编 ID（下游引用还没建立，或准备整体重指）就加 `--no-previous`，
-让这件事成为一个明写出来的决定。
-
-索引器绝不改写 `screenplay.md`。
-
-正文落定后做一次量级粗测：按项目已接受的语速/字数比把正文字数折成秒数（项目没有这个
-比值就向创作者要一个量级），与本集目标时长比一次。差出两倍以上就在报告里点名，由创作者
-决定改集长还是拆集；两倍以内不必提。
-
-### 5b. 配音本
-
-项目的对白由录音或 TTS 承担时，配音本和剧本一起交付，不是事后想起来才补的东西：没有它，
-拿到剧本的人手里有台词、没有任何一句该怎么念，而这正是下单前最后缺的一块。项目确定
-只做无声或字幕交付时才跳过这一步，并在报告里写明跳过的理由。
-
-创作者要为录音准备台词表时，复制
-[voice-record-sheet.jsonl.md](assets/voice-record-sheet.jsonl.md)。它是**剧本的投影，
-不是第二份台词权威**：首行声明所引 `screenplay-index.jsonl` 快照，其后每行用
-`source_ref` 绑定一个剧本块并逐字等于该块，要改词就改剧本再重新投影。
-
-录音顺序几乎从不是剧情顺序（通常按人物集中录），配音者失去的正是上下文，所以每行要补
-对谁说、接谁的话、此刻他知道什么、这一句要达成什么。写策略而不是情绪词——"愤怒"不可
-执行，"质问"可执行。多音字、生僻字与专名的读法在进棚前定完并留痕；棚里中断是最贵的。
-
-音色描述属于角色档案，由 assets owner 按 `$short-drama-assets` 的 `voice-direction.md` 写；
-配音本用 `source_ref` 指向它，不在这里另写一份。两份都在，一句台词才既有词也有声音。
-
-本写作阶段不生成音频，也不从这份文本判断成品音质；实际 TTS 的确认后生产边界见文末。
-
-写完后用 [voice_sheet_check.py](scripts/voice_sheet_check.py) 核对它仍然是投影：
-
-```bash
-python3 <skill-dir>/scripts/voice_sheet_check.py 剧集/EP001/voice-record-sheet.jsonl \
-  --index 剧集/EP001/screenplay-index.jsonl \
-  --screenplay 剧集/EP001/screenplay.md
+只维护一份剧本 Markdown，不另建 episode card、beats、block index、录音表、QA 或接受记录。
+一级标题使用 `# EP001 集名`，场景标题使用 `## EP001-SC001 内 · 地点 · 时间/天气`。
+对白写 `角色（可选表演提示）：台词`；生产标签使用 `[VO]`、`[OS]`、`[SFX]`、`[画面文字]`、
+`[连续性]`、`[转场]`。不要把含冒号的动作叙述误写成对白。
+
+## 入口
+
+- 有分集规划：读取本集进入状态、目标、转折、回报和交接事实。
+- 只有想法/大纲：在上下文形成最小单集契约和因果节拍，再直接写剧本。
+- 已有剧本：保留作者语言，只做用户点名的定点修订。
+- 非规范文本要进入制作：保留原文，只做必要的场景、动作、对白和生产标签规范化。
+
+开发大纲和长篇分析都是可选上游；当前材料足够时直接写。
+
+## 工作流
+
+1. 锁定本集承诺的观看体验、谁现在要什么、阻力、当集兑现和退出状态。
+2. 只识别本集实际存在的发动机：若主打艰难选择，检查两边价值；若判断转折依赖争议证据，检查证明边界；若前景化精确死线，检查动作容量；若题面限定次数、轮次、呼吸或节拍，检查每个单位是否在边界内完成所需状态。没有时不强行补齐；输入已经以它为主发动机时，要让它真正改变行动、关系或结果，不只在台词中点名。
+3. 在上下文排“因为—行动—结果—下一股压力”，不落盘节拍表；让物件、对白、沉默、空间或声音按本集题材承担必要工作，不预设某一种载体。
+4. 逐场确定不可替代的功能、可见变化与场尾状态；由争取或冲突组织的场景再明确焦点议程与阻力。承担主要戏剧功能的配角要有自己的策略，事务性或环境性角色保持简洁即可。
+5. 把动作、对白、画外音、声音事实和画面文字写入同一份剧本。
+6. 用户要求整集就写完整集，场景批次自动续跑。
+7. 交稿前静默反查：只看剧本能否接收到本集承诺、人物行动是否有因果、题材语气是否一致；再对本集确实使用的选择、证据、有限单位或精确死线做专项检查。若自检让剧本长出输入没有要求的机关，撤掉机关而不是替它找理由。
+8. 局部修订保留无关段落；明确问题直接修正，只把真实剧情分叉交给用户。
+
+## 写作要求
+
+- 先服从输入已经给出的事实、`必须/禁止`、题材观看契约和退出状态；本技能的审查项与手艺默认只帮助实现这些要求，不能反过来补造题面没有的精确数字、记录、资源、程序、关系或机关。
+- 每场改变信息、权力、关系、情绪、物理状态或风险；无变化的场删掉或合并。核心阻力的转向要有可追溯的事实、筹码、权限、代价或人物行动，不能只靠对手停止反应。
+- 对白必须在争取、回避、试探、逼迫或重新定义关系；用可见、可听、可触的行为表现状态，不用解释替代行动，也不把已经演清的机制再说一遍。
+- 观众理解当前行动所必需的赌注要进入剧本，但载体服从题材；选择、证据、有限单位、精确死线等专项规则只在输入真正以它为发动机时启用，并按需读取[剧作手艺](references/script-craft.md)，普通决定、普通物件和模糊时间压力不升级成同一套机关。
+- 压缩过程时只保留会改变策略、关系、风险或结果的节点。资源与外部反应必须来自输入或前文建立，且不能替人物完成最难的戏剧行动。
+- 承担主要冲突的角色要保持相称的目标、判断或策略；事务性、环境性角色保持简洁，不为检查表硬加秘密、反转或人物弧。
+- 已建立的代价、不可逆后果、关键持物、空间和知识状态要进入可追溯的退出状态；结尾可推进、留白、反讽、安静收束或形成余韵，不强制追加外部事件。
+- `[连续性]` 只交接由前文动作已经建立、又容易在下游丢失的状态；不能用作者标签证明镜头外从未发生某事，也不复述正文已清楚呈现的结果。
+- 交稿前静默做一次经济性检查：是否增加了输入没有要求的精确数字或记录链；是否用标签/对白重复动作；是否在回报后堆了多个同方向后果。没有新作用的内容删掉，knowhow 本身不删。
+- 输入给出目标时长时按真实表演、动作和停顿通读压稿，先删重复验证、解释和同义收尾；不用统一字数、镜头数或节拍数填模板。
+- 用户原文优先；“去 AI 味”是定点修订，不抹平作者个性。
+
+## 按需知识
+
+默认只读本 SKILL 和直接输入。出现下列明确信号时，在写正文前读取对应知识；同一输入有多个不同问题
+可以分别读取，但不遍历无关引用：
+
+- 阶段边界与规则分级：[阶段契约](references/stage-contract.md)
+- 场景标题、对白和生产标签语法，或把创作者带来的现成剧本[规范化](references/screenplay-format.md#7-现有文本的规范化入口)：[剧本格式](references/screenplay-format.md)
+- 项目特有的制作稿方言：[制作格式方言](references/production-format-dialect.md)
+- 输入含[核心选择](references/script-craft.md#35-把一拍写成艰难选择时两个方向都要活着)、[有限次数/轮次/呼吸/节拍](references/script-craft.md#64-有限单位按完成状态计数)、[精确倒计时](references/script-craft.md#63-倒计时先算动作不要只写数字)或[会改变人物判断的关键物证](references/script-craft.md#53-证据先改变判断再改变关系)：[剧作手艺](references/script-craft.md)
+- 过去关系必须通过对白进入，或关键人物容易只剩说明功能：[对白手艺](references/dialogue-craft.md)
+- 声源、留白与 sound bridge：[场景声音戏剧](references/scene-sound-dramaturgy.md)
+- 同一故事义务的不同可拍实现：[可替代实现](references/substitutable-realization.md)
+- 长单集跨上下文时的最小交接：[场景交接胶囊](references/scene-handoff-capsule.md)，只留在上下文
+
+## 时长估算（按需）
+
+用户问时长时才把索引写入系统临时目录。先用 Python 查询跨平台临时目录，把第一条命令打印的完整
+路径原样替换进后两条命令的引号内。以下每条都是一行完整命令，不依赖 shell 变量或续行符；Windows
+没有 `python3` 命令时使用 `py -3`。`--speaker` 的示例值必须替换为本集实际说话者；只有存在项目
+配置时才添加 `--project short-drama.json`：
+
+```text
+python3 -c "from pathlib import Path; import tempfile, uuid; print(Path(tempfile.gettempdir()) / ('short-drama-' + uuid.uuid4().hex + '.jsonl'))"
+python3 "{技能目录}/scripts/screenplay_index.py" "剧集/EP001/剧本.md" --output "粘贴第一条命令输出的完整路径" --speaker "本集角色一" --speaker "本集角色二"
+python3 "{技能目录}/scripts/duration_estimate.py" "剧集/EP001/剧本.md" --index "粘贴第一条命令输出的完整路径"
 ```
 
-脚本按块 ID 定位、切出剧本原字节，再逐字比对台词与说话人。剧本改过而
-索引没重建、或有人在表里顺手改了词，都会被单独报出来——**这两种情况下的配音本看起来
-和正常的一模一样**，而它被带进录音棚的那一刻正是没人能核对的时刻。
-
-只覆盖部分对白（按人物或按场次分表）是正常做法，未覆盖的块只报告不判错。
-
-### 6. 修订而不是抹平
-
-按顺序做所有者修订：
-
-1. **因果**：选择是否造成后果，转折是否由已存在的压力产生；
-2. **场景**：目标、反对、转向、退出是否清楚；
-3. **可拍性**：情绪和认知是否有演员能执行的载体；
-4. **对白**：每轮是否在争取、回避、试探、逼迫或重新定义关系；
-5. **生产事实**：必读文字、画外音、画外对白、关键声音和连续性变化是否有边界标签；
-6. **交接**：本集结束的知识、持物、伤势、关系和决定能否成为下一集准确开场。
-
-局部修订保留不相关段落。先展示语义差异与可能失效的下游产物，创作者接受后再发布。
-
-### 7. 报告审查交接
-
-完成结构检查后只报告当前范围是否适合单独复核，不自动启动复核。若之后收到带证据的修订请求，
-只修改本技能拥有的单集卡、节拍或剧本；完成该有界修订后再次交还控制权，复审需要新的明确请求。
-
-## 规则分级
-
-- **`structural_invariant`**：场景/块 ID、引用、已有生产标签语法、来源哈希与明确矛盾；
-  校验器可阻断。
-- **`reviewed_invariant`**：因果是否成立、场景是否真正转向、内心是否可表演、对白是否改变局面，
-  以及生产关键事实是否漏标；reviewer 须引用文本证据。
-- **`craft_default`**：进入得晚、退出得早、以选择和后果推动、用具体动作承载情绪；可说明理由覆盖。
-- **`taste_option`**：沉默、旁白、方言、打断、场景静动、句式节奏；遵从创作者选择。
-
-不要把统一的爆点安排、转折时刻、台词比例、字数、场景数或节拍数设为质量门槛。
-
-## 产物与边界
+估算是参考，不是门禁；没有语速或动作段速率时只报告可数事实，不猜秒数。但任务已给目标时长时，
+写作者仍须用真实朗读和动作通读判断能否容纳，并直接压缩重复节拍；“不能精确估秒”不是忽略目标的理由。
 
-本技能只拥有：
+## 完成
 
-- `剧集/<EP>/episode-card.json`（上游 pointer + write execution，或显式
-  `write_standalone` 契约；二者不并存）
-- `剧集/<EP>/beats.jsonl`
-- `剧集/<EP>/screenplay.md`
-- 由剧本生成的 `screenplay-index.jsonl`
-- `剧集/<EP>/voice-record-sheet.jsonl`（对白由录音或 TTS 承担时）
-- 规范化预览与语义修订差异
+点名范围已写入、场景因果连贯、对白与行动可表演、承诺有兑现或有意延迟、结尾完成本集预定的戏剧或情绪功能，即完成。最后一拍可以推进，也可以安静收束、形成余韵或让既有动作变义；判断它是否有效，不用“是否又发生一件事”代替。
+资产、分镜、审查与生产只有用户点名时开始。
+五份创作文档齐备后，可转 `$short-drama` 对跨文档结构做一次机械核对；内容质量仍由创作者审查。
 
-资产身份、分镜边界、图片/视频提示词及终审结论属于其他技能。本技能不生成媒体。
+## 安装维护
 
-创作者要求实际合成已确认台词时，把当前录音表与声音绑定交给 `$short-drama-produce`。
-生产技能必须先展示本次 TTS 任务的原句、角色/声音、数量、参数和输出路径，并取得针对这份
-预览的明确确认；本技能不会替创作者确认，也不会把剧本接受状态当作付费生产授权。
+只有安装、升级或排障时运行 `python3 scripts/selftest.py`。

package/lib/drama/skills/short-drama-write/references/dialogue-craft.md

@@ -194,6 +194,13 @@
 
 **`craft_default`**：让说明带着争取目标进入；能由动作或证据表达的部分，不再由两人完整复述。
 
+动作已经让观众看懂机制时，台词优先承担新的工作：改变关系、收窄结论、隐藏态度或迫使下一步。若一句
+话只是逐项复述观众刚看到的因果，删掉后画面仍完整，就让人物回应结果而不是给画面配答案。
+
+过去事件只说当前动作需要的最小片段。若一名角色能不受阻地一口气交代时间、关系与结果，先检查这些
+信息能否被对方打断、质疑、回避或拿来交换；让背景参与当下争取，而不是暂停剧情播放资料。需要完整
+宣读、证词或仪式性讲述时可以保留长段，但其现场作用要清楚。
+
 **`taste_option`**：仪式宣读、审讯、教学、公开声明等场景可以容纳长信息，但仍要有听者反应和权力后果。
 
 ## 6. 人物声音如何区分

package/lib/drama/skills/short-drama-write/references/scene-handoff-capsule.md

@@ -1,51 +1,25 @@
-# 单集分批续写交接胶囊
+# 单集跨上下文交接胶囊
 
-长单集跨多轮写作、上下文即将切换或中断恢复时，用一张短胶囊把“接下来必须记住的变化”
-交给下一轮。胶囊是从当前剧本派生的临时工作记忆，**不是第二份权威**；任何冲突都以
-已接受的 `screenplay.md`、单集契约和连续性来源为准。
+长单集因为上下文限制需要分批续写时，可以在**当前会话上下文**维护一份最小交接摘要。它不落盘、
+不成为第六份创作文档，也不替代 `剧本.md`。
 
-## 何时建立
+## 只记恢复下一段真正需要的内容
 
-- 当前轮无法安全完成整集，但已经写完一个有明确退出状态的场景或场景组；
-- 下一轮只需续写，不值得重新加载整份上游与全部已完成正文；
-- 会话压缩或恢复需要准确找到最后一个已接受块。
+- 当前集号和最后完成的场景 ID；
+- 上一场结束时仍会影响下一场的地点、在场人物、知识、关系、伤势、持物与风险；
+- 已建立但尚未兑现的 setup/payoff；
+- 下一场已确定的功能与 exit state；若它由争取或冲突组织，再记 agenda、opposition 与 turn；
+- 本批仍未解决、会改变下一段写法的真实创作分叉。
 
-短场景、一次完成的单集或只做局部改字时不建立。不要按固定场景数或字数强制分批。
-
-## 最小字段
-
-```yaml
-scene_handoff_capsule:
-  authority: derived
-  sources:
-    screenplay: {owner: short-drama-write, artifact: 剧集/<EP>/screenplay.md}
-  screenplay_ref: {src: screenplay}
-  current_scene:
-    scene_id: EPxxx-SCxxx
-    agenda: 当前人物正在争取什么
-    opposition: 谁/什么正在反制
-    turn: 刚发生的方向变化
-    exit_state: 场景结束后谁能做什么、不能做什么
-  changed_state:
-    story: [知识/关系/权力/风险/决定的变化]
-    physical: [位置/持物/伤势/造型/环境的变化]
-  setup_debt: [仍待兑现或明确放弃的 setup ID/ref]
-  information_permissions: [谁知道/误信/怀疑什么，观众此刻能知道什么]
-  next_scene_pressure: 下一场由哪个已发生结果发动
-  tail_locator: {block_id: <last-accepted-block>}
-  unresolved: [不得由续写者自行补齐的选择]
-```
-
-只记录变化和下一步依赖，不复制整段正文、角色小传、资产 设定集 或所有旧节拍。`tail_locator`
-必须指向当前已接受剧本尾部；如果只完成 candidate，明确保留 candidate authority，不能写成
-accepted。
+只记录变化和下一步依赖，不复制整段正文、角色小传、视觉设定或全部旧节拍。任何信息都要能回到
+当前 `剧本.md` 的场景 ID 核对；胶囊与正文冲突时以正文为准。
 
 ## 恢复步骤
 
-1. 先确认 `sources.screenplay` 指的还是当前剧本；剧本已经改过就丢弃胶囊，重新从当前剧本恢复。
-2. 用 `tail_locator` 读最后一个块及其相邻上下文，确认语气、动作和状态确实对得上。
-3. 读取下一场直接依赖的单集契约、setup/payoff 与连续性引用；不预加载无关 reference。
-4. 写下一场前重新回答 agenda、opposition、turn、exit_state，不能把胶囊里的候选当既定剧情。
-5. 场景发布后重建或删除胶囊：重新从当前剧本派生 `sources` 与 `tail_locator`。
+1. 重新读取当前 `剧本.md` 的最后一个已完成场景及其相邻上下文；
+2. 对照胶囊中的结束状态、未兑现义务和下一场目标，丢弃已经过期的摘要；
+3. 只读取下一场直接依赖的分集规划与连续性事实，不预加载无关 reference；
+4. 写下一场前重新回答它的必要功能与 exit state；冲突场景再回答 agenda、opposition 与 turn，不能把候选想法当既定剧情；
+5. 场景写入正文后刷新上下文胶囊；整集完成后删除它。
 
-胶囊帮助恢复注意力，不替代创作者接受、稳定索引或审查。
+胶囊只帮助恢复注意力。它不代表创作者确认、审查通过或交付状态。

package/lib/drama/skills/short-drama-write/references/screenplay-format.md

@@ -7,17 +7,17 @@
 3. 动作、对白与生产标签
 4. 注释与未知内容
 5. 完整格式示例
-6. 稳定 ID、索引与修订
+6. 稳定 ID、临时索引与修订
 7. 现有文本的规范化入口
 8. 剧本中不应出现的内容
-9. 发布前检查
+9. 完成前检查
 
 ## 1. 设计目标与事实所有权
 
-`screenplay.md` 要能在普通 Markdown 编辑器中直接阅读，同时让下游准确引用场景、动作、对白与生产要求。
+`剧本.md` 要能在普通 Markdown 编辑器中直接阅读，同时让下游准确引用场景、动作、对白与生产要求。
 
 - 它是场景边界、动作、对白和生产指令的**唯一可编辑剧本源**。
-- `screenplay-index.jsonl` 只派生块 ID、位置、类型与内容哈希，不得反向改写正文。
+- 需要时生成的临时索引只帮助识别场景、标签和时长，不得反向改写正文，也不作为项目交付。
 - 卡片和节拍是写作推理材料，不是第二份正文。
 - 资产、分镜、图片/视频提示词与审查结论引用剧本，不在剧本中取得所有权。
 
@@ -139,7 +139,7 @@ Markdown 注释可以保存创作者的非生产备注：
 ```
 
 - 注释原样保留；
-- 派生索引标记为非生产内容；
+- 临时索引把注释标记为非生产内容；
 - 分镜覆盖不把注释当成必拍动作；
 - 生产关键事实不能只藏在注释中；
 - 未识别的 Markdown 原样保留并发出警告，不要擅自删除或“修复”。
@@ -185,9 +185,9 @@ Markdown 注释可以保存创作者的非生产备注：
 - 关键文字、声音与持物交接有明确边界；
 - 没有把摄影或提示词写进故事源。
 
-## 6. 稳定 ID、索引与修订
+## 6. 稳定 ID、临时索引与修订
 
-派生索引应记录：
+需要机器辅助检查时，临时索引应记录：
 
 - 块 ID 与类型（场景标题、动作、对白、生产标签、注释等）；
 - 源文件范围与内容哈希；
@@ -196,13 +196,13 @@ Markdown 注释可以保存创作者的非生产备注：
 - 生产标签类型；
 - 未映射或歧义说明。
 
-索引不得：
+临时索引不得：
 
 - 自动润色或规范化创作者文字；
 - 把显示名称变成另一份权威角色/资产事实；
 - 在拆分/合并歧义时重用错误块 ID；
 - 把注释当成生产动作；
-- 反向覆盖 `screenplay.md`。
+- 反向覆盖当前 `剧本.md`。
 
 邻近文字修改且语义块映射明确时保留块身份。段落拆分、合并或整场重写无法确定时，提出显式重映射选择。
 
@@ -216,7 +216,7 @@ Markdown 注释可以保存创作者的非生产备注：
 4. 展示原文和规范化预览；
 5. 分开报告语义新增、删除、改写、未映射范围与低置信映射；
 6. 让创作者选择接受、修订或取消；
-7. 接受后才发布 `screenplay.md` 与索引。
+7. 确认后才更新 `剧本.md`；索引若用于检查，只写临时目录。
 
 **`structural_invariant`**：取消或拒绝不改变规范剧本；接受前不得把预览当成权威源。
 
@@ -230,20 +230,20 @@ Markdown 注释可以保存创作者的非生产备注：
 - 镜头表、景别、镜头运动或关键帧构图；
 - 图片/视频提示词和生成参数；
 - 模型、任务或接口字段；
-- 审查结论和生命周期状态；
+- 审查结论和内部流程状态；
 - 原始参考材料位置；
 - 用统一数量、比例或篇幅冒充创作规律的说明。
 
-故事真相留在剧本，其他所有者通过块 ID 与哈希引用。
+故事真相留在剧本，其他所有者通过场景 ID、支持标签和必要短引文引用。
 
-## 9. 发布前检查
+## 9. 完成前检查
 
 ### 可机械确认
 
-- **`structural_invariant`**：集/场景 ID 唯一、标题可解析、受支持标签闭合、引用与哈希可解析；
+- **`structural_invariant`**：集/场景 ID 唯一、标题可解析、受支持标签闭合、可见引用可解析；
 - **`structural_invariant`**：明确交接状态与单集卡不冲突；
 - **`structural_invariant`**：未知 Markdown 和注释被保留，未映射范围已报告；
-- **`structural_invariant`**：`screenplay.md` 仍是唯一可编辑剧本源。
+- **`structural_invariant`**：`剧本.md` 仍是唯一可编辑剧本源。
 
 ### 需要审查