何时使用
当用户请求制作宣传视频、产品视频、演示视频、营销视频、发布视频、解说视频、品牌视频、设计类视频、多镜头视频、故事板编排的视频、社交媒体/Reels/TikTok发现视频、本地商家视频、餐厅/美食Vlog风格视频、20秒以上剪辑视频,或任何以视觉方式介绍某个主题的完整视频时,应使用此技能。
只要请求描述的是包含时间线、镜头、字幕、音频、镜头语言、视觉风格、一致性要求、CTA/结尾卡或多场景的完整剪辑视频,即使未提及“宣传”或“推广”字样,也应优先使用此Remotion工作流。对于单个短视频片段或背景循环,应直接使用AI视频生成,而非将此作为完整多镜头视频的最终交付路径。
视频主题可以是以下两种之一:
- 项目宣传 — 代理自身正在构建或已存在于工作区中的项目、应用或功能,或是用户请求或先前已确认的上下文中已识别的其他现有应用。首先确定被宣传的 源应用。
app/promo是输出视频项目,并非自动成为源应用。 - 主题宣传 — 用户提供的主题、概念、品牌或外部主题,这些内容不依赖于工作区中的项目。例如:“太阳系”、“宋朝历史”、“什么是向量数据库”。
两种路径共享相同的Remotion模板、相同的合成预设以及相同的渲染命令。只有故事板的创作方式有所不同。
命令
在验证后,使用 RemotionPromoRenderer.render 进行最终宣传片导出。此命令由此技能文档记录,即使未在 <Available Commands> 中列出,也可以调用。
<RemotionPromoRenderer.render>
<promo_dir>/absolute/path/to/app/promo</promo_dir>
<width>1920</width>
<height>1080</height>
<source_orientation>landscape</source_orientation>
</RemotionPromoRenderer.render>
主题分类
在执行任何操作之前,首先根据原始用户请求对主题进行分类。如果请求已明确命名主题或项目,则无需要求用户澄清。
- 如果用户消息中明确提到了一个外部主题/概念(例如“做个介绍太阳系的宣传视频”),并且工作区中没有
app/frontend或任何要宣传的应用代码 → 主题宣传。 - 如果用户消息中引用了现有的
app/frontend构建、代理一直在生成的应用或即将推出的功能 → 项目宣传。 - 如果两者都适用(例如“为我们的太阳系讲解应用制作宣传片”)→ 将应用视为主要对象,主题作为辅助内容;这是项目宣传。
主题宣传是一等公民。即使工作区中没有 app/frontend,也不应拒绝或拖延主题宣传。
对于项目宣传,在读取代码之前先确定源应用的标识。源应用可能是当前工作区的应用、同一对话中先前构建的应用,或用户明确引用的其他现有项目。不要假设当前的 app/promo 工作区就是要宣传的对象。
合规基线
宣传视频必须默认遵守保守的广告安全规则。仅使用存在于用户请求、项目、广告文案或落地页中的声明、报价、价格、折扣、赠品、品牌名称、CTA、认证、销售数据、效果和服务。除非源材料明确提供,否则不得暗示官方合作、平台推荐、品牌认可或认证。
不得使用具有误导性或无法验证的声明,例如保证结果、绝对排名、零风险承诺、虚假稀缺性、虚假倒计时、虚假通知、虚假按钮、虚假系统UI、虚假推荐、虚假评论、虚假新闻或夸大的结果截图。不得直接针对健康的、财务、年龄、种族、宗教、性取向、残疾、婚姻状况、体型或外貌等敏感个人属性;应使用中性受众措辞。
不得包含未经许可的品牌标志、可识别的人物、受版权保护的角色、第三方产品UI、媒体、字体、水印、成人内容、血腥、震惊、仇恨、骚扰、侮辱性内容、武器、毒品、赌博、烟草或政治敏感材料。对于医疗、保健品、减肥、美容手术、金融、贷款、加密货币、赌博、酒精、约会、儿童、法律、招聘、房地产、政治、宗教或社会问题等高危类别,保持视频的信息性,避免强烈承诺、戏剧性的前后对比或激进的转化压力。
保持画面清晰、稳定、高质量:无闪烁、严重压缩、拉伸、水印、由糟糕的资源缩放引起的黑条,或边缘裁剪的字幕/标志/CTA。如果对合规性不确定,应选择更安全、更中性、以信息为先的表达方式。此基线可降低风险,但并非平台批准的保证。
最终的转化CTA是静态视频内容,而非交互式web UI。不得将结尾CTA渲染为看起来可点击的网站按钮、虚假点击目标、箭头按钮、虚假输入框、虚假弹出窗口、虚假系统UI、光标目标、悬停/按下状态,或任何暗示观众可以点击导航的控件。应使用结尾卡文字、品牌口号、账户句柄、URL、二维码占位符或简单的“访问/扫描/关注”文字。产品演示和页面导览可以展示真实或模拟的UI按钮、表单和导航,用于演示产品流程,但这些不应成为最终的转化CTA。
任何可见的URL、账户句柄、二维码目标、浏览器地址栏文本或品牌端点必须来自用户的请求、确认的项目源、落地页或其他已验证的资源。如果项目仅显示占位域名或没有确认的公开地址,则应省略URL并以品牌文案结尾;对于浏览器窗口处理,应使用非URL页面标签或将地址栏留空。不要从应用名称、仓库名称、下载文件名、模板占位符、环境变量令牌或类似线索中推断域名、句柄或目标地址。
核心工作流
- 如果
app/promo尚未就绪,使用FrontendEngineer.use_template("remotion")初始化Remotion项目。该工具在复制前会自动拒绝非Remotion源,因此无需单独的验证步骤。 - 根据用户请求和故事板计划,预先选择目标方向:横屏(16:9)、竖屏(9:16)或方形(1:1)。所有后续的验证、预览和完整渲染命令必须使用匹配的变体。
- 使用主题分类对主题进行分类(项目宣传 vs. 主题宣传)。如果原始请求已命名主题或项目,则无需停下来询问“这应该关于什么?”。
- 深入主题:
- 项目宣传:首先确定要宣传的源应用,然后读取该应用的
app/frontend源代码、清单文件和先前的验证反馈。如果当前工作区主要包含宣传片输出,不要将app/promo本身视为源应用。确定源应用后,在promo_storyboard.md或工作笔记中锁定该源项目根目录/前端路径,并在切换到app/promo后继续重复使用该路径;不要因为宣传片工作区本身没有app/frontend就降级为主题宣传。在编写Remotion代码之前,记录你将在promo_storyboard.md中依赖的源前端关键文件路径(用于演示节点的页面/路由/组件)。稍后,在实现src/时,重新打开这些源文件并从代码中复制/重建,而不是依赖于冗长的散文摘要。 - 主题宣传:从用户消息和先前的对话中提取主题;从你自己的知识或外部工具(图像/视频/音频生成、搜索,如果可用)中获取额外信息。不需要工作区中存在项目。
- 如果用户提供了参考图像,但当前请求仅暴露了文件路径而非附件图像内容,请先读取
image-understanding并调用ImageAnalyzer.analyze_images,然后再进行故事板创作,以使视觉规划基于实际的图像内容而非文件名。 - 如果用户提供的宣传主题是一个网站URL,请使用
Browser.goto访问页面,然后使用Browser.take_screenshot捕获截图,然后在故事板创作前调用ImageAnalyzer.analyze_images处理截图,以使视觉规划基于实际的页面内容而非URL。
- 项目宣传:首先确定要宣传的源应用,然后读取该应用的
- 应用合规基线:确认哪些事实、声明、优惠和资源确实得到请求、产品、广告文案或落地页的支持。不要编造不支持的优惠、认证、销售数据、效果、官方合作、平台认可或品牌背书;当不确定时,选择保守的、以信息为先的措辞和视觉效果。
- 在编写
promo_storyboard.md之前,确定新生成的宣传内容使用的默认语言。如果用户明确指定了输出语言,则使用该语言。否则,默认使用英语。用户消息使用中文/日文等、周围聊天语言或系统提示语言并不构成显式的语言请求。在起草镜头、文案、旁白或生成提示之前,直接在故事板中记录决定,例如Language: English (default)或Language: Chinese (user specified)。 - 在编写视频代码或生成资源之前创建
promo_storyboard.md。使用与主题类型匹配的字段集(参见故事板要求)。对于宣传/Remotion运行,promo_storyboard.md是唯一的规划产物;不要创建或维护单独的todo.md。 - 如果用户请求旁白、配音、口头导览,或者故事板明显需要叙述者,则在故事板中包含一个短片段旁白计划,检查每个片段的脚本长度是否与其目标镜头秒数匹配,然后读取
audio-generation并调用AudioCreator.generate_audios,每个镜头/节点发送一个请求。 - TTS生成后,优先使用每个音频片段的返回
duration。如果duration缺失或为null,请测量返回的URL的真实时长(例如使用ffprobe),然后根据这些测量出的时长决定最终的每镜头时间。此计算不仅在思考或终端输出中出现是不够的。 - 立即使用每个旁白URL、测量的音频秒数、最终的镜头开始/结束/时长、总时长以及任何脚本/时间变更来更新
promo_storyboard.md。这是一个硬性检查点:在更新后的时间信息持久化到promo_storyboard.md之前,不得调用MusicCreator.generate_music、VideoCreator.generate_videos、生成更多视觉资源或编写src/timeline.ts。 在此锁定后,promo_storyboard.md不得再保留占位TBD时间行或过时的总时长。 - 默认情况下,宣传视频还应包含一个全局背景音乐计划,除非用户明确表示不需要音乐,或者该作品在没有音乐的情况下效果明显更好。读取
music-generation并在最终镜头时间锁定后,调用MusicCreator.generate_music,仅发送一个纯器乐/无唱词的请求。提示必须包含目标总秒数、情绪、节奏、乐器编排,以及音轨是否应为旁白留出空间。 - 音乐生成后,直接使用返回的URL,并优先使用返回的
duration,就像对待旁白一样。如果duration缺失或为null,使用ffprobe测量真实BGM时长。在编写src/timeline.ts或src/PromoVideo.tsx之前,立即使用BGM URL、测量的秒数、目标总时长、适配策略和计划的混音值更新promo_storyboard.md。 锁定的故事板/时间线时长是事实依据。切勿为了匹配短BGM而缩短视频;除非用户明确要求较短的剪辑,否则应剪裁、最小循环或重新生成音乐。 - 在故事板编写完成且旁白+BGM时间在
promo_storyboard.md中确定后,生成任何其他需要的AI图像/视频/音频资源。 - 阅读
remotion-best-practices以及与故事板相关的规则文件。 - 在
app/promo下原地编辑Remotion实现 — 保持模板的扁平src/布局(src/Root.tsx、src/PromoVideo.tsx、src/timeline.ts、src/components/、src/scenes/、src/app-demo/)。不要将源文件移动到类似src/remotion/的子目录中。在验证之前,进行一次快速自查:删除未使用的导入/变量、省略冗余的Sequence from={0}、保持动画纯帧驱动(无CSSanimation/transition、定时器或其他非确定性模式),并在同一轮更新任何更改的src/timeline.ts/src/PromoVideo.tsx/src/scenes/*契约。 - 按顺序运行验证:
verify:versions、lint、verify:compositions。通过verify:compositions仅证明Remotion可以看到合成;它不是一个可交付物,也不是一个有效的停止点。 - 针对故事板/导出规范中记录的目标分辨率运行
RemotionPromoRenderer.render;它在内部执行预览+完整渲染。对于竖屏/9:16视频,使用width=1080、height=1920和source_orientation=portrait,而不是复制横屏示例。仅当out/promo-<width>x<height>.mp4存在且非空时,任务才算完成。在此工具成功之前,不要告知用户视频已准备好导出、要求用户导出、调用RoleZero.reply_to_human或使用<end></end>。
故事板要求
promo_storyboard.md 必须针对主题具体化。选择与主题类型匹配的字段集:
每个故事板必须包含:
- 合规性说明:受支持的声明/优惠/资源,主题是否为高风险,保守的措辞选择,以及要避免的视觉/文案/资源风险。
- CTA处理:记录最终的CTA是静态视频
…
[内容因长度限制被截断]