動画ショートフォームスキル
ショートフォーム(10 秒以下)は、現在のテキスト→動画モデルにとって最適な長さです — 1 つの ショット と 1 つの アイデア に優れており、マルチカットのナラティブは苦手です。1 回の呼び出しにつき 1 ショットを計画してください。
特別なケース: hyperframes-html は フォトリアルなテキスト→動画モデルではありません。これはローカルの HTML→MP4 レンダラーです。このモデルでは、撮影技法や「現実世界」のカメラ物理をロールプレイしないでください。代わりに、その指示をモーションデザインカード / タイトルフレーム / 商品インターティシャルとして扱い、最大で 1 つの確認質問をし、その後すぐにディスパッチしてください。
リソースマップ
video-shortform/
├── SKILL.md
└── example.html
ワークフロー
ステップ 0 — プロジェクトメタデータを読む
videoModel、videoLength(秒)、videoAspect。これらはハードロックです — 選択したモデルがサポートする範囲にプロンプトを制限してください(Seedance 2 は 10 秒まで、Kling 4 は 10 秒+画像→動画対応、Veo 3 は 8 秒+音声対応)。
ステップ 1 — ショットを計画する
モデルを呼び出す 前に ショットリストを作成してください:
| スロット | 内容 |
|---|---|
| 被写体 | フレーム内に何があるか? |
| カメラ | 固定 / パン / プッシュイン / オービット? |
| 照明 | キーライトの方向+色温度 |
| モーション | 何が、どのペースで動くか? 被写体の動き vs カメラの動き。 |
| サウンド | アンビエントサウンド?(モデルが音声をサポートしている場合のみ) |
通常は、ディスパッチ前にこれを 1 文の計画としてユーザーに表示してください — ユーザーは低コストで方向転換できます。
hyperframes-html の場合は、ユーザーが発見フォームに回答した後は、ディスパッチ前の追加ナレーションをスキップしてください。計画を実際の生成プロンプトに統合し、すぐにディスパッチします。
ステップ 2 — プロンプトを作成する
上流モデルが好む形式を使用してください(Seedance:モーション+カメラ+雰囲気、Kling:被写体+カメラ+スタイル、Veo:被写体+撮影技法+サウンド)。プロジェクトの videoAspect と videoLength は API パラメータに直接バインドし、決してプロンプトの散文に入れないでください。
hyperframes-html の場合は、カメラリアリズムのプロンプトではなく、簡潔なモーションデザインブリーフを作成してください。被写体、レイアウト、パレット、モーション特性、全体的なトーンに焦点を当ててください。環境チェック、不足しているサイドファイル、または「これからディスパッチします」といったステータス更新をナレーションするターンを費やさないでください。
ステップ 3 — メディア契約を介してディスパッチする
統一ディスパッチャーを使用してください — プロバイダ API を手動で呼び出さ ない でください:
"$OD_NODE_BIN" "$OD_BIN" media generate \
--project "$OD_PROJECT_ID" \
--surface video \
--model "<videoModel from metadata>" \
--aspect "<videoAspect from metadata>" \
--length <videoLength seconds> \
--output "<short-slug>-<seconds>s.mp4" \
--prompt "<assembled shot prompt from Step 2>"
このコマンドは、1 行の JSON を出力します:{"file": {"name": "...", ...}}。バイトデータはプロジェクトに保存され、ファイルビューアで自動再生されます。
ステップ 4 — ハンドオフ
次の内容で返信してください:ショットの概要、ディスパッチャーが返したファイル名、およびユーザーがバリエーションを希望する場合の試すべきことの 1 文。
hyperframes-html の場合は、返信を特に短くしてください:レンダリングした内容、ファイル名、および 1 つの具体的なバリエーション案。
ハードルール
- 1 ターンに 1 ショット。マルチショットのタイムラインは、ハイパーフレーム / インタラクティブビデオスキルに属し、ここではありません。
videoAspectを正確に一致させること — 再レンダリングは低速です。- ファイルを保存せずに動画を出荷しないこと — ユーザーはファイルビューアで再生できるものを期待しています。
- 基盤モデルが失敗した場合(NSFW フィルター、コンテンツポリシー、タイムアウト)、エラーをそのまま報告してください。黙ってリトライしないでください。
"$OD_NODE_BIN" "$OD_BIN" media generateをすでに呼び出していない限り、レンダリングが「送信された」「開始された」「実行中である」と主張しないでください。