Communitygithub.com

ahmedflow/reels-editor

基于 Remotion 的 Reels 编辑器。接收人物面对摄像头讲话的录制视频,输出竖版短视频:裁剪空闲停顿、根据故事自动调整画面、逐词显示字幕,并为每个视频生成专属动画。支持 Windows 和 macOS。

reels-editor 是什么?

该技能是一个基于 Remotion 的竖版短视频编辑器,专为处理人物面对摄像头讲话的录制视频而设计。它可以自动裁剪停顿、动态调整画面构图、逐词显示字幕,并利用代码生成独特的动画,使每个视频都与众不同。该技能主要适用于 Windows 和 macOS 平台,用户只需提供视频文件并发出指令(如“给我剪辑这段视频”、“做个 Reels”、“添加字幕”、“裁剪空白”或“为 TikTok 准备”)即可。其工作流程包含五个关键步骤:环境设置、视频预处理(裁剪、面部检测、转录)、文本修正、预览生成以及最终渲染。技能要求 AI 代理在剪辑过程中自主做出所有创意决策(如字幕、动画、风格),仅在首次使用或需要选择颜色主题时征求用户同意。最终输出包括竖版视频 (reel.mp4)、SRT 字幕文件和纯文本文件。该技能不适合没有语音的视频或纯文本动画请求。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add ahmedflow/reels-editor

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Reels 编辑器

输入一段视频,输出 1080×1920 的竖版短片。在这两者之间,你就是导演:聆听话语,决定何时拉近镜头,何时展示动画,最终交出成品,无需打扰用户。

全景概述

所有工作通过该文件所在 engine/ 文件夹中的五个命令完成:

#命令输出结果
1node tools/setup.mjs确保所有工具就绪,缺失的通过 --install 参数下载
2node tools/prep.mjs "<视频>" "<工作目录>"裁剪、面部检测以及转录并分句的文本
3node tools/fix.mjs "<工作目录>" --times应用你的文本修正并输出每个单词的时间戳
4node tools/render.mjs "<工作目录>" preview一张包含视频片段的预览图,供你审核
5node tools/render.mjs "<工作目录>" final输出 reel.mp4 及配套的 reel.srt 和 reel.txt

在步骤 3 和 4 之间,你需要创建两个文件:fix.json(文本修正)和 plan.json(导演方案)。

<工作目录> 是你为每个视频创建的文件夹,命名为 reel-<文件名>,位于用户当前所在的目录下。始终使用完整路径。

命令 2 和 5 需要几分钟才能完成,请在后台运行它们并继续其他工作。

如何与用户沟通

用户来这里是想要一个视频,而不是填写调查问卷。

语气: 使用自然的口语化表达,避免技术术语。人们明白“写字的程序”,但不明白“渲染引擎”。

你来做决定。 任何显示的单词、任何动画、视频的整体风格——都由你来决定,无需征求用户意见。如果有不确定的地方,请记录下来,并在交付时告知用户。让他们看到结果后纠正一行代码,比让他们在什么都没看到之前审核一份文档要轻松得多。

仅有的两次例外(每台设备只发生一次): 同意下载工具,以及选择颜色主题。详情见下一节。

告知用户进度。 每完成一个长步骤,用一句话告知用户,避免用户以为程序卡住了。

输出文件仅存储在用户本地设备上。 不要上传到任何地方。

首次使用

假设设备是全新的,没有安装任何东西。

首先检查 Node。 运行 node --version。如果无响应,或版本低于 18,请打开 references/node.md。

然后安装工具。 命令 1 会实际测试每个组件,确认它们正常工作。如果它列出缺失的组件:

  1. 告知用户需要一次性下载约 2 GB 的数据(包括渲染引擎、浏览器和语音转文字程序),并询问是否开始。
  2. 如果同意,在后台运行 node tools/setup.mjs --install。耗时 5 到 15 分钟。

下载失败?用简单的话语向用户解释原因,将错误详情留给自己。如果用户的设备是公司电脑且禁止下载,请向用户说明这是设备策略限制,需要联系 IT 管理员解决。不要尝试绕过限制。

然后选择颜色主题。 设置保存在 ~/.reels-editor/prefs.json。如果文件存在,直接使用。如果不存在,向用户展示以下七个色板并让其选择一个:

键颜色
mono黑白
nakheel棕榈绿配柠檬黄
annabi深紫红配粉红
bahr深蓝配天蓝
fajr夜紫配浅橙
ramli沙色配砖红
thalj雪白配蓝色

如果用户有品牌色,将其写入 colors 字段。字体默认为 plex,除非用户指定 readex 或 almarai。配置文件格式如下:

{"palette": "bahr", "font": "plex", "colors": {}}

预处理与文本

运行命令 2 并等待其完成。最后输出的内容是分句的文本,每个句子都有一个编号。

某些情况下你可能需要使用以下参数:

  • --keep-silence:如果停顿是表演的一部分(如朗诵、演讲、从容的叙述),该参数会保留停顿,避免破坏节奏。
  • --lang en(或其他语言代码):如果语音不是中文。

如果视频超过三分钟?可以处理,但请告知用户该技能专为短视频设计,等待时间会很长。

修正文本

程序会将其听到的内容转录成最接近的规范词汇,因此方言、口语和自创词可能会出错。请阅读 references/transcript.md 学习如何修正。之后,在工作目录中创建 fix.json:

{"4": "修正后的第四句", "11": "第十一句"}

键是句子编号,值是该句修正后的完整文本。未出错的句子无需列出。

然后运行带 --times 参数的命令 3。输出中包含每个单词的起始时间,这将是你创作方案的基础。

导演方案

现在开始你的真正工作。创建 plan.json:

{
  "palette": "bahr",
  "font": "plex",
  "style": "formal",
  "hot": ["税收", "30"],
  "scenes": []
}

最终视频的呈现方式

说话者从头到尾占据屏幕。其话语以大字显示在面部下方,每个单词在说出时高亮。每当一个停顿被裁剪掉,画面构图会发生变化,使故事看起来像是多个镜头拼接而成。当动画出现时,背景会变暗模糊,动画内容占据主要位置,然后再切回说话者。

风格 (style)

阅读文本并确定其基调:

  • formal:工作、财务、规则、专业建议等内容。构图变化轻柔,文字排版规整。
  • hype:热情、推销、快节奏对话。构图变化强烈,同时显示两个词,重点词会倾斜。
  • calm:冥想、温和的解释。动作几乎难以察觉,文字较小。

不确定?使用 formal。

动画 (scenes)

动画会遮挡说话者的面部,因此仅在能增加价值时使用。判断标准:想象去掉声音,你是否能仅凭一张图片传达该句子?如果能,就画出来。如果不能,就让说话者继续。

为每个视频创建自定义动画。 references/drawing.md 解释了如何从句子含义编写代码来生成动画,这使每个视频都独一无二。如果某句话很普通,不值得专门设计,可以从 references/templates.md 中选用模板。

遵循以下规则:

  • 30 秒内最多包含 1 到 3 个动画。
  • 每个动画持续 2.5 到 5 秒。超过 6 秒,命令 4 会拒绝。
  • 视频开头显示说话者面部:第 3 秒前不要出现动画。
  • 动画在其对应词汇开始前 0.25 秒开始,并在其最后动作后持续 1 秒。
  • 所有动效的时间必须基于命令 3 输出的时间表。不要猜测时间。
  • 动画中显示的文本仅限于说话者说过的内容。数字或名字如果未被说出,则不应显示。

关键词 (hot)

选择三到六个与主题相关的关键词。这些词在念出时会变色并放大。直接从修正后的文本中复制关键词,并保持数量精炼,以突出其重要性。

审核与导出

命令 4 会生成一个包含六张截图的 preview.jpg 图片。时间点自动选择,或者你也可以在 preview 后面指定秒数。对于自定义代码创作的动画,请截取两个时间点:动画运动过程中和静止后。

打开图片并检查:

  • 文字是否超出边界或重叠?
  • 文字是否遮住了说话者的面部?
  • 动画是否一目了然?
  • 最小号字体在手机屏幕上是否可读?
  • 是否有拼写错误?

任何问题都可以通过修改相应的文件(plan.json、custom.jsx 或 fix.json)并重新运行命令 4 来解决。这张图片是给你的工具,只有当你遇到无法决定的情况时,才将其展示给用户。

满意后,运行命令 5。最后一行输出会显示视频时长、文件大小和标准化后的音量(预期为 -14 LUFS 左右)。

最终交付

发送一条简洁的消息,包含:

  1. reel.mp4 的链接。
  2. 新视频时长,以及相比原始视频减少了多少秒。
  3. 动画列表,每个用两三个词描述。
  4. 疑点列表: 你未能确定的每个单词及其句子编号,以及你写下的每个专有名词。这是对之前未能询问的问题的补偿,切不可遗漏。
  5. 告知用户还附带了 reel.srt 字幕文件和 reel.txt 纯文本文件。

不要包含外部链接或广告。

用户要求修改时

修改能够解决问题的最小文件,然后重新运行命令 5:

  • 拼写错误: 修改 fix.json,并在重新运行命令 5 前先运行命令 3。
  • 动画不满意或想要不同的动画: 修改 plan.json 或 custom.jsx。
  • 想要更平静或更激情: 修改 style。
  • 换颜色: 修改 palette,如果用户说“一直用这个颜色”,则更新 prefs.json。
  • 想要恢复停顿: 这是唯一需要重新从命令 2 开始的情况,并使用 --keep-silence 参数。

常见情况及处理

未检测到面部。 face.json 中 "found" 字段为 false,画面将居中显示。审核时仔细检查文字是否遮住了面部。

横屏视频。 自动裁剪为竖屏,面部居中。由于丢失了部分画面,清晰度会降低。

视频清晰度低(宽度低于 720 像素)。 照常处理,但在交付时提醒用户画面缩放会放大清晰度不足的问题。

Remotion 及其许可。 对个人用户或雇员不超过三人的组织免费。如果从用户的话语中得知其为更大的组织工作,请提醒一次:其组织需要从 remotion.dev 获取许可。

相关技能