Codot ランタイム適応
- Stitch MCP: Codot 設定 → MCP から一元提供されます(
stitch:またはmcp__stitch__プレフィックスが付いたツールを探してください)。エージェントごとにMCPファイルを再設定しないでください。- ブラウザとビジュアル確認: ローカル開発サーバーやレンダリング済みページを検査する際は、外部のChrome DevTools MCPよりもCodot組み込みの
browser_*ツール(browser_navigate、browser_snapshot、browser_screenshot、browser_console)を優先してください。- ビジュアル配信:
show_previewはオフラインでネットワークにアクセスできません。StitchエクスポートHTMLはCDNのTailwind/フォントに依存するため、直接渡すと空白でレンダリングされます。stitch-previewスキル(ローカル静的サーバー+完全な忠実度/インタラクションのためのbrowser_*、またはstitch-offline.mjs+チャット内HTMLプレビューのためのshow_preview、または.pngスクリーンショットに直接show_preview)を使用してください。- アセットダウンロード: 常にStitch MCPの
download_file(htmlCode.name/screenshot.nameを指定)を使用し、curlでdownloadUrlを取得しないでください(認証情報が必要で、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がタイムアウトした場合、list_screensを60秒ごとに最大約5分間(5回ポーリング)ポーリングします。新しい画面が表示されない場合は、無限に待機せずに呼び出しを1回再発行します。- ツールマッピング: 汎用ツール名(
Read、Write、Edit、Bash)をアクティブなCodotハーネスツール(read、write、edit、bash)にマッピングします。
Stitch to 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— 適切なスケーリングのための画面寸法- テキストオーバーレイ用の画面タイトルと説明
- 画面リソースの
-
アセットダウンロード:
- Stitch MCP
[stitch_prefix]:download_fileをscreenshot.nameを指定して呼び出す(downloadUrlにcurlやweb_fetchを使用しないでください。認証情報が必要でJSONラッパーを返します) download_fileの出力が一時ファイルに切り詰められた場合は、以下でデコードする:node skills/stitch/stitch-preview/scripts/save-stitch-file.mjs <tool-output> assets/screens/{screen-name}.png- アセットを意図したウォークスルーフロー順に整理する
- Stitch MCP
ステップ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 を使用してプロフェッショナルな効果を実現:
-
フェード: 画面間のスムーズなクロスフェード
import {fade} from '@remotion/transitions/fade'; -
スライド: 方向性のあるスライドトランジション
import {slide} from '@remotion/transitions/slide'; -
ズーム: 強調のためのズームイン/アウト効果
- スムーズなズームには
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.jsのバージョン互換性を確認; すべての依存関係がインストールされていることを確認; Remotionのドキュメントを参照 |
| タイミングがずれている | マニフェストで画面ごとの再生時間を調整; Remotion Studioでプレビュー; 実際のユーザーでテスト |
ベストプラクティス
- アスペクト比を維持: 実際のStitch画面サイズを使用するか、比例してスケーリング
- 一貫したタイミング: 特定の画面を強調する場合を除き、画面表示時間を一定に保つ
- 読みやすいテキスト: 十分なコントラストを確保; 適切なフォントサイズを使用; 過密なオーバーレイを避ける
- スムーズなトランジション: 自然な動きにスプリングアニメーションを使用; 不自然なカットを避ける
- 完全にプレビュー: 最終レンダリング前に必ずRemotion Studioでプレビュー
- アセットを最適化: 画像は適切に圧縮; 効率的な形式を使用(UIにはPNG、写真にはJPG)
使用例
ユーザープロンプト:
Stitchプロジェクトの「Calculator App」にある画面を調べて、各画面のウォークスルーを
表示するremotion動画を作成してください。
エージェントのワークフロー:
- Stitchプロジェクトを一覧表示 → 「Calculator App」を見つける → プロジェクトIDを抽出
- プロジェクト内の画面を一覧表示 → すべての画面(Home、History、Settings)を特定
- 各画面のスクリーンショットをダウンロード →
assets/screens/に保存 - 画面メタデータを含む
screens.jsonマニフェストを作成 - Remotionコンポーネントを生成(
ScreenSlide.tsx、WalkthroughComposition.tsx) - Remotion Studioでプレビュー → タイミングとトランジションを調整
- 最終動画をレンダリング →
calculator-walkthrough.mp4 - 完了を報告し、動画プレビューリンクを提供
成功のためのヒント
- シンプルに始める: 基本的なスライドショーから始め、徐々に高度な機能を追加
- 段階的に反復: 頻繁にプレビューして、早期に問題を発見
- アセットを整理: スクリーンショットに明確な名前を付け、ディレクトリ構造を維持
- Remotionコミュニティを活用: 複雑なアニメーションの例や解決策を公式ドキュメントやディスカッションで参照