RNA4219/video-storyboard-forge

動画コンテ Forge

原稿ページではなく、時間順のカットを制作単位にする。漫画のコマ割り・メクリ・フキダシを映像の時間や演出に流用しない。

作業手順

1. ユーザー指定の脚本、尺、画面比、用途、素材を確認する。未指定なら仮に24fps・16:9・30秒とし、仮定を明記して進める。既存の楽曲や脚本の尺があればそちらを優先する。特定の過去作品やキャラを勝手に持ち込まない。
2. references/format.md と assets/sample.storyboard.yaml を読み、作品ごとのYAMLを作成する。歌詞を与えられても実音源なしに歌唱タイミングを測定済みと扱わない。
3. duration_frames を配分し、合計を target_frames に一致させる。IDは C001 のような安定識別子にし、並べ替え時に改名しない。開始・終了時刻は手入力せずスクリプトに計算させる。
4. python scripts/storyboard.py validate PROJECT.yaml でデータを確認する。build で仮のコンテ表とカット別画像生成指示を出し、構成と尺を確認する。
5. 絵が必要なら利用可能な画像生成ツール／画像生成スキルを使う。prompts/C001.txt 等の指示と指定のキャラ・背景リファレンスを渡す。1画像1カット、文字・セリフ・表の罫線を画像に焼き込まない。連続動作を説明する必要があればカット内のキーポーズを文章で示し、必要に応じ別カットに分ける。
6. 生成画像を実際に開き、画角、人物、動作、視線、画面方向、連続性を検品する。画像の取得は実際のツール出力を使い、生成フォルダの「最新順」でカットを推定しない。各カットの image にYAML基準の相対パスまたは絶対パスを設定する。生成機能が使えない場合もコンテ表・指示・タイムラインを完成させ、未作画と明示する。
7. build --require-images を実行し、絵と演出・音声指示を別欄にしたコンテ表を完成させる。ブラウザ等で表示と印刷改ページを確認する。必要なら animatic でMP4を作成し、ffprobeと再生で尺・並びを確認する。
8. YAML、HTML、CSV、timeline.json、カット画像を納品する。ユーザーの保存先指定に従い、Work環境ではLibraryの保存手順を使う。必要なファイルを保存した後にリンクを返す。合計尺・未作画カット・未検品箇所・実音声の有無を簡潔に報告する。

実行例

スクリプトはスキルのルートを基準に指定する。Python 3.10以降とPyYAMLが必要。未導入なら python -m pip install -r scripts/requirements.txt を使う。日本語の表示・PDF印刷には実行環境の日本語フォントが必要。

python scripts/storyboard.py validate assets/sample.storyboard.yaml
python scripts/storyboard.py build assets/sample.storyboard.yaml --out /absolute/path/board-v1
python scripts/storyboard.py build PROJECT.yaml --out /absolute/path/board-v2 --require-images
python scripts/storyboard.py animatic PROJECT.yaml --out /absolute/path/animatic.mp4

build は既存フォルダが空でなければ停止する。改訂時は別フォルダへ出力する。animatic はffmpeg必須、全カットの実画像必須。出力MP4が既存なら停止する。外部APIやCLIには自動送信しない。プロンプトとデータを出す工程と、画像生成ツールによる作画を分ける。

演出設計

• 1カットに1つの主目的を持たせる。状況提示、動作、リアクション、見せ場を区別する。
• camera.framing にサイズ、angle に俯瞰・アイレベル等、movement にFIX・PAN・DOLLY等を指定する。人物の移動とカメラの移動を混同しない。
• セリフは dialogue、曲・効果音は sound、画面内の文字は on_screen_text に分ける。無音も明記する。
• カット内の演出タイミングは cues の開始から終了までの相対フレーム [start_frame,end_frame) で指定する。画像は静止画なので、カメラの動き・ダンス・口パクの成立を画像だけで検証済みとしない。
• MVはセクション・拍・歌詞との対応を notes と cues に残す。BPMから拍位置を求めても音源の頭出しやテンポ変動は別途確認する。
• 長いセリフが尺に収まるか読み上げで確認し、イマジナリーライン、目線、背景・衣装、小物の持ち手の継続を確認する。
• トランジションは現在版ではハードカットのみ。フェード等は notes で制作指示として残す。アニマティックは静止画切替・無音の確認用であり、完成映像ではない。

部分修正

対象IDのYAMLと画像だけを変更し、新しい出力フォルダへ再buildする。尺変更後は全体の合計を再検証する。確定済みカットの画像を一括再生成しない。

由来

sa-san10/rimochan-nyamuru-manga-forge の「構造化設計→画像生成→明示回収→検品」の流れを動画用に再設計した派生版。参照元commitは e1f002cd1073ea01fe17965ea0a8b32f6b6e70e3。漫画用OMNY/OMAYとの直接互換はない。コードとプロンプトは動画向けに新規実装。元のライセンスをLICENSEに保持する。サンプルは独自の人物・情景を使い、元キャラの画像は同梱しない。