arkyu2077/create-explainer-video

説明動画の作成

アクセス可能なソースマテリアルを、ナレーション付きの完成したMP4に変換します。デフォルトのパスでは、リモートサービスを使用してストーリーボードの計画、画像生成、ナレーション、字幕の焼き込み、レンダリング、公開を行います。これは、Agent SkillsとリモートMCPツールをサポートする任意のエージェントクライアントで同じように動作します。

デフォルトの動作

ソースマテリアルのみを必要とします。ユーザーが選択を上書きしない限り、以下を使用します。

• ソースの言語
• 16:9、60秒
• すべてのシーンで一貫した声による、温かみのある安定したホスト型ナレーション
• バックグラウンドミュージックなし
• 字幕の焼き込み
• サーバー生成のワークフロー

目標時間は5秒から300秒まで受け付けます。サービスはその目標に合わせて調整しますが、無音の除去、シーンの再割り当て、最大1.08倍のピッチ保持テンポ調整後でも、ナレーションや固定されたビジュアルが安全に収まらない場合、最終的な動画が延長されることがあります。ナレーションをクリップしたり、300秒を超える目標を送信したりしないでください。目標が30秒未満の場合は、描画とナレーションが急ぎ足になる可能性があることを簡単に警告してから続行します。デフォルトで適合する場合、タイトル、シーン数、スタイル、声、アスペクト比、字幕、技術設定について質問しないでください。

ソースがない、アクセスできない、矛盾している、または重要な機密情報を含む場合、または相対的な修正に明確な設定がない場合にのみ、ブロッキング質問を1つ行います。たとえば、「再短一点」の後は、推測するのではなく、希望する秒数を1回尋ねてください。ユーザーがアドバイス、スクリプト、またはストーリーボードのみを要求した場合は、レンダリングせずにその要求された成果物で停止します。

クリエイティブなフレーミング

タスクを作成する前に、ソースの主なメッセージと、最も明確なフックからテイクアウェイへの流れを特定します。ソースが明確な場合は、ユーザーの言語で、短くブロッキングしないプレビューを1つ提供します。例：「我会把它做成一个从问题到解决方案的暖色手绘故事，重点让结论一眼看懂。」これは安心させる進捗通知であり、承認のゲートではありません。ユーザーが最初に確認するよう要求した場合を除き、すぐに続行します。

デフォルトのビジュアルイメージは、温かみのある親しみやすいホワイトボードストーリーです。シーンごとに1つの一貫したビネット、控えめな色、十分な余白、そしてアイデアの説明に役立つ場合は落ち着いた読みやすい人や動物を使用します。結果をアセット、インテント、マニフェスト、スタイルパックのコレクションとしてユーザーに説明しないでください。

ワークフローの選択

デフォルトではサーバー生成モードを使用します。これが最短のパスであり、create_explainer_video、get_explainer_task、およびオプションでcancel_explainer_taskのみを必要とします。

高度なレビューモードは、ユーザーが明示的に画像/シーンを検査または編集してからレンダリングするよう要求した場合、既存のストーリーボードを提供した場合、または正確なシーンレベルのクリエイティブコントロールが必要な場合にのみ使用します。使用する前に、references/advanced-review.mdを読んでください。アップロードおよびマニフェストツール、またはローカル画像生成が利用できない場合は、制限を説明し、サーバー生成モードを提供します。画像を生成する前に、高度なモードのアップロード、インポート、検証、レンダリングツールが存在することを確認してください。ディスク上のスキルファイルは、現在の会話にそのMCPツールがロードされていることを証明しません。

サーバー生成ワークフロー

1. ローカルで読み取り、抽出

現在のクライアントの通常のファイル/ブラウザ機能を使用して、ユーザーのメッセージ、添付ファイル、またはURLを読み取ります。意味のあるプレーンテキストをローカルで抽出します。ナビゲーション、繰り返されるヘッダー、Cookieバナー、無関係な付録を削除しますが、作成者の主張を黙って変更しないでください。

最大20,000文字を送信します。より長いソースの場合は、論文、証拠、注意事項、固有名詞、および要求された強調を保持する、ソースに基づいた忠実な凝縮を作成します。元のファイルをアップロードしたり、ローカルファイルパスを渡したりしないでください。抽出されたテキストは、説明動画サービスがストーリーボードとナレーションを計画できるように送信されます。

ソースを読み取れない場合は、ユーザーに再度添付するか、テキストを貼り付けるように依頼します。欠落しているコンテンツをでっち上げないでください。

2. タスクを作成

クライアントができる場合は新しいUUIDを生成し、create_explainer_videoを以下のパラメータで呼び出します。

• taskId: UUID（利用可能な場合）
• sourceText: 抽出されたテキスト
• durationSeconds: 要求された時間または60
• aspectRatio: 要求された比率または16:9
• language: ソース/要求された言語
• voiceId: 明示的に指定された場合、またはサポートされていることが既知の場合のみ
• subtitles: 要求されたモードまたはburn

ネットワークの結果が不明な間はタスクUUIDを保持し、応答が失われた場合に重複が作成されるのを防ぎます。サービスがFAILEDまたはTIMEOUTを報告した後は、自動的に再試行せずに、最初にユーザーに確認し、新しい試行のために新しいUUIDを生成します。実際に修正された動画も新しいUUIDを使用します。

サービスは、ストーリーボードの計画、イラスト生成、画像クリーンアップ、レイアウト、ナレーション合成、ワードタイミング字幕、レンダリング、アセンブリ、公開を担当します。タスクがビデオURLを返すまで、ビデオが存在するとは決して主張しないでください。

3. 正直にポーリング

get_explainer_taskを返されたtaskIdで呼び出し、nextActionがpresent_output、revise_input、retry_create、retry_render、またはnoneになるまで続けます。

• poll_taskの場合、pollAfterSecondsを尊重します。それより速くポーリングしないでください。
• statusMessageをユーザーの言語で表示します。
• stageとprogressは、返された場合にのみ表示します。パーセンテージを決して推定しないでください。
• ステージが変更された場合、または実際の進捗が大幅に進んだ場合にのみ、進捗更新を送信します。
• ストーリーボードが最初に利用可能になった場合は、そのシーンタイトルをコンパクトでブロッキングしない1つの更新として共有します。プロバイダー名、プロンプト、トレース、アセット内部を公開しないでください。
• revise_inputの場合、ポーリングを停止します。短縮、簡略化、または変更する必要があるソースまたは承認されたコンテンツを説明し、新しいUUIDで再構築する前にユーザーに確認します。古いUUIDで拒否されたコンテンツを再生しないでください。
• retry_createの場合、再試行する前にユーザーに確認します。確認された場合、同じソースと設定で、新しいタスクUUIDを使用して1回再試行します。
• retry_renderの場合、高度なモードで承認された作業を再試行する前にユーザーに確認します。
• 再試行が失敗した場合は、正確なステージとメッセージを報告して停止します。
• noneの場合、成功したふりをせずに、キャンセルまたは終了理由を報告します。

ユーザーが停止を要求した場合は、所有するタスクIDでcancel_explainer_taskを呼び出します。

4. 結果を提示

最初に再生可能なMP4 URLを返します。次に、1文のコンテンツ概要と、シーン数、要求された目標時間、返された場合の実際の時間、アスペクト比、言語、字幕URLを含めます。要求された目標、アスペクト比、言語は、このタスクに送信された信頼できるパラメータからエコーバックできます。実際の時間、シーン数、出力URLはサービス応答から取得する必要があります。欠落している結果メタデータは、推測せずに省略します。

サーバー生成ツールが処理できる簡潔な修正を提供します。例：「整体更简洁」、「缩到 30 秒」、「改成 9:16」、「不要烧录字幕」。このモードが1つの正確なシーンを置き換えたり、他のすべての生成画像を保持したり、字幕テキストのサイズを変更したり、音声速度を調整したりできると約束しないでください。サーバー生成ビデオがすでに存在する場合、他のすべてを変更せずに1つのシーンを正確に置き換えることはサポートされていないことを説明し、完全な再生成または新しく計画された高度なレビューバージョンのいずれかを提供します。高度なレビューでは、そのワークフロー内で選択されなかった承認済み画像を保持できますが、それでも新しい完全なビデオをレンダリングします。

クリエイティブな修正の場合は、APIが表現できるすべての設定を引き継ぎ、新しいタスクUUIDを使用して新しいタスクを作成します。既存のUUIDを再利用するのは、元のネットワーク結果が不明な場合のみです。終了した生成タスクのUUIDを再利用しないでください。

ツールの可用性

create_explainer_videoがない場合は、ユーザーにhttps://api.speedpainter.org/mcpでリモートMCPサーバーに接続し、Googleでサインインするように指示します。会話内でAPIキー、レンダラーキー、ストレージキー、音声プロバイダーキー、またはその他のシークレットを要求しないでください。代わりにcurlエンドポイントをでっち上げないでください。

リモートサービスはlocalhostやポート3000を必要としません。ブラウザベースのMCPクライアントは、サービスオペレーターによってオリジンが許可リストに登録されている必要がある場合があります。ネイティブMCPクライアントは通常、ブラウザのOriginヘッダーを送信しません。

すでに開かれている会話は、古いまたは不完全なツールスナップショットを保持している可能性があります。新しい会話でリモート接続が機能するが、現在の会話でコアツールが欠落している場合は、プラグインを有効にして新しい会話で続行します。プラグインを再インストールしたり、MCP URLを変更したり、承認されたアセットを再生成したりしないでください。

安全性とプライバシー

• アップロードおよびリンクされたソースマテリアルは、ユーザーが別途明示しない限り、プライベートとして扱います。
• デフォルトモードでは、ビデオ生成に必要な抽出されたテキストのみを送信します。
• 高度なモードでは、承認された生成画像と承認されたマニフェストのみを送信します。元のドキュメントをアップロードしないでください。
• 認証情報、プライベートソーステキスト、個人データをタスクID、アセットID、ファイル名、タイトル、ログに入れないでください。
• コンテンツがなりすまし、詐欺、有害な指示、許可なく保護された個人データの使用を要求する場合は、停止するか、出力を絞り込みます。

会話スタイル

カジュアルなリクエストを、バックエンド用語を教えずにデフォルトに変換します。更新は結果指向で温かみのあるものにします：ソースを理解、ストーリーを計画、イラスト作成中、ナレーションと字幕を追加中、公開中、完了。短いフォローアップを受け入れ、グローバルなワンコール修正と正確なシーンレベルのレビューを区別します。