Long video render(長時間ビデオレンダリング)
長時間ビデオワークフローのステージ9です。出力: ユーザーが承認するまではレビュー用レンダリング(低品質)、承認後は高品質の最終ビデオを1つ出力します。
シーンとは、スクリプトの1クリップを指し、以前のステージと同様にビデオ全体を通して番号順に並べられます。シーン番号はレビュービデオに焼き込まれるため、レビュアーはそれを指してコメントできます。
開始前に
~/.long-video/projects/<slug>/内のプロジェクトを探します。video-script.mdが必須で、status: approvedである必要があります。- プロジェクト設定を読み込みます: 解像度、アスペクト比、キャプションモード(
visuals.captions)、ラウドネス要件、プラットフォーム。 - ffmpeg と ffprobe を確認します(
ffmpeg -version)。バンドルレンダラーには libx264 と libass 対応の ffmpeg が必要です。 render/が既に存在する場合、次のいずれかを尋ねます: 続行する(バージョンを一覧表示)、または最初からやり直す。
ステップ1: インベントリ
各シーンを確認し、何が存在するかリストアップします:
| アイテム | 場所 | 用途 |
|---|---|---|
| ビデオクリップ | clips/scene-<NNN>_clip.*(または _take2 以降、ユーザーが承認した方) | シーンの映像 |
| 画像のみ | frames/scene-<NNN>_start.* | スクリプトに基づいたカメラ移動(プッシュイン、プルアウト、パン)付き静止画 |
| 音声 | audio/lines/scene-<NNN>_<speaker>_<NN>.* | ナレーションと対話 |
| サウンドステム | sound/mix/sfx_track.wav、amb_track.wav、music_track.wav | 効果音、アンビエンス、音楽 |
不足を簡潔な表で報告します。クリップも画像もないシーンはブロッカーです: これらのシーンをリストアップし、long-video-keyframes または long-video-clips に戻ることを提案します。音声やサウンドが欠けていても、ユーザーがそれらのステージをスキップすることを選択した場合のみ許可されます。スキップされたステージについては再度尋ねないでください。
クリップステージがスキップされた場合(clips_mode: images-only)、すべてのシーンはスクリプトのショットに基づいたカメラ移動付き静止画になります。
ステップ2: アセンブリツールの選択
- Claudeが操作できるビデオエディタが利用可能か確認します: このセッションに接続された編集用MCPサーバー、またはデバイス上のCLI(FilmCraft:
filmcraft-cli commands;EffectCraft:effectcraft-cli --help)。../long-video-sound/references/tools.mdのセクション5を参照してください。 - 利用可能な場合、次のどちらかを尋ねます: それを使用する(ユーザーはプロジェクトを開いて調整できます)、またはバンドルレンダラーを使用する。デフォルトはバンドルレンダラーです。ユーザーがエディタを選択した場合、まずコマンドリストとドキュメントを読み、コピーで作業し、インストールやビルドの前に許可を求め、同じファイル名を維持します。
- どのツールを使用するかを伝えます。
このスキルの残りの部分はバンドルレンダラーについて説明します。エディタを使用する場合も、そのコマンドを使って同じ手順を実行し、レビュー版と最終版を同じフォルダとファイル名でエクスポートします。
ステップ3: 編集リストの構築
references/edl-format.md を読みます。プロジェクトファイルから render/edl.json を作成します:
- シーンごとに1エントリ: 継続時間(スクリプトから、または実際のクリップ長がシーン長より短い/長い場合は実際の長さ)、映像ソース、静止画のカメラ移動、トランジション(アウト)
- 音声配置: シーンの開始時間に短いオフセット(デフォルト0.3秒)を加えた位置に、行を順に、小さな間隔を空けて配置
- サウンドステム
- キャプション(設定でキャプションが必要な場合。各音声ファイルの継続時間から開始と終了を取得)
- 設定からの幅、高さ、fps。デフォルトfpsは24。デフォルトのラウドネス目標は-14 LUFS、トゥルーピークは-1.5 dBTP未満。
ルール:
- 承認されたスクリプトの正確なシーン継続時間を使用します。ストーリーを伸縮させて合わせようとしないでください。
- クリップがシーンより長い場合、末尾をトリミングします。クリップがシーンより短い場合、最後のフレームを保持します。両方を報告します。
- 音声ラインがシーン終了またはビデオ終了を超える場合、警告として報告します。
- トランジション: デフォルトは
cut。fade(黒へのディップ)はスクリプトで指定されている場合のみ。クロスディゾルブはエディターツールが必要です。 - レンダリング前に計画を確認します:
node <skill folder>/scripts/build-render.mjs render/edl.json review render/review --plan
簡単なサマリーを表示します: シーン数、目標に対する合計ランタイム、クリップ対静止画、警告。ストーリーを変えずに修正できる問題は修正します。修正できないものについてはユーザーに尋ねます。
ステップ4: レビュー版のレンダリング
レビュー品質: 低解像度(約360p)、高圧縮、左上隅にシーン番号とタイムコードを焼き込み、設定で焼き込みキャプションが指定されている場合はそれも含めます。
node <skill folder>/scripts/build-render.mjs render/edl.json review render/review --version 1
- 出力:
render/review/<slug>_review_v1.mp4、および継続時間、サイズ、ラウドネスを含む.report.json。 - シーンセグメントはキャッシュされます。以降のレビューは変更されたシーンのみを再レンダリングするため、大幅に高速です。
- 数分を超えるビデオの場合、コマンドをバックグラウンドで実行し、終了を待ちます。ポーリングはしません。
- キャプションモードが
srtの場合、ビデオの隣に.srtファイルが書き込まれます。
レポートを確認します: 実際の継続時間と計画の比較、ラウドネス、ストリーム。その後、完全なパスとサイズをユーザーに伝えます。
レビュー方法を伝えます: ファイルを視聴し、コーナーに表示されるシーン番号と時間を各コメントとともにメモします。Claudeはファイルを送信またはアップロードしません。ユーザーがクライアントと共有します。アップロードの準備を提案するのはユーザーが依頼した場合のみで、その前に許可を求めます。
ステップ5: 変更の収集
「変更はありますか?最終版であれば、そのようにおっしゃってください。高品質版をレンダリングします」と尋ねます。
ユーザーはクライアントのフィードバックを貼り付けることがあります。references/review-feedback.md を読みます。各コメントについて:
- それが参照するシーン番号または時間を見つけます。コメントがあいまいな場合、短い質問を1つします。
- 分類し、ルートを選択します:
- 編集レベル(トリミング、長さ、順序、キャプションテキスト、キャプションのオン/オフ、トランジション、音声/音楽/効果音のレベル):
edl.jsonまたはステムのゲインでここで修正します。 - シーンの映像(見た目、キャラクター、構図、動き): 該当シーンについて
long-video-keyframesまたはlong-video-clipsに戻ります。新しいファイルには_take2スタイルの名前を付けます。その後、編集リストを更新します。 - 音声ライン(伝え方、発音、言い回し): 該当ラインについて
long-video-voiceに戻ります。承認済みスクリプトへの言い回し変更はユーザーの承認とスクリプトの修正が必要です。 - サウンド(効果音、アンビエンス、音楽): 該当キューについて
long-video-soundに戻り、再度ミックスします。 - ストーリーまたは構造(シーンの追加/削除):
long-video-directorに戻り、影響を受けるシーンの下流工程のみやり直します。
- 編集レベル(トリミング、長さ、順序、キャプションテキスト、キャプションのオン/オフ、トランジション、音声/音楽/効果音のレベル):
- リストを
render/review-log.mdに、バージョン、シーン、リクエスト、ルート、ステータスとともに書き込みます。 - 短い表で計画をユーザーに示します。クレジットや時間を消費する再生成の前に、はい/いいえを尋ねます。
- 変更を適用し、次のレビューをレンダリングします(
--version 2、以降同様)。古いレビューファイルはすべて保持します。 - 何が変わったかをシーンごとに、新しいファイルパスとともにユーザーに伝えます。
ユーザーが承認するまで繰り返します。沈黙や「今のところ良さそう」は承認ではありません。
ステップ6: 最終ビデオのレンダリング
ユーザーが特定のレビューバージョンを最終版と明示的に言った場合のみ行います。
- 確認: 「レビュー v から最終版をレンダリングしますか?」編集リストがそのバージョンと一致し、レビューログに未解決の変更リクエストがないことを確認します。
- 最終品質: 設定の解像度、高品質 H.264(crf 18、slow プリセット)、AAC 192kbps、目標への2パスラウドネス正規化、レビューラベルなし。キャプションは設定で焼き込みが指定されている場合のみ焼き込みます。それ以外の場合は
.srtファイルが書き込まれます。 - 実行します(長時間ビデオではバックグラウンド):
node <skill folder>/scripts/build-render.mjs render/edl.json final render/final
- レポートと
ffprobeで確認します: 継続時間が計画と一致、解像度とfpsが正しい、ビデオとオーディオのストリームが1つずつある、ラウドネスが目標に近い(約1 LU以内)、トゥルーピークが -1 dBFS 未満。 - オプションで、予期しない黒フレームや長い無音を確認します:
ffmpeg -i FILE -vf blackdetect=d=0.5 -af silencedetect=noise=-50dB:d=3 -f null -。結果を報告します。 project.jsonを更新します: `