リポジトリからのプロモーション動画生成
1人の視聴者が製品内で1つの実際のタスクを実行する様子を、コードからの実際のラベル、ナレーション、オリジナル楽曲とともに映した30〜45秒の動画です。このスキルは、コードから正しい製品情報を取得し、ストーリー、音声、音楽、そして再描画された画面をカバーします。レンダリングエンジンは指定しません。ユーザーと相談の上選択してください(無料ツールを推奨)。
1. 正しいコードを読む
- 何かを読む前に、
git fetch --allを実行し、各ブランチを比較します(各ブランチに対してgit log -1 origin/<b>)。デフォルトブランチは古くなっている可能性があります。mainが初期コミットのまま、製品がリネームされてdevで再構築されている可能性があります。間違ったブランチでストーリーラインを構築すると、丸々1ラウンド無駄になります。ユーザーが名前や機能が変更されたと言った場合は、それを信じてそのブランチを見つけてください(git grep -c <新しい名前> origin/<b>)。 - 印象ではなく事実を収集します:ナビゲーション(製品自体の機能マップ)、メインタスクフローのページコンポーネント、バックエンドシードデータ内のカタログ名、実際の制限や数値(最大長、「推定秒数 = 文字数 ÷ 4.5」のような計算式)。動画内のすべての主張は、これらのいずれかに遡れる必要があります。
- リポジトリからロゴとサムネイル/アイコンを
assets/にコピーします。ロゴに古いブランドテキストが含まれていないことを確認します。
2. ストーリーラインを作成し、そこで止まる
3つのストーリーラインを STORYLINES.md に書き(それぞれ:1行の前提、時間付きビートリスト、各継ぎ目を繋ぐトランジション)、ユーザーが選択するのを待ちます。複数ステップの製品で最も効果的だったストーリーライン:1つのオブジェクトが製品のステップを通過する(見つけた投稿 → トピックカード → スクリプト → 完成動画)、カーソルで掴むことで開始されます。あなたの推奨を最初に置きます。
前提を1行で述べます:長さ30〜40秒、1920×1080、音楽+効果、ナレーションあり/なし、画面上の製品データはデモデータ。
3. ナレーション(MiniMax)
要求された場合のみ。$MINIMAX_API_KEY または ~/.minimax_key の最初の行をキーとして使用します。決して表示しないでください。
- 各ビートにつき1行の短いスクリプトを
voice/script.jsonに作成します([{"id", "text"}])。1秒あたり約4.5文字、35〜40秒で約120〜140文字。行は原因と結果であり、スローガンではありません。画面にはキーワードを表示し、読み上げられる文をそのまま表示しないでください。 - ユーザーに行、音声ID、モデルを表示し、承認を得ます。各呼び出しは課金されます。
python3 -I scripts/tts_minimax.py voice --dry-runで文字数と推定時間を表示します。 - 一度生成します:
python3 -I scripts/tts_minimax.py voice [--voice ID]→vo-<id>.mp3とdurations.json。1行だけ再生成するには--only idを使用します。 - 音声が時計の役割を果たします:
durations.jsonからシーンを配置します(各行はシーンの開始から約0.15〜0.25秒後に始まり、シーンの長さは行+0.3〜0.6秒)。
4. 製品画面:コードから再描画
スクリーンショットのためにアプリを実行したりバックエンドをモックしたりせずに、コンポーネント、CSS、バックエンドデータからHTMLで画面を再構築します。最初の製品シーンの前に references/ui-redraw.md を読んでください。
デモデータには「演示データ · 虚构」とラベルを付けます。古い製品名やロゴを表示したり、コードに存在しないボタンを発明したりしないでください。
5. 音楽と効果音
scripts/score.pyは、バーのグリッドがクライマックスにダウンビートを置き、ロゴヒットがその後ちょうど整数の拍数になるように設計されたオリジナルトラックを合成します(numpy + scipyが必要):score.py assets/bgm/score.wav --total 38.5 --bpm 104 --hook-end 4.6 --reveal 9.8 --build 24.2 --payoff 27.0 --claim 31.6 --logo-beats 13--logo-beatsは、payoff + beats × 60/bpmがエンドカードのマークの位置と一致するように選択します。- 効果音は無料ソースから(クリック、ウィッシュ、ポップ、タイピング、ライザー、インパクト、スパークル)。目に見える原因ごとに1つの音。
6. 仕様とレビュー
- シーンの前に
SPEC.mdを書きます:GOAL、OUTPUT、TIME、VOICE、DATA、LOOK、OBJECTS、MOTION、SHOTS(時間付き)、BANNED、QAフレーム。 - すべてのビートと継ぎ目を確認します:動きの方向が反転する継ぎ目(右から出て行くオブジェクトは次のシーンでは右から入る)、着地前にフェードする要素、ヒーローフレームの空の半分を修正します。
REVIEW.mdを書きます:クリエイティブな判断、測定したものと目視のみで確認したもの、最も弱いショット。- 最終オーディオ:約 -16〜-14 LUFS、トゥルーピーク ≤ -1 dBTP、クリッピングなし。音は聞いたのではなく測定したと明記します。