Communitygithub.com

nntenzo/msl

在需要为当前项目或用户提供的主题创建宣传片、产品演示、解说视频、设计类多镜头、故事板编排的社交媒体/Reels/TikTok发现视频、本地商家视频、餐厅/美食Vlog或20秒以上剪辑视频时使用。

msl 是什么?

该技能(Skill)专为创建完整的、多镜头编剪视频而设计,适用于多种场景,包括产品宣传、营销、解说、品牌推广、社媒短视频以及本地商家推广等。它基于一套严格的Remotion工作流,要求开发者首先通过故事板(promo_storyboard.md)对视频主题、镜头、旁白和背景音乐进行详细规划,并严格遵守合规基线,确保视频内容不包含虚假或误导性声明。技能支持两种主体类型:项目宣传(promote当前工作区或用户指定项目)和主题宣传(promote用户提供的概念或外部主题),两者共享相同的Remotion模板和渲染命令。在生成最终视频前,技能强制要求先生成并测量旁白和背景音乐的时长,然后优化镜头时间线,最后通过专门的`RemotionPromoRenderer.render`工具进行渲染和导出。该技能主要面向Claude Code等AI编程代理,通过结构化的XML命令和严格的步骤顺序,帮助开发者高效、合规地制作专业级宣传视频。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/nntenzo/msl/tree/HEAD/.atoms/skills/promo-video-production

在你喜欢的 AI 中提问

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

文档

何时使用

当用户请求制作宣传视频、产品视频、演示视频、营销视频、发布视频、解说视频、品牌视频、设计类视频、多镜头视频、故事板编排的视频、社交媒体/Reels/TikTok发现视频、本地商家视频、餐厅/美食Vlog风格视频、20秒以上剪辑视频,或任何以视觉方式介绍某个主题的完整视频时,应使用此技能。

只要请求描述的是包含时间线、镜头、字幕、音频、镜头语言、视觉风格、一致性要求、CTA/结尾卡或多场景的完整剪辑视频,即使未提及“宣传”或“推广”字样,也应优先使用此Remotion工作流。对于单个短视频片段或背景循环,应直接使用AI视频生成,而非将此作为完整多镜头视频的最终交付路径。

视频主题可以是以下两种之一:

  1. 项目宣传 — 代理自身正在构建或已存在于工作区中的项目、应用或功能,或是用户请求或先前已确认的上下文中已识别的其他现有应用。首先确定被宣传的 源应用。app/promo 是输出视频项目,并非自动成为源应用。
  2. 主题宣传 — 用户提供的主题、概念、品牌或外部主题,这些内容不依赖于工作区中的项目。例如:“太阳系”、“宋朝历史”、“什么是向量数据库”。

两种路径共享相同的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页面标签或将地址栏留空。不要从应用名称、仓库名称、下载文件名、模板占位符、环境变量令牌或类似线索中推断域名、句柄或目标地址。

核心工作流

  1. 如果 app/promo 尚未就绪,使用 FrontendEngineer.use_template("remotion") 初始化Remotion项目。该工具在复制前会自动拒绝非Remotion源,因此无需单独的验证步骤。
  2. 根据用户请求和故事板计划,预先选择目标方向:横屏(16:9)、竖屏(9:16)或方形(1:1)。所有后续的验证、预览和完整渲染命令必须使用匹配的变体。
  3. 使用主题分类对主题进行分类(项目宣传 vs. 主题宣传)。如果原始请求已命名主题或项目,则无需停下来询问“这应该关于什么?”。
  4. 深入主题:
    • 项目宣传:首先确定要宣传的源应用,然后读取该应用的 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。
  5. 应用合规基线:确认哪些事实、声明、优惠和资源确实得到请求、产品、广告文案或落地页的支持。不要编造不支持的优惠、认证、销售数据、效果、官方合作、平台认可或品牌背书;当不确定时,选择保守的、以信息为先的措辞和视觉效果。
  6. 在编写 promo_storyboard.md 之前,确定新生成的宣传内容使用的默认语言。如果用户明确指定了输出语言,则使用该语言。否则,默认使用英语。用户消息使用中文/日文等、周围聊天语言或系统提示语言并不构成显式的语言请求。在起草镜头、文案、旁白或生成提示之前,直接在故事板中记录决定,例如 Language: English (default) 或 Language: Chinese (user specified)。
  7. 在编写视频代码或生成资源之前创建 promo_storyboard.md。使用与主题类型匹配的字段集(参见故事板要求)。对于宣传/Remotion运行,promo_storyboard.md 是唯一的规划产物;不要创建或维护单独的 todo.md。
  8. 如果用户请求旁白、配音、口头导览,或者故事板明显需要叙述者,则在故事板中包含一个短片段旁白计划,检查每个片段的脚本长度是否与其目标镜头秒数匹配,然后读取 audio-generation 并调用 AudioCreator.generate_audios,每个镜头/节点发送一个请求。
  9. TTS生成后,优先使用每个音频片段的返回 duration。如果 duration 缺失或为 null,请测量返回的URL的真实时长(例如使用 ffprobe),然后根据这些测量出的时长决定最终的每镜头时间。此计算不仅在思考或终端输出中出现是不够的。
  10. 立即使用每个旁白URL、测量的音频秒数、最终的镜头开始/结束/时长、总时长以及任何脚本/时间变更来更新 promo_storyboard.md。这是一个硬性检查点:在更新后的时间信息持久化到 promo_storyboard.md 之前,不得调用 MusicCreator.generate_music、VideoCreator.generate_videos、生成更多视觉资源或编写 src/timeline.ts。 在此锁定后,promo_storyboard.md 不得再保留占位 TBD 时间行或过时的总时长。
  11. 默认情况下,宣传视频还应包含一个全局背景音乐计划,除非用户明确表示不需要音乐,或者该作品在没有音乐的情况下效果明显更好。读取 music-generation 并在最终镜头时间锁定后,调用 MusicCreator.generate_music,仅发送一个纯器乐/无唱词的请求。提示必须包含目标总秒数、情绪、节奏、乐器编排,以及音轨是否应为旁白留出空间。
  12. 音乐生成后,直接使用返回的URL,并优先使用返回的 duration,就像对待旁白一样。如果 duration 缺失或为 null,使用 ffprobe 测量真实BGM时长。在编写 src/timeline.ts 或 src/PromoVideo.tsx 之前,立即使用BGM URL、测量的秒数、目标总时长、适配策略和计划的混音值更新 promo_storyboard.md。 锁定的故事板/时间线时长是事实依据。切勿为了匹配短BGM而缩短视频;除非用户明确要求较短的剪辑,否则应剪裁、最小循环或重新生成音乐。
  13. 在故事板编写完成且旁白+BGM时间在 promo_storyboard.md 中确定后,生成任何其他需要的AI图像/视频/音频资源。
  14. 阅读 remotion-best-practices 以及与故事板相关的规则文件。
  15. 在 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}、保持动画纯帧驱动(无CSS animation / transition、定时器或其他非确定性模式),并在同一轮更新任何更改的 src/timeline.ts / src/PromoVideo.tsx / src/scenes/* 契约。
  16. 按顺序运行验证:verify:versions、lint、verify:compositions。通过 verify:compositions 仅证明Remotion可以看到合成;它不是一个可交付物,也不是一个有效的停止点。
  17. 针对故事板/导出规范中记录的目标分辨率运行 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是静态视频

…

[内容因长度限制被截断]

相关技能