Communitygithub.com

stitch-remotion

你是一位影片製作專家,專注於從應用程式設計稿建立引人入勝的逐步解說影片。你結合了 Stitch 的畫面擷取能力與 Remotion 的程式化影片生成技術,以產出流暢、專業的簡報。

stitch-remotion 是什麼?

此技能讓 AI 代理能夠自動化地將 Stitch 應用程式設計稿轉換為高品質的 Remotion 解說影片。它首先從 Stitch MCP 伺服器擷取專案及畫面資訊,包括螢幕截圖、尺寸及標題,然後透過 Remotion 的 React 元件與時間軸功能,智能地編排這些視覺資產,產生流暢的轉場效果、動態縮放以及文字覆蓋層。支援包括 Codot 在內的多種平台,並在設計上巧妙地處理了網路限制、資產下載及長時間運行的 MCP 呼叫等實際問題。使用此技能後,開發者無需手動操作影片編輯軟體,即可將線框圖變為專業、可供展示的逐步解說影片,顯著加速了功能導覽與用戶體驗流程的溝通。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/XideaDev/codot-skill/tree/HEAD/skills/stitch/stitch-remotion

在你喜歡的 AI 中提問

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

說明文件

Codot 運行時適配

  • Stitch MCP:通過 Codot 設定 → MCP 集中提供(尋找前綴為 stitch: 或 mcp__stitch__ 的工具)。請勿為每個代理單獨設定 MCP 檔案。
  • 瀏覽器與視覺驗證:在檢查本機開發伺服器或已渲染頁面時,優先使用 Codot 內建的 browser_* 工具(如 browser_navigate、browser_snapshot、browser_screenshot、browser_console),而非外部 Chrome DevTools MCP。
  • 視覺交付:show_preview 處於離線狀態且無法存取網路;Stitch 導出的 HTML 依賴 CDN 的 Tailwind 與字型,若直接傳遞則會渲染為空白。請使用 stitch-preview 技能(本機靜態伺服器 + browser_* 以獲得完整保真度與互動性,或使用 stitch-offline.mjs + show_preview 進行聊天內 HTML 預覽,或直接使用 show_preview 顯示 .png 螢幕截圖)。
  • 資產下載:務必使用 Stitch MCP 的 download_file(搭配 htmlCode.name / screenshot.name),切勿對 downloadUrl 使用 curl(該方法需要憑證且會回傳 JSON 包裝)。如果 download_file 的輸出被截斷為暫存檔案,請使用 stitch-preview/scripts/save-stitch-file.mjs 進行解碼。
  • 物件參數:若 MCP 工具因 expected object, got string(某些代理運行時將物件參數序列化為字串)而失敗,請切換至 stitch-manage-design-system 中僅使用字串的後備工作流程,而不要重試相同的失敗呼叫。
  • 長時間運行的呼叫:如果 generate_screen_from_text 或 edit_screens 逾時,請每隔 60 秒輪詢 list_screens,最多約 5 分鐘(共 5 次輪詢);若無新畫面出現,則重新發出一次呼叫,而非無限期等待。
  • 工具映射:將通用工具名稱(Read、Write、Edit、Bash)映射到活動中的 Codot 掛載工具(read、write、edit、bash)。

從 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. 畫面元資料獲取: 對於每個畫面:

    • 使用畫面資源的 name(projects/{project}/screens/{screen})呼叫 [stitch_prefix]:get_screen
    • 擷取:
      • screenshot.name(projects/{project}/files/{file})— 影片的視覺資產
      • htmlCode.name(projects/{project}/files/{file})— 可選:用於提取文字/內容
      • width、height — 用於適當縮放的畫面尺寸
      • 用於文字覆蓋層的畫面標題與描述
  4. 資產下載:

    • 使用 screenshot.name 呼叫 Stitch MCP [stitch_prefix]:download_file(切勿對 downloadUrl 使用 curl 或 web_fetch,因為該方法需要憑證且會回傳 JSON 包裝)
    • 如果 download_file 的輸出被截斷為暫存檔案,請使用以下指令解碼: node skills/stitch/stitch-preview/scripts/save-stitch-file.mjs <tool-output> 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 以獲得專業效果:

  • 淡入淡出(Fade):畫面間的平滑淡入淡出

    import {fade} from '@remotion/transitions/fade';
    
  • 滑動(Slide):定向滑動轉場

    import {slide} from '@remotion/transitions/slide';
    
  • 縮放(Zoom):用於強調的縮放效果

    • 使用 spring() 動畫以實現平滑縮放
    • 應用於重要 UI 元素

文字覆蓋層

使用 Remotion 的文字渲染功能添加情境資訊:

  1. 畫面標題:在每個影格的頂部或底部顯示
  2. 功能標註:使用動畫指標突出顯示特定 UI 元素
  3. 描述:為每個畫面淡入描述文字
  4. 進度指示器:顯示目前畫面在解說影片中的位置

執行步驟

步驟 1:收集畫面資產

  1. 識別目標 Stitch 專案
  2. 列出專案中的所有畫面
  3. 下載每個畫面的螢幕截圖
  4. 依照解說影片流程排序
  5. 建立清單檔案(screens.json):
{
  "projectName": "Calculator App",
  "screens": [
    {
      "id": "1",
      "title": "主畫面",
      "description": "帶有數字鍵盤的主要計算機介面",
      "imagePath": "assets/screens/home.png",
      "width": 1200,
      "height": 800,
      "duration": 4
    },
    {
      "id": "2",
      "title": "歷史紀錄檢視",
      "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.name 呼叫 [stitch_prefix]:download_file(使用 save-stitch-file.mjs 解碼截斷的輸出)
  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:用戶流程

展示逐步的用戶旅程:

  • 帶有定向滑動的連續畫面流程
  • 編號步驟覆蓋層
  • 突出顯示用戶操作(點擊、觸控)
  • 使用動畫路徑連接各個畫面

疑難排解

問題解決方案
模糊的螢幕截圖確保透過 download_file(screenshot.name)下載的圖片為完整解析度,而非壓縮的縮圖
文字未對齊驗證畫面尺寸與合成大小是否匹配;根據實際畫面大小調整文字位置
動畫卡頓將影格率提高至 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. 列出專案中的畫面 → 識別所有畫面(主畫面、歷史紀錄、設定)
  3. 下載每個畫面的螢幕截圖 → 儲存至 assets/screens/
  4. 使用畫面元資料建立 screens.json 清單
  5. 生成 Remotion 組件(ScreenSlide.tsx、WalkthroughComposition.tsx)
  6. 在 Remotion Studio 中預覽 → 調整時機與轉場
  7. 渲染最終影片 → calculator-walkthrough.mp4
  8. 報告完成並附上影片預覽連結

成功祕訣

  • 從簡單開始:先使用

…

(後續內容因原始內容截斷而省略)

相關技能