Ozor Generate（テキスト→動画）
mcp__ozor__* ツールを使用してOzor.aiでエンドツーエンドの動画生成を行います。このスキルは短いクリエイティブな概要を受け取り、完成・書き出し・共有可能な動画を返します。単なるプロンプトを返すだけではありません。
使用すべきケース
ユーザーが短いテキストアイデアから実際に動画を制作したい場合にこのスキルを使用します。兆候:
- 「〇〇についての動画を作って...」
- 「...のローンチ動画を生成して」
- 「...についての30秒の解説動画を作成して」
- 「新機能の広告を作って...」
- 「...と言う内容の動画をレンダリングして」
次の場合はこのスキルを使用しないでください:
- ユーザーがドキュメント、PDF、PPTX、DOCX、デッキ、ファイルを持っている場合 →
ozor-document-videoを使用 - ユーザーがURL / ランディングページを指定した場合 →
ozor-url-to-videoを使用 - 生成せずにOzorプロンプトを書く手助けだけが必要な場合 →
ozor-video-best-practicesを使用 - 既存の動画を管理したい場合 →
ozor-video-libraryを使用
必要なMCPツール
このスキルはOzor MCPが接続されていることを前提としています。ツールは次の通りです:
mcp__ozor__generate_video— テキストから動画へのジョブを開始mcp__ozor__wait_for_job— エージェントがプロジェクトのビルドを完了するまでブロックmcp__ozor__export_video— レンダリングを開始mcp__ozor__wait_for_export— レンダリングが完了するまでブロックし、URLを返すmcp__ozor__get_embed_code—<iframe>HTMLを返すmcp__ozor__list_voices— オプション、利用可能な音声の検索mcp__ozor__send_message— オプション、ビデオエージェントへの追従編集
Ozor MCPが接続されていない場合は、ユーザーに追加するように伝えて停止してください。プロンプトのみの出力にフォールバックしようとしないでください。
ワークフロー
ステップ 1 — 概要を整形する
Ozorプロンプトは2000文字以内に制限されており、1本の短い動画を説明する必要があります。MCPを呼び出す前に、概要に以下が含まれていることを確認してください:
- 動画の内容を一文で
- 対象視聴者（創業者、開発者、顧客、一般向け...）
- フォーマット — 16:9（デフォルト、横長）または9:16（ソーシャル用縦長）
- おおよその尺 — 通常15～90秒
- シーン数（3～6が最適）
- トーン（自信にあふれた、温かみのある、エネルギッシュ、テクニカル...）
- ビジュアルスタイル（ダーク/ライト、アクセントカラー、ミニマル/大胆）
- 最後のシーンに明確なCTA
これらのいずれかが欠けており、その不足が出力に意味のある変化をもたらす場合、1つだけ焦点を絞った質問をしてください。それ以外の場合は適切なデフォルトを選んで進めてください — オートモード動作です。
ドキュメントから抽出した複数シーンのスクリプトをこのプロンプトに貼り付けないでください。 2000文字の制限を超え、スライドのビジュアルが失われます。ドキュメントの場合は ozor-document-video に切り替えてください。
ステップ 2 — 生成
以下を呼び出します:
mcp__ozor__generate_video({
prompt: "<コンパイルされた概要、2000文字未満>",
export: true // 推奨: 自動的に書き出しをトリガーするためステップ4をスキップ可能
})
これにより { videoId, jobId } が返されます。ジョブが開始されたことと、待機中であることをユーザーに通知します。
ステップ 3 — ビルドを待機
以下を呼び出します:
mcp__ozor__wait_for_job({ videoId, jobId })
Ozorエージェントがプロジェクトのビルドを完了するまでブロックします。失敗した場合、エラーメッセージは通常、プロンプトのどこを修正すべきかを示します — その内容をユーザーに伝え、調整して再試行することを提案します。
ステップ 4 — 書き出し（ステップ2で export: true を渡した場合はスキップ）
ステップ2で export: true を渡さなかった場合、以下を呼び出します:
mcp__ozor__export_video({ videoId })
ステップ 5 — レンダリングを待機
以下を呼び出します:
mcp__ozor__wait_for_export({ videoId })
これにより最終的なURLが返されます:
shareUrl— レンダリングされた動画への公開リンクeditorUrl— さらなる調整のためのOzorエディタリンクdownloadUrl— 直接MP4ダウンロードリンク
ステップ 6 — 埋め込みコードを取得
以下を呼び出します:
mcp__ozor__get_embed_code({ videoId })
すぐに貼り付け可能な <iframe> スニペットが返されます。
ステップ 7 — 結果をユーザーに提示
以下の形式で出力します:
🎬 動画準備完了
**共有:** <shareUrl>
**エディタ:** <editorUrl>
**ダウンロード:** <downloadUrl>
**埋め込み:**
```html
<iframe ...></iframe>
さらに編集しますか？ 以下のことができます:
- 特定のシーンを変更
- 別のトーンやビジュアルスタイルを試す
- 9:16のソーシャル版を制作
## 反復
ユーザーが結果を見た後に変更を希望する場合は、`mcp__ozor__send_message({ videoId, message: "<変更リクエスト>" })` を使用し、ステップ3～6を再実行します（エージェントがプロジェクトを再ビルドするため、新たな書き出しが必要です）。
より大きな方向転換（異なるトピック、異なる視聴者）の場合は、反復するのではなく新しい `generate_video` 呼び出しを開始してください — プロンプトの予算が少なく、その場での方向転換は出力を曖昧にする傾向があります。
## オートモードで想定するデフォルト値
ユーザーが一言の概要を与え、こちらから問い詰めたくない場合:
| フィールド | デフォルト |
|--------|--------|
| フォーマット | 16:9 横長 |
| 尺 | 約30秒 |
| シーン数 | 3～4 |
| トーン | 自信にあふれた、モダン |
| スタイル | クリーン、ミニマル、アクセントカラー1色 |
| CTA | プレースホルダーURL/ハンドルがあれば「詳しくはこちら」 |
返信の中で想定したデフォルト値を明示することで、ユーザーが修正できるようにします。
## `generate_video` 呼び出し前の品質チェックリスト
- [ ] プロンプトが2000文字未満である
- [ ] 1つの明確なトピックであり、複数トピックのエッセイではない
- [ ] フック（冒頭）がシーン1で述べられている
- [ ] CTAが最終シーンで述べられている
- [ ] ビジュアルスタイル + トーン + 対象視聴者が指定されている
- [ ] ドキュメントからのコピーされた散文がない — それは `ozor-document-video` の担当
## エラーと復旧
- **MCPが利用不可** → ユーザーにOzor MCPが接続されていないことを伝えて停止。ペーパープロンプトを書くことにフォールバックしない。
- **`generate_video` がプロンプト長すぎで失敗** → 概要を圧縮し、冗長なスタイルノートを削除して再試行。
- **`wait_for_job` が失敗を返す** → エラーをそのまま伝え、修正方法を提案（多くの場合: プロンプトを簡略化、曖昧なシーンの指示を削除）、再試行を提案。
- **`wait_for_export` がタイムアウト** → 再呼び出ししても安全。Ozorが中断したところから書き出しが再開される。
## ルール
1. **実際にMCPを実行すること。** このスキルは動画を制作するためのものであり、プロンプトではありません。テキストだけを返した場合は、スキルの失敗です。
2. **5つの質問をしないこと。** 多くても1つの焦点を絞った質問をし、残りはデフォルト値にします。
3. **すべてのURLを表示すること。** `shareUrl`、`editorUrl`、`downloadUrl`、埋め込みコードはそれぞれ異なるコンテキストで価値があります — すべて表示してください。
4. **2000文字のプロンプト制限を尊重すること。** 概要が上限を超えた場合は、送信前にトリミングしてください。
5. **デフォルトで `generate_video` に `export: true` を使用すること** — ツール呼び出しが1つ減り、完成動画への経路が速くなります。