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 專案資訊
-
專案查詢(若未提供專案 ID):
- 呼叫
[stitch_prefix]:list_projects,參數為filter: "view=owned" - 透過標題(例如 "Calculator App")識別目標專案
- 從
name欄位提取專案 ID(例如projects/13534454087919359824)
- 呼叫
-
畫面擷取:
- 使用專案 ID(僅限數值)呼叫
[stitch_prefix]:list_screens - 檢閱畫面標題以識別所有用於解說影片的畫面
- 從每個畫面的
name欄位提取畫面 ID
- 使用專案 ID(僅限數值)呼叫
-
畫面元資料獲取: 對於每個畫面:
- 使用畫面資源的
name(projects/{project}/screens/{screen})呼叫[stitch_prefix]:get_screen - 擷取:
screenshot.name(projects/{project}/files/{file})— 影片的視覺資產htmlCode.name(projects/{project}/files/{file})— 可選:用於提取文字/內容width、height— 用於適當縮放的畫面尺寸- 用於文字覆蓋層的畫面標題與描述
- 使用畫面資源的
-
資產下載:
- 使用
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 專案
-
檢查現有 Remotion 專案:
- 尋找
remotion.config.ts或包含 Remotion 依賴項的package.json - 如果存在,則使用現有的專案結構
- 尋找
-
建立新的 Remotion 專案(若需要):
npm create video@latest -- --blank- 選擇 TypeScript 模板
- 在專屬的
video/目錄中設定
-
安裝依賴項:
cd video npm install @remotion/transitions @remotion/animated-emoji
影片合成策略
架構
建立一個由以下組件組成的模組化 Remotion 合成:
-
ScreenSlide.tsx— 獨立畫面顯示組件- Props:
imageSrc、title、description、width、height - 功能:縮放動畫、淡入淡出轉場
- 持續時間:可設定(預設每個畫面 3-5 秒)
- Props:
-
WalkthroughComposition.tsx— 主要影片合成- 將多個
ScreenSlide組件排序 - 處理畫面間的轉場
- 添加文字覆蓋層與註解
- 將多個
-
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 的文字渲染功能添加情境資訊:
- 畫面標題:在每個影格的頂部或底部顯示
- 功能標註:使用動畫指標突出顯示特定 UI 元素
- 描述:為每個畫面淡入描述文字
- 進度指示器:顯示目前畫面在解說影片中的位置
執行步驟
步驟 1:收集畫面資產
- 識別目標 Stitch 專案
- 列出專案中的所有畫面
- 下載每個畫面的螢幕截圖
- 依照解說影片流程排序
- 建立清單檔案(
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 最佳實務建立影片組件:
-
建立
ScreenSlide.tsx:- 使用
useCurrentFrame()和spring()進行動畫處理 - 實現縮放與淡入淡出效果
- 以適當的時機添加文字覆蓋層
- 使用
-
建立
WalkthroughComposition.tsx:- 匯入畫面清單
- 使用
<Sequence>組件對畫面進行排序 - 在畫面之間應用轉場效果
- 計算適當的時機與偏移量
-
更新
remotion.config.ts:- 設定合成 ID
- 設定影片尺寸
- 設定影格率與持續時間
參考資源:
- 使用
resources/screen-slide-template.tsx作為起點 - 遵循
resources/composition-checklist.md以確保完整性 - 檢閱
examples/目錄中的範例
步驟 3:預覽與調整
-
啟動 Remotion Studio:
npm run dev- 開啟基於瀏覽器的預覽
- 允許即時編輯與調整
-
調整時機:
- 確保每個畫面都有適當的顯示持續時間
- 驗證轉場是否流暢
- 檢查文字覆蓋層的時機
-
微調動畫:
- 調整縮放效果的彈簧設定
- 修改轉場的緩動函數
- 確保文字在所有時間都可讀
步驟 4:渲染影片
-
使用 Remotion CLI 渲染:
npx remotion render WalkthroughComposition output.mp4 -
替代方案:使用 Remotion MCP(如果可用):
- 使用合成詳細資訊呼叫
[remotion_prefix]:render - 指定輸出格式(MP4、WebM 等)
- 使用合成詳細資訊呼叫
-
最佳化選項:
- 設定品質等級(
--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>
);
};
旁白整合
為解說影片添加旁白:
- 根據畫面描述生成旁白稿
- 使用文字轉語音或錄製音訊
- 使用
<Audio>組件將音訊匯入 Remotion - 將畫面時機與旁白節奏同步
動態文字提取
從 Stitch HTML 程式碼中提取文字以進行自動註解:
- 對每個畫面使用
htmlCode.name呼叫[stitch_prefix]:download_file(使用save-stitch-file.mjs解碼截斷的輸出) - 解析 HTML 以提取關鍵文字元素(標題、按鈕、標籤)
- 為重要的 UI 元素生成自動標註
- 作為定時文字覆蓋層添加到合成中
檔案結構
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 維護其自身的代理技能,其中定義了最佳實務。請查閱這些技能以了解進階技術:
- 儲存庫:https://github.com/remotion-dev/remotion/tree/main/packages/skills
- 安裝方式:
npx skills add remotion-dev/skills
需利用的關鍵 Remotion 技能:
- 動畫時機與緩動
- 合成架構模式
- 效能最佳化
- 音訊同步
常見模式
模式 1:簡單的幻燈片放映
使用淡入淡出轉場的基本解說:
- 每個畫面 3-5 秒
- 交叉淡入淡出轉場
- 底部文字覆蓋層顯示畫面標題
- 頂部進度條
模式 2:功能亮點
聚焦於特定 UI 元素:
- 縮放至特定區域
- 指向功能的動畫圓圈/箭頭
- 關鍵互動的慢動作強調
- 並排的修改前/修改後比較
模式 3:用戶流程
展示逐步的用戶旅程:
- 帶有定向滑動的連續畫面流程
- 編號步驟覆蓋層
- 突出顯示用戶操作(點擊、觸控)
- 使用動畫路徑連接各個畫面
疑難排解
| 問題 | 解決方案 |
|---|---|
| 模糊的螢幕截圖 | 確保透過 download_file(screenshot.name)下載的圖片為完整解析度,而非壓縮的縮圖 |
| 文字未對齊 | 驗證畫面尺寸與合成大小是否匹配;根據實際畫面大小調整文字位置 |
| 動畫卡頓 | 將影格率提高至 60fps;使用帶有適當阻尼設定的彈簧設定 |
| Remotion 建置失敗 | 檢查 Node 版本相容性;確保已安裝所有依賴項;查閱 Remotion 文件 |
| 時機感覺不對 | 在清單中調整每個畫面的持續時間;在 Remotion Studio 中預覽;與實際用戶一起測試 |
最佳實務
- 保持長寬比:使用實際的 Stitch 畫面尺寸或按比例縮放
- 一致的時機:除非要強調特定畫面,否則保持畫面顯示持續時間一致
- 可讀的文字:確保足夠的對比度;使用適當的字體大小;避免雜亂的覆蓋層
- 流暢的轉場:使用彈簧動畫以實現自然的運動;避免突兀的切換
- 徹底預覽:在最終渲染前,務必在 Remotion Studio 中預覽
- 最佳化資產:適當壓縮圖片;使用高效格式(UI 用 PNG,照片用 JPG)
使用範例
用戶提示:
請查閱我 Stitch 專案 "Calculator App" 中的畫面,並建立一個 Remotion 影片,
以展示這些畫面的逐步解說。
代理工作流程:
- 列出 Stitch 專案 → 找到 "Calculator App" → 提取專案 ID
- 列出專案中的畫面 → 識別所有畫面(主畫面、歷史紀錄、設定)
- 下載每個畫面的螢幕截圖 → 儲存至
assets/screens/ - 使用畫面元資料建立
screens.json清單 - 生成 Remotion 組件(
ScreenSlide.tsx、WalkthroughComposition.tsx) - 在 Remotion Studio 中預覽 → 調整時機與轉場
- 渲染最終影片 →
calculator-walkthrough.mp4 - 報告完成並附上影片預覽連結
成功祕訣
- 從簡單開始:先使用
…
(後續內容因原始內容截斷而省略)