Communitygithub.com

AbobakrDiara61/railway-system

從 Stitch 專案產生使用 Remotion 的逐步解說影片,包含流暢轉場、縮放效果與文字覆蓋層。

railway-system 是什麼?

此技能讓 AI 代理能將 Stitch 設計工具中的畫面,轉化為專業的 Remotion 逐步解說影片。它透過 Stitch MCP 伺服器擷取專案畫面、下載截圖,並在 Remotion 中建立一個結構化的影片組合。代理會生成 React 元件(如 `ScreenSlide.tsx`)來處理畫面顯示、縮放動畫與淡入淡出轉場,並利用 `@remotion/transitions` 套件實現流暢的過渡效果。支援的功能包括自訂文字疊加、進度指示器、熱點標註,以及可選的旁白整合。適合任何需要 Remotion MCP 伺服器或 CLI 的開發環境。整個流程涵蓋了發現 MCP 伺服器、取得 Stitch 畫面資料、產生 Remotion 元件、在 Remotion Studio 中預覽,以及最終渲染為 MP4 等影片格式。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AbobakrDiara61/railway-system/tree/HEAD/frontend/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 或 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": "主畫面",
      "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/walkthrough/ 目錄中的範例

步驟 3:預覽與調整

  1. 啟動 Remotion Studio:

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

    • 確保每個畫面有適當的顯示時間
    • 確認轉場流暢
    • 檢查文字覆蓋層的時間點
  3. 微調動畫:

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

步驟 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 技能,定義了最佳實務。請參考這些技能以學習進階技巧:

要運用的關鍵 Remotion 技能:

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

常見模式

模式 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 影片來展示這些畫面的逐步解說。

代理工作流程:

  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. 回報完成,並附上影片預覽連結

成功祕訣

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

參考資料

使用時機

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

限制

  • 僅在任務與上述範圍明確相符時使用此技能。
  • 請勿將輸出視為環境特定驗證、測試或專家審查的替代方案。
  • 若缺少必要的輸入、權限、安全邊界或成功標準,請停止並要求釐清。

Individual skills in this repo

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

AbobakrDiara61/railway-system

One sentence - what this skill does and when to invoke it

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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 悬停效果

AbobakrDiara61/railway-system

Best practices for Remotion - Video creation in React

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

One sentence - what this skill does and when to invoke it

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

相關技能