跳到正文

AI 短剧分集剧本

围绕单集目标与因果节奏编写可供后续分镜使用的短剧剧本。

开源精选视频内容23 个文件2,909 Stars浏览次数 0zenstory-ai/drama-skills MIT版本 f53fb20
开始使用

下载前阅读 SKILL.md 中的使用条件,并确认所用工具支持对应能力。

输入资料
故事设定与分集目标 角色和当前剧情 阅读本节完整说明
交付内容
分集剧本 后续制作所需的剧情事实 阅读本节完整说明
环境与依赖
只有安装、升级或排障时运行 python3 scripts/selftest.py。 阅读本节完整说明
  1. 获取完整包,保留配套文件的目录结构。
  2. 按照原文准备所需工具、依赖与输入资料。
  3. 阅读对应使用步骤与输入输出说明,在自己的环境中验证结果。

使用提示摘自原文,配套文件保留来源版本;实际运行条件以各包说明为准。

正文

获取原文件

references/screenplay-format.md

目录

  1. 设计目标与事实所有权
  2. 文件、集与场景结构
  3. 动作、对白与生产标签
  4. 注释与未知内容
  5. 完整格式示例
  6. 稳定 ID、临时索引与修订
  7. 现有文本的规范化入口
  8. 剧本中不应出现的内容
  9. 完成前检查

1. 设计目标与事实所有权

剧本.md 要能在普通 Markdown 编辑器中直接阅读,同时让下游准确引用场景、动作、对白与生产要求。

  • 它是场景边界、动作、对白和生产指令的唯一可编辑剧本源。
  • 需要时生成的临时索引只帮助识别场景、标签和时长,不得反向改写正文,也不作为项目交付。
  • 卡片和节拍是写作推理材料,不是第二份正文。
  • 资产、分镜、图片/视频提示词与审查结论引用剧本,不在剧本中取得所有权。

规则权限:

  • structural_invariant:标题语法、稳定 ID、受支持标签、来源范围与显式矛盾;校验器可阻断。
  • reviewed_invariant:动作是否可表演、语义是否被规范化过程改变;审查者引用证据判断。
  • craft_default:现在时、经济动作、可执行表演提示;可由创作者说明理由覆盖。
  • taste_option:对白口语度、旁白、沉默、动作段落长短与风格化形式;只记录选择。

2. 文件、集与场景结构

2.1 集标题

# EP001 【集名】

EP001 是稳定集 ID。修改集名不改 ID。

2.2 场景标题

## <场景ID> <内|外|内外> · <地点> · <时间/天气>

示例:

## EP001-SC003 内 · 渡口售票室 · 雨夜
  • 场景 ID 在同一项目中唯一且稳定;
  • “内/外/内外”说明主要行动空间;
  • 地点使用创作者可识别名称,不写资产内部编号;
  • 时间/天气只保留对表演、光线、行动或连续性有用的事实;
  • 修改显示名称不改 ID;真正新建场景才分配新 ID;
  • 拆分/合并后无法明确映射时,展示映射选择,不能静默猜测。

structural_invariant:生产场景必须有可解析的稳定场景 ID、空间性质、地点和时间/天气字段。

3. 动作、对白与生产标签

3.1 动作段落

普通段落表示现在发生、可见或可表演的行动:

游森把湿透的末班票压在玻璃下,手指仍挡着日期。

写作要点:

  • craft_default:使用现在时与可执行动词;焦点行动、信息或空间关系变化时另起段落。
  • reviewed_invariant · SCR-03:关键心理/认知变化要有行为、证据、空间后果或有意声音作为载体。
  • taste_option:完整动作链、氛围或推理可以保留较长段落,不按统一长度切分。
  • craft_default · SCR-18:动作段落不要以「短语+全角冒号」开头。 第二格:一只手把杯子推过去。 与 屏幕上正在放的东西:一段没有声音的录像。 这样的写法 和 3.2 的对白语法(角色名:台词)在字面上完全一样,索引器只能报 ambiguous_dialogue_or_action 交回本阶段判断,而它每次都要人来读一遍才能消掉。 改法是把冒号换成破折号、逗号或一个动词:第二格换成一只手把杯子推过去。 屏幕上正在放的是一段没有声音的录像。 句中的冒号不受影响,只有行首这一处会撞。

不要在动作段落里写镜号、景别、镜头运动、焦段、生成参数或素材位。

3.2 对白

角色名(可选的表演/策略提示):台词

示例:

葛晴(不让门外的人听见):你卖的是明天的票。

游森:你先说,今天那班船去了哪里。
  • 角色名与说话者必须明确;
  • 建索引前由 write owner 语义确认本集说话者清单;确定性工具只核对清单,不从冒号前缀猜人物;
  • 提示描述一个可执行策略或变化,不堆叠同义情绪词;
  • 台词跨段确有必要时保持说话者清楚;
  • 现场不可见说话者使用 [OS],非现场主观/叙述声音使用 [VO]。

reviewed_invariant · SCR-04:对白质量由议程、关系、潜台词与造成的变化判断,不由长度或比例判断。

3.3 生产标签

只在事实对故事不可省略时使用:

[VO] 葛晴:我那时还不知道,票背面的孔不是验票留下的。
[OS] 船员:关窗,水进来了!
[SFX] 远处传来一声短促汽笛。
[画面文字] 票面日期:11月6日
[连续性] 游森把黄铜钥匙交到葛晴左手;下一场仍由葛晴持有。
[转场] 汽笛声延续到清晨的空码头。

标签含义:

标签 用途 不应用来做什么
[VO] 非现场主观/叙述声音 隐藏普通可见行动
[OS] 同一场景中的画外对白 代替明确说话者
[SFX] 改变注意、行动或信息的声音 罗列全部环境声
[画面文字] 观众必须读清的载体与精确内容 复制一般道具说明
[连续性] 易丢失且影响后续的状态变化 把整套人物设定贴入每场
[转场] 有叙事意义的转场要求 编写剪辑方案全集

structural_invariant · SCR-05:已存在的生产标签必须使用受支持、可闭合的语法, 并且 source reference 可解析;标签不得互相冒充。校验器只证明“已写标签是合法的”。

reviewed_invariant · SCR-07:reviewer 要对照剧情意义,检查必读文字、 VO/OS、改变行动/信息的关键声音、有叙事意义的转场与易丢连续性事实有没有 被遗漏。这是语义判断,不能由关键词扫描代替。

4. 注释与未知内容

Markdown 注释可以保存创作者的非生产备注:

<!-- 待确认:渡口停运年份是否影响下一集时间线。 -->
  • 注释原样保留;
  • 临时索引把注释标记为非生产内容;
  • 分镜覆盖不把注释当成必拍动作;
  • 生产关键事实不能只藏在注释中;
  • 未识别的 Markdown 原样保留并发出警告,不要擅自删除或“修复”。

structural_invariant:规范化 mapping 必须报告每个未映射 source span,不能静默丢字节。 该 span 是否生产关键,仍由 reviewer 根据 SCR-07 判断。

5. 完整格式示例

以下为新写的格式示意,只展示语法与可见动作:

# EP001 明天的末班票

## EP001-SC003 内 · 渡口售票室 · 雨夜

售票窗已经落锁。游森从退票口塞进一张湿透的船票,手指压住日期。

葛晴没有接票。她先把窗口旁的时刻牌翻到背面。

葛晴(不让门外的人听见):末班船半小时前就停了。

游森:所以这张票不是今晚的。

葛晴抽出票角。票背面有两个新打的圆孔。

[画面文字] 票面日期:11月6日

[SFX] 河面传来一声汽笛。

游森回头看向已经熄灯的码头,把黄铜钥匙留在退票口。

游森:你要答案,就替我开那道门。

[连续性] 黄铜钥匙留在售票窗内侧,由葛晴取得。

它遵循:

  • 压力在开场前已经发生;
  • 信息通过票、日期、时刻牌与人物行动出现;
  • 台词各自有议程;
  • 关键文字、声音与持物交接有明确边界;
  • 没有把摄影或提示词写进故事源。

6. 稳定 ID、临时索引与修订

需要机器辅助检查时,临时索引应记录:

  • 块 ID 与类型(场景标题、动作、对白、生产标签、注释等);
  • 源文件范围与内容哈希;
  • 所属集/场景;
  • 上一版本映射与置信状态;
  • 生产标签类型;
  • 未映射或歧义说明。

临时索引不得:

  • 自动润色或规范化创作者文字;
  • 把显示名称变成另一份权威角色/资产事实;
  • 在拆分/合并歧义时重用错误块 ID;
  • 把注释当成生产动作;
  • 反向覆盖当前 剧本.md。

邻近文字修改且语义块映射明确时保留块身份。段落拆分、合并或整场重写无法确定时,提出显式重映射选择。

7. 现有文本的规范化入口

创作者提供其他格式时:

  1. 将原始字节保存为 输入/original-script.<ext>;
  2. 记录原编码与来源说明;
  3. 只提议场景标题、动作/对白边界、支持标签与索引所需的最小变化;
  4. 展示原文和规范化预览;
  5. 分开报告语义新增、删除、改写、未映射范围与低置信映射;
  6. 让创作者选择接受、修订或取消;
  7. 确认后才更新 剧本.md;索引若用于检查,只写临时目录。

structural_invariant:取消或拒绝不改变规范剧本;接受前不得把预览当成权威源。

reviewed_invariant:改变说话者、行动先后、事实、因果、态度或未说内容都属于语义变化,即使句子看似只被“整理”。

规范化入口不需要创作简报、故事引擎或新增节拍,也不得为了字段完整补造剧情。

8. 剧本中不应出现的内容

  • 人物、场景、道具的完整资产说明;
  • 镜头表、景别、镜头运动或关键帧构图;
  • 图片/视频提示词和生成参数;
  • 模型、任务或接口字段;
  • 审查结论和内部流程状态;
  • 原始参考材料位置;
  • 用统一数量、比例或篇幅冒充创作规律的说明。

故事真相留在剧本,其他所有者通过场景 ID、支持标签和必要短引文引用。

9. 完成前检查

可机械确认

  • structural_invariant:集/场景 ID 唯一、标题可解析、受支持标签闭合、可见引用可解析;
  • structural_invariant:明确交接状态与单集卡不冲突;
  • structural_invariant:未知 Markdown 和注释被保留,未映射范围已报告;
  • structural_invariant:剧本.md 仍是唯一可编辑剧本源。

需要审查

  • reviewed_invariant:关键心理意义有可表演载体;
  • reviewed_invariant:场景有议程、反对、转向与退出;
  • reviewed_invariant:规范化没有隐藏语义变化。

创作者选择

  • craft_default:动作经济、现在时、生产事实不过度标记;可说明理由覆盖;
  • taste_option:旁白、沉默、语言风格、场景疏密和动作段落长度被保留。

写作所有者可做以上检查与修订;需要 verdict 时另起审查动作。未参与写作的 reviewer 更能 减少自证偏差,但诚实标注的自检也可记录任何有证据支持的结论。

CONTACT HAONAN

联系haonan

医疗 AI · 产品与独立开发

刘浩南

关注医疗 AI 从 demo 到真实落地,聚焦产品化、商业化与院内工作流效率提升。

12年医疗产研经验,大湾区头部医疗AI公司前产品总监,独立开发者

医疗 AI 产品化医疗 AI 商业化院内工作流效率
刘浩南的微信联系二维码
微信扫一扫,联系 haonan