---
name: Short Drama Writing
slug: short-drama-writing
category: Writing
description: "Transforms ideas or outlines into production-ready Chinese short drama screenplays (Markdown) with episode cards and causal beats. Also normalizes and revises existing scripts to enhance performability and consistency while retaining the author's original language."
github: "https://github.com/worldwonderer/drama-skills/tree/main/skills/short-drama-write"
language: Python
stars: 631
forks: 229
install: "npx degit https://github.com/worldwonderer/drama-skills/tree/main/skills/short-drama-write ~/.claude/skills/short-drama-write"
installs_to: ~/.claude/skills/short-drama-write
source_path: skills/short-drama-write/SKILL.md
collection_size: 10
category_size: 1012
collection_url: "https://dirskills.com/collections/worldwonderer/drama-skills"
added: 2026-08-11T07:20:20.715Z
last_synced: 2026-08-11T07:20:20.715Z
canonical_url: "https://dirskills.com/skills/short-drama-writing"
---

# Short Drama Writing

Transforms ideas or outlines into production-ready Chinese short drama screenplays (Markdown) with episode cards and causal beats. Also normalizes and revises existing scripts to enhance performability and consistency while retaining the author's original language.

**Install:**

```bash
npx degit https://github.com/worldwonderer/drama-skills/tree/main/skills/short-drama-write ~/.claude/skills/short-drama-write
```

## README

# 短剧写作

把单集意图写成可表演、可追踪且会改变故事状态的场景。`screenplay.md` 是唯一可编辑剧本源；卡片和节拍帮助推理，不是另一份正文。

## 先定位套件

从本技能目录读取 `suite-ref.json`，按其中相对 `core_manifest` 定位唯一同级主技能与
套件清单；确认声明的 core、contract、recipe 和清单 hash 一致后再读写项目。
随后执行 [阶段契约](references/stage-contract.md) 的运行时预检：先恢复事务、读取状态，再进入本阶段。
该文件同时给出本阶段的所有权边界与规则表；本技能不读取其他技能的文件。

## 先判断入口

1. **有已接受的分集规划**：读取本集进入状态、承诺和交接事实后写作。
2. **只有想法或口述大纲**：在本技能内制作最小单集卡与因果节拍；只有系列方向本身未定时才转 `$short-drama-develop`。
3. **已有规范剧本**：保留作者语言，做定点修订；先说明改动意图和影响。
4. **已有非规范文本，目的是进入后续制作**：保存原始字节；只提议场景标题、对白/动作分块、生产标签与索引所需的最小规范化。展示语义新增、删除、改写、未映射段落与不确定处，得到创作者接受后才能发布。不得补造故事引擎、节拍或新剧情。

## 每次执行

### 1. 读取当前真相

确认创作者约束、已接受的上游事实、本集进入状态和待兑现铺垫。若修订已有剧本，引用当前文件而不是凭对话记忆重写。本阶段拥有什么、继承什么见 [阶段契约](references/stage-contract.md)。

### 2. 确定单集契约的唯一 owner

- **有 accepted `项目开发/episode-map.jsonl` 记录**：复制
  [episode-card.json](assets/episode-card.json)。它只保存上游 artifact/hash/record
  pointer 和写作执行选择；不复制、不改写 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` 不能放裸 ID、路径字符串或复述文本。

### 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、行范围与 source/content hash：

```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`，由 agent 判断应保留为动作、改用 `[画面文字]`，还是补入说话者清单。

规范化预览尚未获 creator acceptance 时加 `--authority candidate`，使 meta、block 与
source issue 的 refs 都保持 candidate；accepted 剧本发布后再以默认 accepted authority
重建，不得只手改状态字段。

修订时同时传 `--previous-index` 和 `--previous-source`。完全相同且唯一的邻近块复用 stable ID；拆分、合并或重复块歧义会写入 `mapping_review_request`，必须显式重映射。索引器绝不改写 `screenplay.md`。

### 5b. 需要配音本时（可选）

创作者要为录音准备台词表时，复制
[voice-record-sheet.jsonl.md](assets/voice-record-sheet.jsonl.md)。它是**剧本的投影，
不是第二份台词权威**：每行逐字等于对应剧本块并绑定其 `hash`，要改词就改剧本再重新投影。

录音顺序几乎从不是剧情顺序（通常按人物集中录），配音者失去的正是上下文，所以每行要补
对谁说、接谁的话、此刻他知道什么、这一句要达成什么。写策略而不是情绪词——"愤怒"不可
执行，"质问"可执行。多音字、生僻字与专名的读法在进棚前定完并留痕；棚里中断是最贵的。

不需要录音时不生成这份文件。本套件不生成音频，也不从这份文本判断成品音质。

写完后用 [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
```

脚本按块 ID 定位、切出剧本原字节、核对内容 hash，再逐字比对台词与说话人。剧本改过而
索引没重建、或有人在表里顺手改了词，都会被单独报出来——**这两种情况下的配音本看起来
和正常的一模一样**，而它被带进录音棚的那一刻正是没人能核对的时刻。

只覆盖部分对白（按人物或按场次分表）是正常做法，未覆盖的块只报告不判错。

### 6. 修订而不是抹平

按顺序做所有者修订：

1. **因果**：选择是否造成后果，转折是否由已存在的压力产生；
2. **场景**：目标、反对、转向、退出是否清楚；
3. **可拍性**：情绪和认知是否有演员能执行的载体；
4. **对白**：每轮是否在争取、回避、试探、逼迫或重新定义关系；
5. **生产事实**：必读文字、画外音、画外对白、关键声音和连续性变化是否有边界标签；
6. **交接**：本集结束的知识、持物、伤势、关系和决定能否成为下一集准确开场。

局部修订保留不相关段落。先展示语义差异与可能失效的下游产物，创作者接受后再发布。

### 7. 交给独立审查

所有者可以发现并修正问题，但不能给自己签发通过结论。完成结构检查后，把当前文件与哈希交给 `$short-drama-review`；若收到带证据的修订请求，只修改本技能拥有的单集卡、节拍或剧本，再请求复审。

## 规则分级

- **`structural_invariant`**：场景/块 ID、引用、已有生产标签语法、来源哈希与明确矛盾；
  校验器可阻断。
- **`reviewed_invariant`**：因果是否成立、场景是否真正转向、内心是否可表演、对白是否改变局面，
  以及生产关键事实是否漏标；独立审查者须引用文本证据。
- **`craft_default`**：进入得晚、退出得早、以选择和后果推动、用具体动作承载情绪；可说明理由覆盖。
- **`taste_option`**：沉默、旁白、方言、打断、场景静动、句式节奏；遵从创作者选择。

不要把统一的爆点安排、转折时刻、台词比例、字数、场景数或节拍数设为质量门槛。

## 产物与边界

本技能只拥有：

- `剧集/<EP>/episode-card.json`（上游 pointer + write execution，或显式
  `write_standalone` 契约；二者不并存）
- `剧集/<EP>/beats.jsonl`
- `剧集/<EP>/screenplay.md`
- 由剧本生成的 `screenplay-index.jsonl`
- 规范化预览与语义修订差异

资产身份、分镜边界、图片/视频提示词及终审结论属于其他技能。本技能不生成媒体。