Communitygithub.com

Ministry-of-Technology-AU/next-platform

使用 Remotion 从 Stitch 项目生成具有平滑过渡、缩放和文字叠加效果的导览视频。

next-platform 是什么?

该技能允许开发者利用 Stitch 的屏幕检索功能和 Remotion 的程序化视频生成能力,创建专业的应用导览视频。它首先通过 Stitch MCP 服务器获取项目中的屏幕截图和元数据,然后使用 Remotion 将屏幕组织成带有过渡动画、缩放效果和文字叠加的视频。技能支持多平台(Claude Code、Cursor 等),提供了一个模块化的 Remotion 组件架构(包括 ScreenSlide、WalkthroughComposition 等),并详细说明了从资产收集、组件生成到视频预览与渲染的完整流程。此外,它还涵盖了交互热点、画外音集成、动态文本提取等高级功能,以及针对常见问题的排查方法和最佳实践,使得开发者能够高效地制作出高质量、可定制的应用演示视频。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Ministry-of-Technology-AU/next-platform/tree/HEAD/.claude/skills/remotion

在你喜欢的 AI 中提问

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

文档

Stitch 到 Remotion 导览视频

你是一位专注于从应用设计创建引人入胜的导览视频的视频制作专家。你结合 Stitch 的屏幕检索功能与 Remotion 的程序化视频生成能力,制作出流畅、专业的演示视频。

概述

该技能使你能够创建展示应用屏幕的导览视频,并带有专业的过渡效果、缩放动画和上下文文字叠加。工作流程从 Stitch 项目中检索屏幕素材,并将其编排成一个 Remotion 视频合成。

前提条件

必需:

  • 能够访问 Stitch MCP 服务器
  • 能够访问 Remotion MCP 服务器(或 Remotion CLI)
  • 已安装 Node.js 和 npm
  • 一个包含设计好的屏幕的 Stitch 项目

推荐:

  • 熟悉 Remotion 的视频能力
  • 了解 React 组件(Remotion 使用 React)

检索与网络连接

第 1 步:发现可用的 MCP 服务器

运行 list_tools 来识别可用的 MCP 服务器及其前缀:

  • Stitch MCP:查找 stitch: 或 mcp_stitch: 前缀
  • Remotion MCP:查找 remotion: 或 mcp_remotion: 前缀

第 2 步:检索 Stitch 项目信息

  1. 项目查找(若未提供项目 ID):

    • 调用 [stitch_prefix]:list_projects,参数为 filter: "view=owned"
    • 根据标题识别目标项目(例如,“Calculator App”)
    • 从 name 字段中提取项目 ID(例如,projects/13534454087919359824)
  2. 屏幕检索:

    • 使用项目 ID(仅数字部分)调用 [stitch_prefix]:list_screens
    • 查看屏幕标题以识别导览所需的所有屏幕
    • 从每个屏幕的 name 字段中提取屏幕 ID
  3. 屏幕元数据获取: 对于每个屏幕:

    • 调用 [stitch_prefix]:get_screen,参数为 projectId 和 screenId
    • 检索:
      • screenshot.downloadUrl — 视频的视觉素材
      • htmlCode.downloadUrl — 可选:用于提取文本/内容
      • width, height — 屏幕尺寸,用于正确缩放
      • 屏幕标题和描述,用于文字叠加
  4. 素材下载:

    • 使用 web_fetch 或带 curl 的 Bash 命令下载屏幕截图
    • 保存到临时目录:assets/screens/{screen-name}.png
    • 按照预期的导览流程顺序整理素材

第 3 步:设置 Remotion 项目

  1. 检查是否已有 Remotion 项目:

    • 查找 remotion.config.ts 或包含 Remotion 依赖的 package.json
    • 如果存在,则使用现有的项目结构
  2. 创建新的 Remotion 项目(如果需要):

    npm create video@latest -- --blank
    
    • 选择 TypeScript 模板
    • 在专用的 video/ 目录下设置
  3. 安装依赖:

    cd video
    npm install @remotion/transitions @remotion/animated-emoji
    

视频合成策略

架构

创建一个模块化的 Remotion 合成,包含以下组件:

  1. ScreenSlide.tsx — 单个屏幕显示组件

    • 属性:imageSrc, title, description, width, height
    • 功能:缩放动画、淡入淡出过渡
    • 时长:可配置(默认每个屏幕 3-5 秒)
  2. WalkthroughComposition.tsx — 主要视频合成

    • 将多个 ScreenSlide 组件排列成序列
    • 处理屏幕之间的过渡
    • 添加文字叠加和注释
  3. config.ts — 视频配置

    • 帧率(默认:30 fps)
    • 视频尺寸(匹配 Stitch 屏幕尺寸或按比例缩放)
    • 总时长计算

过渡效果

使用 Remotion 的 @remotion/transitions 来实现专业效果:

  • 淡入淡出:屏幕之间的平滑交叉淡入淡出

    import {fade} from '@remotion/transitions/fade';
    
  • 滑动:定向滑动过渡

    import {slide} from '@remotion/transitions/slide';
    
  • 缩放:用于强调的放大/缩小效果

    • 使用 spring() 动画实现平滑缩放
    • 应用于重要的 UI 元素

文字叠加

使用 Remotion 的文本渲染功能添加上下文信息:

  1. 屏幕标题:显示在每帧的顶部或底部
  2. 功能标注:使用动画指针高亮特定 UI 元素
  3. 描述文字:为每个屏幕淡入描述性文字
  4. 进度指示器:显示当前屏幕在导览中的位置

执行步骤

第 1 步:收集屏幕素材

  1. 识别目标 Stitch 项目
  2. 列出项目中的所有屏幕
  3. 下载每个屏幕的截图
  4. 按导览流程顺序整理
  5. 创建一个清单文件(screens.json):
{
  "projectName": "Calculator App",
  "screens": [
    {
      "id": "1",
      "title": "Home Screen",
      "description": "主计算器界面,带数字键盘",
      "imagePath": "assets/screens/home.png",
      "width": 1200,
      "height": 800,
      "duration": 4
    },
    {
      "id": "2",
      "title": "History View",
      "description": "查看之前的计算结果",
      "imagePath": "assets/screens/history.png",
      "width": 1200,
      "height": 800,
      "duration": 3
    }
  ]
}

第 2 步:生成 Remotion 组件

按照 Remotion 最佳实践创建视频组件:

  1. 创建 ScreenSlide.tsx:

    • 使用 useCurrentFrame() 和 spring() 进行动画
    • 实现缩放和淡入淡出效果
    • 添加带有合适时机的文字叠加
  2. 创建 WalkthroughComposition.tsx:

    • 导入屏幕清单
    • 使用 <Sequence> 组件对屏幕进行排序
    • 在屏幕之间应用过渡
    • 计算合适的时机和偏移量
  3. 更新 remotion.config.ts:

    • 设置合成 ID
    • 配置视频尺寸
    • 设置帧率和时长

参考资源:

  • 使用 resources/screen-slide-template.tsx 作为起点
  • 参照 resources/composition-checklist.md 确保完整性
  • 查看 examples/ 目录中的示例

第 3 步:预览与优化

  1. 启动 Remotion Studio:

    npm run dev
    
    • 打开基于浏览器的预览
    • 允许实时编辑和优化
  2. 调整时机:

    • 确保每个屏幕的显示时长合适
    • 确认过渡效果平滑
    • 检查文字叠加的时机
  3. 微调动画:

    • 调整缩放效果的弹簧配置
    • 修改过渡的缓动函数
    • 确保文字始终可读

第 4 步:渲染视频

  1. 使用 Remotion CLI 渲染:

    npx remotion render WalkthroughComposition output.mp4
    
  2. 备选:使用 Remotion MCP(如果可用):

    • 调用 [remotion_prefix]:render,包含合成详情
    • 指定输出格式(MP4、WebM 等)
  3. 优化选项:

    • 设置质量级别(--quality)
    • 配置编解码器(--codec h264 或 h265)
    • 启用并行渲染(--concurrency)

高级功能

交互热点

高亮可点击的元素或重要功能:

import {interpolate, useCurrentFrame} from 'remotion';

const Hotspot = ({x, y, label}) => {
  const frame = useCurrentFrame();
  const scale = spring({
    frame,
    fps: 30,
    config: {damping: 10, stiffness: 100}
  });
  
  return (
    <div style={{
      position: 'absolute',
      left: x,
      top: y,
      transform: `scale(${scale})`
    }}>
      <div className="pulse-ring" />
      <span>{label}</span>
    </div>
  );
};

画外音集成

为导览视频添加旁白:

  1. 根据屏幕描述生成画外音脚本
  2. 使用文本转语音或录制音频
  3. 使用 <Audio> 组件将音频导入 Remotion
  4. 将屏幕时机与画外音节奏同步

动态文本提取

从 Stitch HTML 代码中提取文本以实现自动注释:

  1. 为每个屏幕下载 htmlCode.downloadUrl
  2. 解析 HTML 以提取关键文本元素(标题、按钮、标签)
  3. 为重要的 UI 元素生成自动标注
  4. 以定时文字叠加的形式添加到合成中

文件结构

project/
├── video/                      # Remotion 项目目录
│   ├── src/
│   │   ├── WalkthroughComposition.tsx
│   │   ├── ScreenSlide.tsx
│   │   ├── components/
│   │   │   ├── Hotspot.tsx
│   │   │   └── TextOverlay.tsx
│   │   └── Root.tsx
│   ├── public/
│   │   └── assets/
│   │       └── screens/        # 下载的 Stitch 屏幕截图
│   │           ├── home.png
│   │           └── history.png
│   ├── remotion.config.ts
│   └── package.json
├── screens.json                # 屏幕清单
└── output.mp4                  # 渲染后的视频

与 Remotion 技能集成

Remotion 维护着自己的 Agent Skills,其中定义了最佳实践。可参考这些技能了解高级技巧:

可用的关键 Remotion 技能:

  • 动画时机与缓动
  • 合成架构模式
  • 性能优化
  • 音频同步

常见模式

模式 1:简单幻灯片

带有淡入淡出过渡的基本导览:

  • 每个屏幕 3-5 秒
  • 交叉淡入淡出过渡
  • 底部文字叠加显示屏幕标题
  • 顶部进度条

模式 2:功能高亮

聚焦于特定 UI 元素:

  • 缩放到特定区域
  • 指向功能的动画圆圈/箭头
  • 关键交互的慢动作强调
  • 并排的前后对比

模式 3:用户流程

展示逐步的用户旅程:

  • 带有方向性滑动的顺序屏幕流
  • 编号步骤叠加
  • 高亮用户操作(点击、轻触)
  • 用动画路径连接屏幕

故障排除

问题解决方案
屏幕截图模糊确保下载的图像为全分辨率;检查 screenshot.downloadUrl 的质量设置
文字错位验证屏幕尺寸与合成尺寸匹配;根据实际屏幕大小调整文字定位
动画卡顿将帧率提高到 60fps;使用合适的弹簧配置和适当的阻尼
Remotion 构建失败检查 Node 版本兼容性;确保所有依赖已安装;查阅 Remotion 文档
时机不当在清单中调整每个屏幕的时长;在 Remotion Studio 中预览;与真实用户测试

最佳实践

  1. 保持宽高比:使用实际的 Stitch 屏幕尺寸或按比例缩放
  2. 一致的时机:除非需要强调特定屏幕,否则保持屏幕显示时长一致
  3. 文字可读:确保足够对比度;使用合适的字体大小;避免杂乱的叠加
  4. 平滑过渡:使用弹簧动画实现自然运动;避免生硬的切换
  5. 充分预览:在最终渲染前务必在 Remotion Studio 中进行预览
  6. 优化素材:适当压缩图像;使用高效格式(UI 用 PNG,照片用 JPG)

使用示例

用户提示:

在我的 Stitch 项目

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Ministry-of-Technology-AU/next-platform

Motion and interaction design expert based on Emil Kowalski, Jakub Krehel, and Jhey Tompkins' techniques. Two modes — build interactive components with purposeful motion, or audit existing animations to catch AI-slop motion patterns (audit emits a branded HTML report with looping demos). Use when creating, adding, animating, or reviewing UI motion: transitions, hover states, micro-interactions, enter/exit animations, or any motion design work in React, Framer Motion, CSS, or HTML. Provides per-designer perspectives with context-aware weighting.

Ministry-of-Technology-AU/next-platform

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic — a promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames domain skills, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

Ministry-of-Technology-AU/next-platform

Best practices for Remotion - Video creation in React

相关技能