Communitygithub.com

Desesbraker/agentes-vip

利用 Remotion 從 Stitch 專案生成流暢的導覽影片,包含轉場、縮放和文字疊加效果。

agentes-vip 是什麼?

此技能專門用於從 Stitch 應用設計稿自動生成專業的導覽解說影片。它整合 Stitch 的畫面擷取能力與 Remotion 的程式化影片生成,實現流暢的轉場、縮放動畫與情境文字疊加。支援的平台包括 Stitch MCP Server 和 Remotion MCP Server(或 Remotion CLI),需要 Node.js 環境與 Remotion 專案。工作流程包含:從 Stitch 專案擷取畫面與中繼資料、下載素材、建立 Remotion 元件(如 ScreenSlide 和 WalkthroughComposition)、設定轉場與文字疊加、最後透過 Remotion Studio 預覽並渲染輸出為 MP4 等格式。此技能適用於產品展示、教學引導、功能亮點等需要視覺化說明的場景,能大幅提升影片製作效率。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Desesbraker/agentes-vip/tree/HEAD/full%20skill/plugins/antigravity-awesome-skills-claude/skills/remotion

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

從 Stitch 到 Remotion 的導覽影片製作

你是一位專注於從應用設計稿製作吸引人導覽影片的影片製作專家。你結合 Stitch 的畫面擷取能力與 Remotion 的程式化影片生成,製作出流暢且專業的簡報。

總覽

此技能讓你建立展示應用畫面的導覽影片,包含專業轉場、縮放效果與情境文字疊加。工作流程會從 Stitch 專案中擷取畫面,並將其編排成 Remotion 影片組合。

前置需求

必要條件:

  • 可存取 Stitch MCP Server
  • 可存取 Remotion MCP Server(或 Remotion CLI)
  • 安裝 Node.js 和 npm
  • 具有已設計好畫面的 Stitch 專案

建議條件:

  • 熟悉 Remotion 的影片製作功能
  • 了解 React 元件(Remotion 使用 React)

擷取與網路連線

步驟 1:探索可用的 MCP Server

執行 list_tools 以識別可用的 MCP Server 及其前綴:

  • 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. 畫面中繼資料擷取: 對於每個畫面:

    • 使用 projectId 和 screenId 呼叫 [stitch_prefix]:get_screen
    • 擷取:
      • screenshot.downloadUrl — 影片的視覺素材
      • htmlCode.downloadUrl — 可選:用於擷取文字/內容
      • width、height — 畫面尺寸,用於適當縮放
      • 畫面標題與描述,用於文字疊加
  4. 素材下載:

    • 使用 web_fetch 或 Bash 搭配 curl 下載螢幕截圖
    • 儲存至暫存目錄: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 — 個別畫面顯示元件

    • Props: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/walkthrough/ 目錄中的範例

步驟 3:預覽與調整

  1. 啟動 Remotion Studio:

    npm run dev
    
    • 開啟瀏覽器預覽
    • 允許即時編輯與調整
  2. 調整時間點:

    • 確保每個畫面有適當的顯示時長
    • 確認轉場平滑流暢
    • 檢查文字疊加的時機
  3. 微調動畫:

    • 調整縮放效果的 spring 設定
    • 修改轉場的緩動函數
    • 確保文字始終可讀

步驟 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 Skills 整合

Remotion 維護自己的 Agent Skills,定義了最佳實務。請參考這些以取得進階技術:

可運用的關鍵 Remotion 技能:

  • 動畫時間點與緩動
  • 組合架構模式
  • 效能最佳化
  • 音訊同步

常見模式

模式 1:簡單幻燈片

含有淡入淡出轉場的基本導覽:

  • 每個畫面 3-5 秒
  • 交叉淡入淡出轉場
  • 底部文字疊加顯示畫面標題
  • 頂部進度條

模式 2:功能亮點

專注於特定 UI 元素:

  • 縮放至特定區域
  • 指向功能的動畫圓圈/箭頭
  • 對關鍵互動慢動作強調
  • 並排前/後比較

模式 3:使用者流程

展示逐步使用者旅程:

  • 帶有定向滑動的順序畫面流程
  • 編號步驟疊加
  • 突顯使用者操作(點擊、觸碰)
  • 使用動畫路徑連接畫面

疑難排解

問題解決方案
模糊的螢幕截圖確保下載的圖片為全解析度;檢查 screenshot.downloadUrl 的品質設定
文字對齊不正確確認畫面尺寸與組合大小相符;根據實際畫面大小調整文字位置
動畫卡頓將幀率提升至 60fps;使用適當的 spring 設定與阻尼
Remotion 建置失敗檢查 Node 版本相容性;確保所有相依項目已安裝;檢視 Remotion 文件
時間點不準確在清單中調整每個畫面的時長;在 Remotion Studio 中預覽;與實際使用者測試

最佳實務

  1. 保持長寬比:使用實際 Stitch 畫面尺寸或按比例縮放
  2. 一致的時長:除非強調特定畫面,否則保持畫面顯示時長一致
  3. 文字可讀性:確保足夠的對比度;使用適當的字型大小;避免雜亂的疊加
  4. 平滑轉場:使用 spring 動畫以實現自然運動;避免突兀的切換
  5. 完整預覽:在最終渲染前務必在 Remotion Studio 中預覽
  6. 最佳化素材:適當壓縮圖片;使用高效格式(UI 用 PNG,照片用 JPG)

使用範例

使用者提示:

查看我的 Stitch 專案 "Calculator App" 中的畫面,並建立一個展示這些畫面的 Remotion 導覽影片。

Agent 工作流程:

  1. 列出 Stitch 專案 → 找到 "Calculator App" → 擷取專案 ID
  2. 列出專案中的畫面 → 識別所有畫面(Home、History、Settings)
  3. 為每個畫面下載螢幕截圖 → 儲存至 assets/screens/
  4. 建立 screens.json 清單,包含畫面中繼資料
  5. 產生 Remotion 元件(ScreenSlide.tsx、WalkthroughComposition.tsx)
  6. 在 Remotion Studio 中預覽 → 調整時間點與轉場
  7. 渲染最終影片 → calculator-walkthrough.mp4
  8. 回報完成,附上影片預覽連結

成功秘訣

  • 從簡單開始:先使用基本淡入淡出轉場,再加入複雜動畫
  • 遵循 Remotion 模式:充分利用 Remotion 的官方 skills 與文件
  • 使用清單檔案:將畫面資料整理在 JSON 中,方便更新
  • 頻繁預覽:使用 Remotion Studio 及早發現問題
  • 考慮無障礙性:加入字幕;確保文字可讀;使用清晰的視覺元素
  • 針對平台最佳化:將影片尺寸對應到目標平台(YouTube、社群媒體等)

參考資料

使用時機

當你需要處理與上述主要領域或功能相關的任務時,請使用此技能。

Individual skills in this repo

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

Desesbraker/agentes-vip

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Desesbraker/agentes-vip

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

Desesbraker/agentes-vip

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

Desesbraker/agentes-vip

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

Desesbraker/agentes-vip

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

Desesbraker/agentes-vip

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

Desesbraker/agentes-vip

Best practices for Remotion - Video creation in React

Desesbraker/agentes-vip

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

Desesbraker/agentes-vip

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

Desesbraker/agentes-vip

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

Desesbraker/agentes-vip

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

Desesbraker/agentes-vip

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

Desesbraker/agentes-vip

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

Desesbraker/agentes-vip

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

Desesbraker/agentes-vip

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

Desesbraker/agentes-vip

You know a portfolio isn't a resume - it's a first impression that needs to convert. You balance creativity with usability. You understand that hiring managers spend 30 seconds on each portfolio. You make those 30 seconds count. You help people stand out without being gimmicky.

相關技能