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"で呼び出す- タイトル(例:「電卓アプリ」)で対象プロジェクトを特定
nameフィールドからプロジェクトIDを抽出(例:projects/13534454087919359824)
-
画面の一覧取得:
[stitch_prefix]:list_screensをプロジェクトID(数値のみ)で呼び出す- 画面タイトルを確認し、ウォークスルーに使用する全画面を特定
- 各画面の
nameフィールドから画面IDを抽出
-
画面メタデータの取得: 各画面について:
[stitch_prefix]:get_screenをprojectIdとscreenIdで呼び出す- 以下のデータを取得:
screenshot.downloadUrl— 動画用のビジュアルアセットhtmlCode.downloadUrl— オプション:テキスト/コンテンツ抽出用width,height— 適切なスケーリングのための画面サイズ- 画面タイトルと説明文(テキストオーバーレイ用)
-
アセットのダウンロード:
web_fetchまたはBashのcurlを使用してスクリーンショットをダウンロード- ステージングディレクトリに保存:
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— 個別画面表示コンポーネント- プロパティ:
imageSrc,title,description,width,height - 機能: ズームインアニメーション、フェードトランジション
- 時間: 設定可能(デフォルト1画面あたり3~5秒)
- プロパティ:
-
WalkthroughComposition.tsx— メインの動画コンポジション- 複数の
ScreenSlideコンポーネントを連続配置 - 画面間のトランジションを処理
- テキストオーバーレイと注釈を追加
- 複数の
-
config.ts— 動画設定- フレームレート(デフォルト: 30 fps)
- 動画サイズ(Stitch画面サイズに合わせるか、適宜スケーリング)
- 合計時間の計算
トランジション効果
プロフェッショナルなエフェクトにはRemotionの @remotion/transitions を使用:
-
フェード: スクリーン間のスムーズなクロスフェード
import {fade} from '@remotion/transitions/fade'; -
スライド: 方向性のあるスライドトランジション
import {slide} from '@remotion/transitions/slide'; -
ズーム: 強調のためのズームイン/アウト効果
spring()アニメーションを使用してスムーズなズームを実現- 重要なUI要素に適用
テキストオーバーレイ
Remotionのテキストレンダリング機能を使用してコンテキスト情報を追加:
- 画面タイトル: 各フレームの上部または下部に表示
- 機能コールアウト: アニメーション付きポインターで特定のUI要素を強調
- 説明文: 各画面の説明テキストをフェードイン
- 進行状況インジケーター: ウォークスルー内の現在位置を表示
実行手順
ステップ1: 画面アセットの収集
- 対象のStitchプロジェクトを特定
- プロジェクト内の全画面を一覧表示
- 各画面のスクリーンショットをダウンロード
- ウォークスルーのフロー順に整理
- マニフェストファイル(
screens.json)を作成:
{
"projectName": "電卓アプリ",
"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/walkthrough/ディレクトリの例を確認
ステップ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.downloadUrlをダウンロード - 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は独自のAgent Skillsを管理しており、ベストプラクティスを定義しています。高度なテクニックについては以下を参照:
- リポジトリ: https://github.com/remotion-dev/remotion/tree/main/packages/skills
- インストール:
npx skills add remotion-dev/skills
活用すべき主要なRemotionスキル:
- アニメーションのタイミングとイージング
- コンポジションアーキテクチャパターン
- パフォーマンス最適化
- 音声同期
一般的なパターン
パターン1: シンプルなスライドショー
フェードトランジションを使用した基本的なウォークスルー:
- 画面あたり3~5秒
- クロスフェードトランジション
- 画面タイトルの下部テキストオーバーレイ
- 上部のプログレスバー
パターン2: 機能強調
特定のUI要素に焦点:
- 特定領域へのズームイン
- 機能を指すアニメーション円/矢印
- キー操作へのスローモーション強調
- ビフォー/アフターの並列比較
パターン3: ユーザーフロー
ステップごとのユーザージャーニーを表示:
- 方向性スライドによる連続画面フロー
- 番号付きステップのオーバーレイ
- ユーザーアクション(クリック、タップ)の強調
- アニメーションパスで画面を接続
トラブルシューティング
| 問題 | 解決方法 |
|---|---|
| ぼやけたスクリーンショット | ダウンロード画像がフル解像度であることを確認; screenshot.downloadUrl の品質設定を確認 |
| テキストの位置ずれ | 画面サイズがコンポジションサイズと一致していることを確認; 実際の画面サイズに基づいてテキスト位置を調整 |
| カクつくアニメーション | フレームレートを60fpsに上げる; 適切なダンピング設定でspringを使用 |
| Remotionビルド失敗 | Nodeバージョンの互換性を確認; すべての依存関係がインストールされていることを確認; Remotionのドキュメントを参照 |
| タイミングが合わない | マニフェストで画面ごとの時間を調整; Remotion Studioでプレビュー; 実際のユーザーでテスト |
ベストプラクティス
- アスペクト比を維持: 実際のStitch画面サイズを使用するか、比例拡大縮小
- 一貫したタイミング: 特定の画面を強調する場合を除き、画面表示時間を一定に
- 読みやすいテキスト: 十分なコントラストを確保; 適切なフォントサイズを使用; オーバーレイが密集しすぎないようにする
- スムーズなトランジション: 自然な動きのためにspringアニメーションを使用; 唐突なカットを避ける
- 徹底的なプレビュー: 最終レンダリング前に必ずRemotion Studioでプレビュー
- アセットの最適化: 画像を適切に圧縮; 効率的なフォーマットを使用(UIにはPNG、写真にはJPG)
使用例
ユーザープロンプト:
Stitchプロジェクト「電卓アプリ」の画面を調べて、画面のウォークスルーを表示するremotion動画を
作成してください。
エージェントワークフロー:
- Stitchプロジェクト一覧 → 「電卓アプリ」を検索 → プロジェクトIDを抽出
- プロジェクト内の画面一覧 → 全画面を特定(ホーム、履歴、設定)
- 各画面のスクリーンショットをダウンロード →
assets/screens/に保存 - 画面メタデータを含む
screens.jsonマニフェストを作成 - Remotionコンポーネント(
ScreenSlide.tsx,WalkthroughComposition.tsx)を生成 - Remotion Studioでプレビュー → タイミングとトランジションを調整
- 最終動画をレンダリング →
calculator-walkthrough.mp4 - 動画プレビューリンクとともに完了を報告
成功のためのヒント
- シンプルに始める: 複雑なアニメーションを追加する前に、基本的なフェードトランジションから開始
- Remotionパターンに従う: Remotionの公式スキルとドキュメントを活用
- マニフェストファイルを使用: 画面データをJSONで整理し、簡単に更新できるようにする
- 頻繁にプレビュー: Remotion Studioを使用して早期に問題を発見
- アクセシビリティを考慮: キャプションを追加; テキストが読みやすいことを確認; 明確なビジュアルを使用
- プラットフォームに合わせて最適化: ターゲットプラットフォーム(YouTube、ソーシャルメディアなど)に合わせて動画サイズを調整
リファレンス
- Stitch Documentation: https://stitch.withgoogle.com/docs/
- Remotion Documentation: https://www.remotion.dev/docs/
- Remotion Skills: https://www.remotion.dev/docs/ai/skills
- Remotion MCP: https://www.remotion.dev/docs/ai/mcp
- Remotion Transitions: https://www.remotion.dev/docs/transitions
使用タイミング
このスキルは、上記の主要なドメインや機能に関連するタスクに取り組む場合に使用します。
制限事項
- このスキルは、タスクが上記の範囲に明確に合致する場合にのみ使用してください。
- 出力を環境固有の検証、テスト、専門家によるレビューの代わりとして扱わないでください。
- 必要な入力、権限、安全上の境界、成功基準が不足している場合は、立ち止まって明確化を求めてください。