Communitygithub.com

IZRINO/delta-auto-tools

從 Stitch 專案產生導覽影片,使用 Remotion 製作流暢轉場、縮放與文字疊加效果。

delta-auto-tools 是什麼?

此技能讓 AI 代理能將 Stitch 設計平台的螢幕截圖轉換為專業的 Remotion 導覽影片。它透過 MCP 伺服器與 Stitch 整合,自動擷取專案中的螢幕資訊與資產,再透過 Remotion 程式化產生影片。技能涵蓋了從 Stitch 專案中下載螢幕截圖、建立螢幕清單(manifest)、生成 React 元件(如 ScreenSlide 與 WalkthroughComposition)以及設定轉場、縮放和文字疊加效果。支援 Cursor 和 Claude Code 等開發環境,最終可輸出 MP4 或 WebM 格式的影片,適合用於產品展示、使用者流程示範或功能亮點介紹。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/IZRINO/delta-auto-tools/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. 螢幕元資料擷取: 對於每個螢幕:

    • 使用 projectId 和 screenId 呼叫 [stitch_prefix]:get_screen
    • 擷取以下資訊:
      • 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": "Main calculator interface with number pad",
      "imagePath": "assets/screens/home.png",
      "width": 1200,
      "height": 800,
      "duration": 4
    },
    {
      "id": "2",
      "title": "History View",
      "description": "View of previous calculations",
      "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 維護自己的代理技能,定義最佳實務。請參閱這些技能以了解進階技術:

可運用的主要 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 專案 "Calculator App" 中的螢幕,並建立一個顯示這些螢幕導覽的 Remotion 影片。

代理工作流程:

  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 的官方技能與文件
  • 使用清單檔案:將螢幕資料以 JSON 格式整理,便於更新
  • 頻繁預覽:使用 Remotion Studio 及早發現問題
  • 考慮無障礙性:加入字幕;確保文字可讀;使用清晰的視覺元素
  • 為平台最佳化:根據目標平台(YouTube、社群媒體等)調整影片尺寸

參考資料

相關技能