跳到正文
cccskills
免费在 GitHub 公开

short-drama-edit

Assemble existing short drama footage into a finished video, with documented cut decisions, subtitles, sound effects, and consistent loudness. Check source files and timing before rendering, then measure the exported video for delivery.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

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

实测评分 未实测

查看安装方法

适用场景

  • Assembling generated shots into a finished episode
  • Adding script-based subtitles and sound effects
  • Adjusting pacing and balancing loudness
  • Editing still images with voice recordings

包含的文件(29)

  • SKILL.md14.7 KB
  • agents/openai.yaml254 B
  • assets/remotion/package.json464 B
  • assets/remotion/README.md5.2 KB
  • assets/remotion/remotion.config.ts219 B
  • assets/remotion/src/font.ts2.2 KB
  • assets/remotion/src/index.ts109 B
  • assets/remotion/src/Overlay.tsx1.0 KB
  • assets/remotion/src/Root.tsx931 B
  • assets/remotion/src/rules.mjs7.6 KB
  • assets/remotion/src/schema.ts1.2 KB
  • assets/remotion/src/screen/Card.tsx2.8 KB
  • assets/remotion/src/screen/chrome.tsx5.7 KB
  • assets/remotion/src/screen/CornerChip.tsx1.6 KB
  • assets/remotion/src/screen/ScreenText.tsx1.2 KB
  • assets/remotion/src/screen/SystemPanel.tsx1.8 KB
  • assets/remotion/src/screen/TaskPanel.tsx4.0 KB
  • assets/remotion/src/screen/tokens.ts2.4 KB
  • assets/remotion/src/Subtitles.tsx3.1 KB
  • assets/remotion/tsconfig.json276 B
  • assets/剪辑单.md2.1 KB
  • references/cut-craft.md2.6 KB
  • references/delivery-verify.md2.2 KB
  • references/generated-footage.md3.5 KB
  • references/sound-and-subtitles.md4.2 KB
  • references/stage-contract.md6.0 KB
  • references/still-cuts.md5.8 KB
  • scripts/edit_tool.py128.9 KB
  • scripts/selftest.py25.8 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

短剧剪辑与成片

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

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

Quick Start

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

入口

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

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

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

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

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

工作流

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

剪辑单要求

  • 正文开头写交付规格:成片目标时长、画幅与帧率、交付响度、字幕。目标时长是意图, 实际时长与目标的差写在报告里。用户明确要求固定时长时,应满足要求或报告缺少的素材。

  • 每段一个 ## CUT-<EP>-<序号> · <中文名称>,块内逐行写:

    • - 来源:<MOTION-...> · <项目相对路径>——MOTION-... 必须是 视频提示词.md 里真实存在 的条目,路径必须是当前可读的文件。静帧段写 - 来源:<SHOT-...> · <图片路径>(分镜.md 的镜头) 或 <IMG-...> · <图片路径>(图片提示词.md 的条目),图片为 png / jpg / jpeg / webp; 入点写 0.00,出点等于时长,至少 0.50 秒。静帧按交付规格的画幅与帧率铺满出画, 有静帧时交付规格必须写 画幅与帧率。

    • - 入点:<秒> / - 出点:<秒> / - 时长:<秒>——三者必须自洽,出点 - 入点 == 时长。 全部用秒,保留两位小数,不写时间码,不写帧号。

    • - 取舍:入点=<理由>;出点=<理由>——说明画面上的具体变化及其叙事作用,不只写「节奏需要」。

    • - 声音:<本段声音怎么处理>——记录保留原声或外部处理。此行不驱动内置 render 的混音。

    • - 画面:<接镜校正>、- 画面:无 或 - 画面:不校——校正是「亮度 <数>」「饱和 <数>」「色温 <数>」 三项的任意组合,用 ; 分隔,写了就替代这一段的自动接镜;无 表示不另写校正;不校 表示连自动接镜 也不做。详见 接镜与色彩一致性。

    • - 字幕:<逐字台词原文> 或 - 字幕:无。本段有多句台词时改用编号写法, 每句自带时间:- 字幕 1:0.20-1.50 请进、- 字幕 2:2.30-4.30 门没有锁。 编号从 1 连续,时间相对本 CUT 入点,且不得重叠;止可以超过本段时长(跨切点见 静帧段)。句末可加 (重点:<词>|<词>), 这些词须出现在本句里,烧录时标黄。字色按 剧本.md 里这句的来源决定:对白白色, [VO] 系统: 青色,其他 [VO] 浅青,剪辑单里不另写。

    • - 画面文字 N:<起>-<止> <样式> <项>|<项>…——视频模型写不对字,系统面板、倒计时、屏幕上的 粉丝数在画面里留白,由 render 叠上去。每一项都要能在 剧本.md 的 [画面文字] 行里找到。 单条可不编号;编号与时间规则同字幕。三种面板共用画面顶部,角标在右上角,同一位置不得重叠。

      样式各项的位置
      卡片每项一行:第一个词是名称,最后一个词是数值,中间的词是单位(本月 订单 128|退货 3)
      系统面板第一项是状态行,逐字打出;其余是奖励行
      任务面板标题、目标(逐字打出);其后写成 <数> / <数> 的一项是进度,其余是奖励标签
      角标各项连成一行标签

      奖励可在项末写稀有度 (传说) (史诗) (稀有),不写按稀有;稀有度不是文字,不参与核对。 任务面板 和 角标 末尾可加 (倒计时:<秒>),显示成 4天 23:59:58 并逐秒走动; (倒计时:接续) 接着成片里上一个倒计时走。相邻两段写同一条角标且首尾相接时, 成片里是同一个角标,切镜时不重新入场。面板自带的 【系统提示】 【新任务】 进度 属于样式,不写进剪辑单。

    • - 音效 N:<起>-<止> <项目相对路径>(起点:<秒>;增益:<dB>)——从声音文件的起点(默认开头) 取 止 - 起 秒,混进本段该时刻的原声;括号里两项都可省、顺序不限,增益范围 -40 到 +6。单条可不编号。

    • - 运镜:<固定|推近 n%|推近 r%/秒|…>——只写在静帧段上,方向另有拉远、左移、右移、上移、下移; n 为 1–30 的幅度,r 为 0.1–10 的速度(可带小数),不写按固定。两种写法怎么动、怎么接见 静帧段。

    • - 配音 N:<起> <项目相对路径>(起点:<秒>;增益:<dB>)——从本段 起 秒开始,把声音文件从起点 放到结尾;括号规则同音效。起 可以为负,声音可以跨过切点;跨切点、核对与后期配音的规则见 静帧段。

    • - 环境声:[<起>] <项目相对路径>(起点:<秒>;增益:<dB>) 或 - 环境声:[<起>] 无——从本段 起 秒 (默认 0,可为负)起循环铺一层环境声,直到下一条 环境声;无 让它停下。见 静帧段。

  • 素材里没有被采用的镜头,在正文开头写一行 - 未采用镜头:<MOTION-...>(理由:……), 多项用 ; 连接。理由区分两类:文件缺失(还没生产 / 生产失败)和质量不可用 (生成结果不能用),也可说明叙事取舍。补素材前先判断需要重出还是修订上游。 有静帧段时也可写 SHOT-...;哪些镜头要有下落见 静帧段。

  • 同一个 MOTION-... 可以拆成多个 CUT-...(同一段素材的两处分别使用),也可以整段不用。 不能凭空出现没有素材来源的 CUT-...。

  • 同一视频被用两次时,两个 CUT-... 的源时间区间不得重叠。确需重复出现(闪回、强调)时, 写明重复的意图及第二次的作用;同一静帧可以用于多个 CUT-...。

边界

  • 不生成新素材。 需要补拍、重出、换参考图,回 $short-drama-produce;需要改提示词, 回 $short-drama-video-prompts 或 $short-drama-image-prompts。
  • 不改上游语义。 剪辑单可以让某句台词不出现在成片里(整镜未采用),不能改这句台词是什么。 发现剧本层面的问题就点名报告,交回 $short-drama-write。
  • 沿用剧本的声音设计。 保留已有对白、VO 和 OS,不自行增加解说;需要新增叙述时回写作阶段。
  • 不把技术成功写成质量结论。 渲染完成、时长对上、文件存在,都不是「这条片子能看」。 成片质量的判断交给 $short-drama-review,或交给创作者本人。
  • 按已授权目标完成。 继续修复影响交付的问题;新增创作方向或补素材需求交给创作者决定。

命令

命令由 edit_tool.py 提供:

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

check 只核对不渲染:素材是否比剪辑单新(重出之后字幕、画面文字与音效时间必须重测)、区间自洽、 来源 ID 解析与每一镜的下落、文件存在、区间不越过素材时长、同源区间不重叠、字幕去标点与空白后能在 剧本.md 里找到、 画面文字能在 [画面文字] 行里找到、「接续」之前确有倒计时、音效文件存在且落在本段内、 字幕与配音在整条片里不越过结尾、互不重叠。 其中「区间不越过素材时长」需要 ffprobe,配音的两项需要 ffmpeg;缺哪个就报哪几项「未测」并说明原因, 不静默跳过。 render 按剪辑单切段、静帧按运镜出画、同场景自动接镜、拼接、混入音效、配音与环境声、烧字幕与画面文字、统一响度, 输出 剧集/<EP>/制作成果/成片/。 verify 只测量已经渲染出来的成片并回报数字,另列出画面文字、音效与配音在成片里的起止秒、切点亮度变化和疑似坏帧, 供抽帧和回听;不改文件、不给质量结论。

字幕默认由带 libass 的 ffmpeg 烧录。--subtitles remotion 换成一条排版可调的 路线,代价是装一次 Node 依赖,而且叠层要逐帧过无头浏览器渲整部成片——慢且吃内存, 并发默认压在 2(--remotion-concurrency 可调,调高前先量本机)。画面文字只有 Remotion 一条路线: 剪辑单里有画面文字时,无论字幕走哪条路线 render 都需要它,没装就报错并给出安装命令; 走 ffmpeg 的字幕压在画面文字之上。取舍见 声音、字幕与音乐, 装法见 Remotion 叠层。

render 保留中间文件;声音 行只记录方案,不驱动处理,也不会按交付规格自动转换视频的画幅或帧率。 需要额外混音、逐镜字幕避让、转场或视频规格转换时,用外部工具完成并记录,再验收实际交付文件。

按需知识

先读本 SKILL、当前分镜、视频提示词和素材;有字幕时读取剧本原文。按需要打开参考资料:

修订

保留未受影响的 CUT-... ID。改一段的入出点不触碰其它段;删一段时说明它承担的信息由哪一段 接住,或明确说明这条信息在成片里不再出现。重新渲染前先更新剪辑单,不要让成片领先于文档。

完成

每个 CUT-... 都绑定真实素材与自洽区间,台词在成片里完整可听,字幕逐字等于剧本原文, 剪辑点没有可听的音床硬切,成片响度落在交付目标上,未采用镜头都写明理由并区分了缺文件与缺质量, 即完成。目标时长与实际时长的差、以及仍然值得再剪一版的地方,写在末尾报告里交给创作者判断。

安装维护

只有安装、升级或排障时运行 python3 scripts/selftest.py。

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Set up and continue short drama or comic-style video projects with organized creative documents, a local progress dashboard, and clear handoffs between stages. Export existing scripts, visual plans, prompts, and finished media for sharing.

中文简介正在准备中。当前显示英语简介。

  • Starting a short drama project
  • Checking episode progress and next steps
  • Choosing a visual direction
zenstory-ai/drama-skills33002026年10月21日 更新

Turn a short drama script into readable visual specifications for characters, outfits, locations, and props. Distinguish reusable identities from changing states, and document visible details that need to remain consistent across scenes and episodes.

中文简介正在准备中。当前显示英语简介。

  • Listing characters, locations, and props from a script
  • Deciding whether to reuse an asset or add a variant
  • Tracking costume, injury, and prop state changes
zenstory-ai/drama-skills33002026年10月21日 更新

Turn Chinese novels, story ideas, series notes, or existing scripts into adaptation plans and episode outlines. Clarify character conflicts, how the story keeps moving, and what each episode must carry into the next.

中文简介正在准备中。当前显示英语简介。

  • Planning a short drama adaptation of a Chinese novel
  • Developing an idea into a series plan
  • Clarifying character conflicts and story progression
zenstory-ai/drama-skills33002026年10月21日 更新

Create copyable image prompts for short drama characters, outfits, locations, props, and changing states. Organize them in Markdown with clear reference limits and visual constraints, so creators can reuse and revise consistent production instructions.

中文简介正在准备中。当前显示英语简介。

  • Prepare prompts for character sheets and three-view drawings
  • Write prompts for location and prop reference images
  • Describe outfit changes and character state variants
zenstory-ai/drama-skills33002026年10月21日 更新

Help maintainers study authorized short drama project documents and develop reusable production guidance. Record evidence and counterexamples, remove identifying details, create original test examples, and evaluate proposed guidance through blind testing and independent review.

中文简介正在准备中。当前显示英语简介。

  • Studying how story intent becomes production instructions
  • Comparing evidence, counterexamples, and limits of a technique
  • Preparing anonymized guidance and original test examples
zenstory-ai/drama-skills33002026年10月21日 更新

Analyze long novels or serialized fiction for adaptation into vertical short dramas. Produce chapter references, character and setting summaries, story and emotional beats, adaptation assessments, and episode candidates that creators can review before choosing an approach.

中文简介正在准备中。当前显示英语简介。

  • Assessing whether a novel suits a short drama adaptation
  • Mapping characters, settings, and story developments
  • Finding episode boundaries from dramatic turning points
zenstory-ai/drama-skills33002026年10月21日 更新

查看 zenstory-ai 的全部技能

报告此技能的问题