# Short Drama Edit

将已生成的短剧镜头剪成成片，记录入出点、镜序、声音、字幕与交付规格。用于套剪、加字幕、统一响度、调整节奏或导出精修素材；需要补素材或修改故事时转回对应创作阶段。

- Repository: https://github.com/zenstory-ai/drama-skills (3625 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add zenstory-ai/drama-skills --skill short-drama-edit -g -a claude-code -y`
Codex: `npx skills add zenstory-ai/drama-skills --skill short-drama-edit -g -a codex -y`
Cursor: `npx skills add zenstory-ai/drama-skills --skill short-drama-edit -g -a cursor -y`
Gemini CLI: `npx skills add zenstory-ai/drama-skills --skill short-drama-edit -g -a gemini-cli -y`

## Description

将已生成的短剧镜头剪成成片，记录入出点、镜序、声音、字幕与交付规格。用于套剪、加字幕、统一响度、调整节奏或导出精修素材；需要补素材或修改故事时转回对应创作阶段。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 短剧剪辑与成片

把 `剧集/<EP>/制作成果/` 里的逐镜素材装配成一条成片，取舍写进 `剧集/<EP>/剪辑单.md`。
每段使用二级标题 `## CUT-...`，各自绑定一个来源 ID 和一个真实媒体文件：视频段是 `MOTION-...`，
静态漫剧的关键帧段是 `SHOT-...` 或 `IMG-...`。

根据实际素材选择可用片段，按剧本与分镜核对叙事。素材与意图不一致时，记录取舍和缺口。

## Quick Start

```text
用 $short-drama-edit 把 EP001 已生产的镜头剪成成片
```

## 入口

进入条件是**素材已经存在且可读**：`剧集/<EP>/制作成果/` 里有本次要用的视频文件；
静态漫剧是已接受的关键帧和配音文件。
先确认本次素材文件可打开，不能仅凭提示词、生产确认或 adapter 成功回执开始剪辑。

素材不全时可以先剪已有连续段落；用户要求完整成片时，将这一版标为片段并列出缺口。
在「未采用镜头」说明缺文件、质量不可用或叙事取舍。

`剧集/<EP>/分镜.md` 与 `视频提示词.md` 是镜序和职责的来源。剪辑可以**取舍**它们，不能**改写**
它们：删一镜、缩一镜、换顺序都属于本阶段；改台词、改镜头职责、改起终状态要回上游发修订请求。

内置渲染直接拼接编码后的分段，输入素材的画幅与帧率须一致。`check` 在可探测媒体时核对；
不同规格先通过外部工具按交付要求统一，保留构图并记录裁切或留边，再更新剪辑单的路径与时间。

渲染与测量需要 `ffmpeg` / `ffprobe` 在 PATH 上。没有时 `edit_tool.py` 直接失败并说明，
不用别的手段近似，也不把「没测」写成「通过」。

## 工作流

1. **逐段看完整素材，先标可用带，再谈剪辑。** 每个文件从头到尾看一遍，写下它实际能用的时间
   区间，以及区间之外发生了什么（起势静止、结尾漂移、发白、动作回弹、多余的重复表演）。
   这一步的产出是事实，不是决定。做法见 [生成素材的可用带](references/generated-footage.md)。
2. **有台词的镜先定位发声区间。** 保留完整字音和所需停顿。视频自带声音随画面同步裁切；
   独立配音文件可用 `配音` 行跨切点播放，分离或替换原视频音轨则先用外部工具处理。
3. **在可用区间内选叙事入出点。** 按动作、反应或停顿的需要选择入点，出点取信息完成之后、缺陷
   开始之前。逐段写清入点理由和出点理由。做法见 [入出点与镜序](references/cut-craft.md)。
4. **排镜序并检查相邻关系。** 检查动作、空间、揭示与声音是否连贯；重复信息没有新增作用时再删。
5. **比较相邻段的画面。** render 会在同一场景内自动接镜；按同场景、同光态比较可比区域，
   自动接镜不够或不该动的段写 `画面`。做法见 [接镜与色彩一致性](references/generated-footage.md#接镜与色彩一致性)。
6. **处理声音接缝与响度。** 拼接后回听；需要混音时通过外部工具执行并记录。
   做法见 [声音、字幕与音乐](references/sound-and-subtitles.md)。
7. **写字幕、画面文字与音效。** 字幕的每一个字都取自 `剧本.md` 的台词原文，不取自转写结果；
   标点照抄剧本，字不能改。转写只用来定位时间。画面留白给后期的 `[画面文字]` 写成 `画面文字` 行，
   需要落在画面文字出现时的提示音写成 `音效` 行。
8. **写出 `剪辑单.md`，再渲染。** 取舍、时间与后期处理先落进文档，成片按这份记录生成。
9. **按可测项验收成片，再交付。** 见 [交付与验收](references/delivery-verify.md)。

## 剪辑单要求

- 正文开头写交付规格：`成片目标时长`、`画幅与帧率`、`交付响度`、`字幕`。目标时长是意图，
  实际时长与目标的差写在报告里。用户明确要求固定时长时，应满足要求或报告缺少的素材。
- 每段一个 `## CUT-<EP>-<序号> · <中文名称>`，块内逐行写：

The rest: https://github.com/zenstory-ai/drama-skills/blob/HEAD/skills/short-drama-edit/SKILL.md