Skill Atlas

short-drama-edit

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

分类 工作流仓库 zenstory-ai/drama-skills热度 3679 stars更新 2026-11-02平台 Claude Code · Codex

安装

npx skills add zenstory-ai/drama-skills

收录说明

来自 zenstory-ai/drama-skills(3,679 stars),仓库最近更新 2026-11-02。尚未人工实测。

SKILL.md 原文

# 短剧剪辑与成片

把 `剧集/<EP>/制作成果/` 里的逐镜素材剪辑合成一条成片,取舍依据写进 `剧集/<EP>/剪辑单.md`。
每段使用二级标题 `## CUT-...`,各自绑定一个来源编号和一个真实媒体文件:视频段对应 `MOTION-...` 或 `GROUP-...`,
关键帧或插片静帧段对应 `SHOT-...` 或 `IMG-...`。

## 快速开始

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

## 入口与边界

- **前置条件**:`剧集/<EP>/制作成果/` 中已有可读的视频文件(或关键帧图片与配音文件),且本机 `PATH` 中装有 `ffmpeg` 与 `ffprobe`(缺失时 `edit_tool.py` 直接报错退出)。同宽高比但分辨率或帧率不同的视频素材,`check` 列入提醒并由 `render` 自动缩放及转换帧率至交付规格;宽高比明显不同(如横屏混入竖屏)时报错拦截,需先用外部工具裁切或留边统一画幅。
- **不反向篡改上游定稿文档**:镜序与镜头作用对照 `分镜.md` 与 `视频提示词.md`,对白、VO、OS、场头时空与 `[画面文字]` 对照 `剧本.md`。剪辑阶段可裁短、删减、调序或用 `--partial` 局部试剪,但不回写篡改上游定稿文档,也不擅自加塞无剧本依据的台词。
- **跨阶段分工**:需要补拍、重出或更换参考图转 `$short-drama-produce`;修改提示词转 `$short-drama-video-prompts` 或 `$short-drama-image-prompts`;修改台词或剧情转 `$short-drama-write`;成片审片交 `$short-drama-review` 或创作者把关。

## 工作流

1. **标定可用区间**:从头到尾播放每条素材,记下画面可用的起止秒数及区间外的毛病(开头呆立、结尾走样、画面发白、动作回弹、重复动作),见 [素材检视与入出点](references/editing-guide.md#素材检视与入出点)。
2. **定位台词起止与入出点**:带台词的镜头先听准整句字音起止与句间停顿;在可用区间内按起手动作、表情反应或气口定入点,在画面信息交代完毕且穿帮露头前定出点,逐段写清取舍理由,见 [素材检视与入出点](references/editing-guide.md#素材检视与入出点)。
3. **排定镜序与接镜调色**:核对相邻镜头的动作衔接、空间方位与揭晓顺序;`render` 默认在同场次内执行自动接镜,需要手动微调或关闭校正的段落单独填写 `画面` 行,见 [镜序、镜头下落与打戏切法](references/editing-guide.md#镜序镜头下落与打戏切法) 与 [接镜调色与颗粒](references/editing-guide.md#接镜调色与颗粒)。
4. **处理声音、字幕与画面图文层**:按需配置 `音效`、`配音`、`环境声`、`字幕` 与 `画面文字`(见 [声音字幕与响度](references/editing-guide.md#声音字幕与响度) 与 [Remotion 图文叠加层](assets/remotion/README.md))。
5. **保存、渲染与看片验收**:写出或更新 `剧集/<EP>/剪辑单.md`(未改动段落保留原 `CUT-...` 编号),依次运行 `check`、`render`、`verify`(试剪单场或前几镜时传 `--partial`),按 [成片看片与交付验收](references/editing-guide.md#成片看片与交付验收) 抽帧看画面、回听切点后再交付。

## 剪辑单要求

- **开头交付规格**:写明 `成片目标时长`、`画幅与帧率`、`交付响度`、`字幕`(可按需加写 `接镜匹配:无`、`颗粒:<0–20|无>`)。全集交付时未剪进成片的镜头写 `- 未采用镜头:<MOTION-...、GROUP-...或SHOT-...>(理由:文件缺失|质量不可用|叙事取舍——说明)`,多条用 `;` 分隔(`--partial` 局部试剪时未入片镜头自动归为提醒,见 [镜序、镜头下落与打戏切法](references/editing-guide.md#镜序镜头下落与打戏切法))。
- **分段条目**:每段使用 `## CUT-<EP>-<序号> · <名称>`。同一条 `MOTION-...` 或 `GROUP-...` 拆成多段使用时,源视频截取区间默认不得重叠(同一张静帧图片可跨多段复用):
  - `- 来源:<MOTION-...或GROUP-...> · <项目相对路径>`(对应 `视频提示词.md`),或静帧段 `- 来源:<SHOT-...或IMG-...> · <图片路径>`(支持 png/jpg/jpeg/webp,入点固定 `0.00`,出点等于时长;硬下限为 `2` 帧即 24fps 下 `0.08` 秒,短于 `0.50` 秒列入提醒)。
  - `- 入点:<秒>` / `- 出点:<秒>` / `- 时长:<秒>`:保留两位小数秒数(不写时码或帧号),满足 `出点 - 入点 == 时长`。
  - `- 取舍:入点=<理由>;出点=<理由>`:写清入出点那一帧的具体画面动作与切镜理由,不写空泛的「节奏需要」。
  - `- 重放:<叙事理由>`(可选):当本段与前序剪辑段截取了同一源视频的重叠时间区间(如高潮动作重放、悬念闪回)时填写,显式豁免同源重叠报错。
  - `- 声音:<处理说明>`:记录保留原声或外部混音做法(仅作文字记录,`render` 不会按此行文字自动混音)。
  - `- 画面:<接镜校正|无|不校>`:`无` 采用默认同场自动接镜,`不校` 跳过自动接镜,也可填写手动调色参数(取值范围见 [接镜调色与颗粒](references/editing-guide.md#接镜调色与颗粒))。
  - `- 字幕:<逐字台词原文|无>`:逐字照抄 `剧本.md` 台词与标点(语音转写只用来找时间点,不替代剧本原文)。一段内有多句台词时按顺序连续编号,并写明相对本段入点的起止秒数(各句互不重叠,结束时间可跨入下一镜):`- 字幕 1:0.20-1.50 请进`。句末可加 `(重点:<词>|<词>)` 高亮标黄;字幕颜色由工具按剧本角色自动区分(普通对白白色、`[VO] 系统:` 青色、其余 `[VO]` 浅青色)。
  - `- 画面文字 N:<起>-<止> <样式> <项>|<项>…`:文字内容须在 `剧本.md` 的 `[画面文字]` 行有原文出处(`字卡` 样式还可直接匹配剧本场头 `## EP...-SC...` 中的时间、地点或场景词;组件自带的 `【系统提示】` `【新任务】` `进度` 字样自动绘制,不写进剪辑单;单条可省编号;同屏位置时间段不得重叠):

    | 样式 | 各项结构 |
    |---|---|
    | `字卡` | 干净无游戏外框的通用字幕卡(适合现代都市、古风悬疑等时空地名、人物头衔或关键信息条,支持 1 至多行) |
    | `卡片` | 每项一行数据卡:首词为名称、末词为数值、中间为单位(如 `本月 订单 128|退货 3`) |
    | `系统面板` | 首项为打字机逐字浮现的状态行,其余各项为奖励行 |
    | `任务面板` | 依次为标题、目标(打字机效果);形如 `<数> / <数>` 的项识别为进度条,其余为奖励标签 |
    | `角标` | 右上角单行标签(相邻两段写同一角标且首尾紧接时保持常驻,不重复播入场动画) |

    奖励项末尾可标 `(传说)` `(史诗)` `(稀有)`(不标默认稀有,该后缀不参与剧本原文核对)。`任务面板` 与 `角标` 末尾可加 `(倒计时:<秒>)` 或 `(倒计时:接续)`。
  - `- 音效 N:<起>-<止> <项目相对路径>(起点:<秒>;增益:<dB>)`:时间范围须落在本段之内,增益范围 `-40` 到 `+6`,括号参数可省。
  - `- 运镜:<固定|推近 n%|推近 r%/秒|…>`:仅用于静帧段,方向支持推近、拉远、左移、右移、上移、下移(幅度 `n` 取 `1–30`,速度 `r` 取 `0.1–10`),见 [静帧段与运镜](references/editing-guide.md#静帧段与运镜)。
  - `- 配音 N:<起> <项目相对路径>(起点:<秒>;增益:<dB>;叠音)`:`起` 可填负数提前入声,配音尾音可跨切点延续;短于 `0.50` 秒的自然抢话尾音交叠或括号内注明 `叠音` 时归入提醒而不报错,见 [声音字幕与响度](references/editing-guide.md#声音字幕与响度)。
  - `- 环境声:[<起>] <项目相对路径>(起点:<秒>;增益:<dB>)` 或 `- 环境声:[<起>] 无`:循环铺底直至遇到下一条 `环境声`。

## 命令

命令行工具由 [edit_tool.py](scripts/edit_tool.py) 提供:

```text
python3 <本技能目录>/scripts/edit_tool.py check <剧集/EP001> --project-root <project> [--partial]
python3 <本技能目录>/scripts/edit_tool.py render <剧集/EP001> --project-root <project> [--partial] [--no-subtitles] [--subtitles ffmpeg|remotion] [--remotion-workspace <outside-project-dir>] [--remotion-concurrency N]
python3 <本技能目录>/scripts/edit_tool.py verify <剧集/EP001> --project-root <project>
```

- `check`:检查入出点与时长算术自洽、来源编号与全集镜头下落(`--partial` 时未采用镜头转入提醒)、媒体可读与源片时长边界、同源视频区间不无故重叠(写明 `- 重放` 可豁免)、画幅宽高比一致(同比例异分辨率/帧率归入提醒)、字幕与画面文字匹配剧本原文、倒计时接续合法、音效落在本段内、字幕与配音不越界;素材修改时间晚于剪辑单、短于 `0.50` 秒的快闪静帧及短尾音/显式叠音列入提醒,不阻断试剪渲染。
- `render`:裁切分段、自动缩放并统一同比例素材帧率、生成静帧运镜、同场自动接镜、拼接画面、混入音效/配音/环境声、烧录字幕与画面文字、统一整片响度,输出至 `剧集/<EP>/制作成果/成片/` 并保留分段中间文件。烧录字幕默认走 `ffmpeg`(`libass`);指定 `--subtitles remotion` 或含有 `画面文字` 时调用 [Remotion 图文叠加层](assets/remotion/README.md)(默认并发数为 2)。
- `verify`:实测成片总时长、综合响度与真峰值,列出画面文字、音效与配音在成片中的起止秒数,并标出切点亮度跳变、切点音量跳变与疑似坏帧位置供人工抽帧与回听。

## 按需参考与自检

除上文关联的 [短剧剪辑实务指南](references/editing-guide.md) 外,还可按需查阅:[阶段职责与规则](references/stage-contract.md)(剪辑边界与 `EDT-*` 规则表)、[剪辑单样例](assets/剪辑单.md)。首次安装、升级或排查故障时运行 `python3 {技能目录}/scripts/selftest.py`。

同类技能