Communitygithub.com

Reels模板工具包

使用本工具包内置的十五个现成Remotion模板,一键将素材、照片或创意简报制作成9:16比例的视频,适用于Reels/TikTok广告。

Reels模板工具包 是什么?

Reels模板工具包是一个专为自主AI代理设计的技能,用于快速生成9:16竖屏短视频。它内置了十五个基于Remotion的数据驱动模板,包括社交原生格式(如聊天故事、笔记列表、搜索栏、锁屏通知等)和广告格式(如节拍剪辑、UGC字幕、列表清单、前后对比等)。用户只需创建一个JSON作业文件,选择模板、填充属性,即可渲染出60fps、1080x1920的视频,无需手动编写React代码。该工具包支持全自动运行、多语言本地化、批量渲染,并包含了自动清理空间的功能。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/du-nguyen-IT007/remotion-reels-skills/tree/HEAD/skills/reels-templates

在你喜欢的 AI 中提问

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

文档

Reels模板

本技能内置了十五个数据驱动的Remotion模板(1080x1920,60 fps),位于 assets/reels-kit/ 中。一个视频对应一个JSON作业文件:选择模板,填写其属性,然后渲染。日常作业无需编写React代码。

以下以 reels/ 开头的路径位于工作文件夹中,而非本技能文件夹内。请勿为作业编辑技能文件夹内的文件。

无人值守运行。 本技能专为自主代理设计。请求者 是启动作业的人:一个协调代理、一个管道或一个人。根据本文件中的规则做出所有决策,永远不要停下来请求批准某个步骤。仅在遇到无法解决的阻塞问题时才停止(例如缺少工具、媒体文件缺失或无法读取、渲染持续失败),并报告问题。每个作业都以一份报告结束(第4节)。

0. 设置工作区

每个项目只需执行一次,在第一个作业之前。

  1. 检查工具:Node.js 18 或更高版本(node -v),以及 ffmpeg 和 ffprobe 是否在PATH环境变量中。如果缺少某一个,请停止并报告为阻塞问题。不要自行安装系统软件。
  2. 如果工作文件夹中已有 reels/render.mjs,则使用该工作区并跳转到第1节。
  3. 否则,将本技能的 assets/reels-kit/ 文件夹复制到工作文件夹的 reels/ 目录下(例如 cp -R <skill-dir>/assets/reels-kit reels),然后在 reels/ 目录内运行 npm install。
  4. 创建文件夹 reels/public/(媒体文件)和 reels/jobs/_local/(临时作业)。如果工作文件夹是一个Git仓库,请将 reels/node_modules/、reels/public/、reels/out/、reels/exports/ 和 reels/jobs/_local/ 添加到其 .gitignore 文件中。

工作区包含 render.mjs(渲染作业)、clean.mjs(释放磁盘空间,见第6节)、src/(模板和共享工具包)、jobs/examples/(每个模板一个示例作业)、public/<name>/(每个作业的输入媒体)、out/stills/(QA静态图片)和 exports/<name>/(每个作业的最终视频)。

偏好设置

此仓库不包含任何人的偏好。文本样式、字体、强调色、文案语气、语言、音乐以及优先使用哪种格式,都来自请求者的简报以及您已经了解的品牌信息,绝不来自模板或此文件中写入的值。当简报中规定了偏好时,请在作业文件中应用它。当简报未规定时,请使用模板默认值并在报告中列出。不要将个人或品牌的偏好写入模板、示例作业或本技能中。

1. 选择模板

当视频应感觉像是某人发布的内容时,从社交原生格式开始。当素材本身承载视频内容时,使用广告格式。

社交原生格式(观众已经熟悉的界面是吸引点)

模板何时使用需要提供
ChatStory通过短信聊天记录讲述一个故事,然后展示产品消息(+一张产品照片用于发送)、收尾片段
NotesList一个笔记应用列表,自动逐字打出:"失败的礼物 vs 她留下的那个"标题 + 1 到 7 行,收尾片段
SearchHook将客户的问题输入搜索栏,由素材给出答案一个查询(+ 建议),1 个或多个片段
NotificationStack锁屏上充满订单、消息、评论:社会证明和错失恐惧症1 到 6 条通知,背景,收尾片段
PolaroidDump剪贴簿照片墙,附有手写说明2 到 8 张照片
Ranking盲排名:项目按顺序落入编号列表,第一名最后2 到 6 个片段,每个片段一个标签和排名
PollSticker在素材上添加故事投票:两个选项,点击,显示结果一个问题,2 个选项及其百分比,片段

广告格式(素材优先,文字叠加其上)

模板何时使用需要提供
BeatCutAd默认用于从素材剪辑的产品广告:多个镜头、钩子、行动号召1 个或多个视频片段
UgcCaptions有人对着镜头说话;逐字字幕1 个带语音和单词时间码的片段
Listicle"三大理由"、技巧、功能、步骤2 到 7 个片段,每个对应一个要点
BeforeAfter展示转变或对比(mode:wipe 或 split)2 个片段或照片
ProductSlideshow只有产品照片,或快速目录;可选的价签贴纸2 张或更多照片或片段
Testimonial社会证明:带星级的评论卡片1 个背景片段 + 评论文字
CommentReply回答异议或常见问题;评论气泡是吸引点1 个或多个片段 + 评论内容
OfferPromo促销、折扣码、截止日期1 个或多个片段 + 优惠信息

如果简报不适合任何模板,请参见第7节。不要强行使用模板做它不擅长的事情。

官方的Remotion技能(remotion-best-practices,通过 npx skills add remotion-dev/skills --skill remotion-best-practices 单独安装)是编写Remotion代码的参考。如果未安装,请使用Remotion文档 https://www.remotion.dev/docs。对于在此仓库中制作视频,当两者有差异时,以本技能为准:构建作业文件而不是新项目或组合,检查静态图片而不是打开Studio,并且一旦静态图片通过就使用 render.mjs 渲染,无需等待指令。

2. 构建作业

  1. 选择作业名称(小写字母、数字和 -,例如 xmas-ornament)。它将成为作业文件的 name,输入文件夹 reels/public/<name>/ 和输出文件夹 reels/exports/<name>/。仅复制此作业使用的文件到 reels/public/<name>/,并保留原始文件在原来位置。在报告中注明每个输入的来源,以及 public/ 中的副本是否是唯一副本(下载或生成的文件)。将每个 src 写为 <name>/<file>。对每个文件运行 ffprobe 以获取其时长。媒体文件永远不会被提交到版本控制:public/ 被git忽略,因此示例作业中的路径(footage.mp4、music.m4a、demo/…)在您放置自己的文件之前都是占位符。
  2. 在放置文字前检查素材:为每个镜头提取一帧(ffmpeg -ss <t> -i <file> -frames:v 1),并记下产品的位置。
  3. 阅读 reels/jobs/examples/<Template>.json。它列出了该模板接受的每个属性。将其复制到 reels/jobs/<job>.json 并进行编辑。对于应保持在Git之外的作业,请使用 reels/jobs/_local/。

作业文件:

{ "template": "BeatCutAd", "name": "xmas-ornament", "lang": "en",
  "props": { },
  "i18n": { "ja": { "hook": { "lines": ["…", "…"] }, "cta": { "lines": ["…"], "button": "…" } } } }

i18n.<lang> 将覆盖 props,因此它只包含已翻译的字符串。对象数组合并逐项进行(null 保留基础项);字符串数组则替换。

每个模板共享的属性:

  • hook:{ lines (1-3), band, size, duration }。从0秒开始显示,默认2.2秒。
  • cta:{ lines, button, band, size, duration }。在最后 duration 秒内显示,默认2.5秒。其他字幕在它开始播放时结束。
  • music:{ src, volume }。在末尾淡出。在有语音时使用大约0.15的音量。
  • brand:{ accent (hex), font: poppins | montserrat | anton, textStyle: outline | box | caption }。outline(默认)和 box 是响亮的广告风格。caption 是本机应用内字幕样式:白色标题大小写文本,位于一个深色圆角框中,在其区域顶部,淡入;以第一人称故事线的方式编写,最多2行,每行最多30个字符。
  • 一个片段:{ src, start (进入源的时间), duration (在屏幕上的时间), speed, focus (center | top | bottom | "50% 30%"), transition (cut | flash | zoom | whip | focus) }。transition 定义该片段如何出现。

一个片段还可以模拟摄像机:zoom(1-2.5,放大并保持 focus 点不动)、tilt(度数,-15到15,荷兰角)和 push(0-0.6,摄像机随着片段到来短暂模糊地前冲,然后稳定下来)。

作业中省略的属性被视为关闭:没有 hook 的作业就没有钩子,不管示例如何。

src 是 public/ 内的路径或HTTPS URL。.jpg/.png/.webp 文件执行缓慢推入效果,而不是播放。

3. 规则

  • 安全区域。 所有文字保持在 x 140-940、y 288-1248 的范围内。模板通过三个区域强制执行此规则:top(y 288-600)、middle(600-930)、lower(930-1248)。您只需选择区域。
  • 保持文字远离产品,除非简报要求将其放在产品上。根据您提取的帧为每个文字选择区域。如果每个区域在一个镜头中都覆盖了产品,请缩短文字的 duration 或更换镜头。
  • 短行。 文字会自动缩小以适应800像素宽度,因此长行会变得很小。每行目标为22个拉丁字符或12个日语字符。将一个单词括在 *星号* 中以用强调色为其着色。
  • 片段长度。 start + duration * speed 不得超过源文件的末尾。视频的总长度是所有片段持续时间的总和(BeforeAfter 使用 duration;Testimonial 是评论加上行动号召的时间)。
  • 与节拍同步剪辑,当有音乐时:使片段持续时间总和等于节拍位置。
  • 字体。 支持拉丁语、越南语(montserrat 或 anton,以及所有界面卡片)和日语。韩语、泰语、阿拉伯语等需要先在 reels/src/lib/kit.tsx 中添加字体。

少量静态片段,多个角度。 当素材是一个或两个固定镜头,而简报要求快速的多角度剪辑(例如展厅巡览或潮流舞蹈剪辑)时,请使用 BeatCutAd 模板,并用不同的 focus、zoom、tilt 和 push 多次重复使用每个源:从一个广角镜头(zoom 约 1.02)开始,然后每个节拍一个细节(文字、角色、名字、手、下摆),交替 tilt 的正负号,在768像素源上保持 zoom 不超过1.7,最后回到广角。使用 cut 转场;push 本身就是转场。这可以重新构图素材,但无法创建真正的全新摄像机角度。

模板说明:

  • ChatStory、NotesList、NotificationStack:界面先播放,然后 clips(收尾片段)闪现出来,行动号召覆盖在它们之上。它们的长度等于界面部分加上片段长度。省略 hook:卡片本身占据安全区域。background 是卡片后面变暗的媒体。
  • ChatStory:消息根据阅读时间自行调整节奏;仅当需要强制与节拍同步时才设置 at(秒)。消息可以携带 image(产品照片)来代替或配合 text。
  • NotesList:check: true 会在该行被输入后打勾,highlight: true 则标记它。将产品行放在最后。
  • SearchHook:pick 是被选中的建议。保持查询字符串不超过34个字符。
  • NotificationStack:icon 是一个表情符号,color 是其图块颜色。根据语言翻译 now(现在)和 date(日期)。
  • PolaroidDump:接近方形的照片效果最好。title 是手写的;说明文字保持在20个字符以内。没有片段:照片本身就是视频。
  • Ranking:items 按编写的顺序播放,因此先写最低排名,最后写排名1。标签保持在20个字符以内。
  • PollSticker:percent 值由您设定;当简报中有真实数值时请使用,永远不要将虚构的数值作为调查数据呈现。
  • 在这些界面中编写的文案应符合人们发短信和发帖的风格:小写没问题,短行,在人们会使用表情符号的地方使用表情符号。其中的姓名、消息和评论只是示意性内容,除非简报提供了真实内容,因此不要将其归属于真人。
  • UgcCaptions:words 是 { text, start, end },以输出时间轴上的秒为单位。从带有单词时间戳的转录稿中获取;不要猜测时间。keepAudio 默认为 true。一个“单词”可以是一个短短语,配合 wordsPerPage: 1。
  • CommentReply 和 OfferPromo:省略 hook。气泡或标题已经使用了顶部区域。
  • OfferPromo:行动号召默认位于底部区域。Testimonial:将行动号召区域设置为 middle。
  • ProductSlideshow:badge 可以使用 \n 实现两行;使用 badgeBand 放置它。

4. 检查,然后渲染

在 reels/ 目录下运行这些命令。

node render.mjs jobs/<job>.json --still=1,6,12 --guides   # 安全区域边界绘制在顶部
node render.mjs jobs/<job>.json --still=1,6,12 --lang=en,ja
node render.mjs jobs/<job>.json                           # 每种语言 -> exports/<name>/

静态图片以半尺寸保存到 out/stills/。打开它们并检查:文字未覆盖产品,没有内容被裁剪,每种语言都适合。选择钩子、中间字幕和行动号召内部的静态图片时间点。文件名为 _GUIDES 的仅供检查使用;永远不要将它们作为结果交付。

只有在静态图片通过后才渲染视频。如果静态图片失败,请修正作业并再次检查;在三次失败后,报告为阻塞问题。渲染会为每个文件打印一行,包含其路径和长度。除非简报要求,否则不要发布或上传视频。

每个作业结束时向请求者发送一份报告。报告内容包括:

  • 输出路径和长度;
  • 使用的模板以及在简报未明确说明时使用的默认值;
  • 每个输入的来源,以及 public/ 中是否保存了唯一副本;
  • 第6节的清理操作删除了什么,以及释放了多少空间。

5. Instagram尺寸

渲染的文件大约为16 Mbps。要压缩一个用于上传:

ffmpeg -i in.mp4 -c:v libx264 -crf 20 -maxrate 10M -bufsize 20M -c:a aac -ar 48000 -b:a 192k -movflags +faststart out.mp4

6. 媒体和磁盘空间

媒体文件是占用磁盘空间的主要部分。输入文件(复制到 public/<name>/ 的素材、照片、音乐)和输出文件(exports/<name>/ 中的视频,15秒的视频每种语言约30 MB)都属于同一个作业,使用相同的名称。保持这种结构,因为清理操作是按作业进行的。其他所有内容都是临时文件:out/ 中的QA静态图片,以及Remotion写入操作系统临时文件夹的临时包(每个包都包含 public/ 的一份完整副本;render.mjs 会删除自己的临时文件,但崩溃的运行和Studio可能会留下一些残留)。node_modules/.cache 中的webpack缓存会增长到几百MB。node_modules/(约1.3 GB,包括无头浏览器)是一次性成本。重新渲染一个作业会覆盖其同名文件,因此对一个作业的反复渲染不会累积占用空间。

如果 reels/clean.mjs 缺失(工作区是从旧版工具包创建的),请先从本技能的 assets/reels-kit/ 中将 clean.mjs 和 render.mjs 复制到 reels/。

在 reels/ 目录下运行这些命令,不要在渲染过程中运行:

node clean.mjs --auto --keep=<name1>,<name2>    # 仅保留命名的作业
node clean.mjs --auto                           # 仅保留最新的作业
node clean.mjs --all                            # 删除所有输出和输入

7. 向工具包添加模板

本技能支持添加新模板作为作业,但这仍然是更宽泛的Remotion技能的主要职责。仅在模板是本技能明确要使用的时(例如,这是一个Reels格式,并且请求者要求将其添加到这里)才这样做。

不要为了制作一个视频而编写新模板:使用现有的15个模板之一。新模板是为了为所有未来的作业增加格式,而不仅仅是为了一个单一的渲染。

添加一个模板意味着创建一个新的React组件文件(带Props类型)和一个对应的示例作业。使用 src/BeatCutAd/ 作为起点。需要修改的文件:

  1. src/<Template>/<Template>.tsx — 组件。从现有组件复制,修改以匹配用例。
  2. src/<Template>/schema.ts — 用于 props 的 Zod 模式。
  3. src/registry.ts — 导入并注册组件、模式和名称。
  4. jobs/examples/<Template>.json — 一个有效的完整示例作业。
  5. 在 render.mjs 和 clean.mjs 中,allTemplates 数组是自动从 src/ 文件系统导出的;无需手动添加。

组件作为无状态函数接收一个 data 对象和一个 Remotion Sequence 组件,请参阅现有组件。在编写组件时,使用 <CompositionTitle> 来显示标题文本(白色,在安全区域的顶部中间,居中),使用 <ActionButton> 来显示行动号召按钮(底部中间)。放置多个元素时使用 <Band> 容器。所有内容都绝对定位在 1080x1920 的画布上。useCurrentFrame() 和 useVideoConfig() 可以从 Remotion 的 'remotion' 导入。

在开发组件时,请始终注意安全区域:所有文字内容必须保持在 x 140-940,y 288-1248 的边界内。还要记住,视频是自动渲染的:不要在组件中包含交互式元素、悬停效果或事件处理程序。转场应该由 transition prop 处理,该 prop 在注册表中自动包装。

组件属性:

  • 所有模板都接收 hook、cta、music 和 brand 作为 prop,分别对应 HookProps、CtaProps、MusicProps 和 BrandProps 类型。这些由 src/reel.ts 中的共享组件处理。
  • 模板特定的属性在组件类型中定义,例如 BeatCutAdProps。使用 zod 模式进行验证。

测试新模板: 创建作业文件,渲染静态图片,验证布局,然后渲染完整的视频。遵循与现有模板相同的检查过程(第4节)。

相关技能