フィルムアカデミー
コードのように構築、測定、修正される映像作品を作る方法。映像をWebページとして書き、レンダラーがそれを撮影し、ミキサーがビートに合わせて音を乗せ、ゲートが前回より遅くなったり静止したりしたカットを拒否し、発注元が映像について述べたことはすべて一字一句保存され、カットが通過する前にすべて回答されなければなりません。
すべてのコマンドはこのスキルのフォルダから実行します(python film.py ...)。必要なもの:ffmpeg、Python 3.9+、pip install playwright && playwright install chromium。python film.py check で不足を確認できます。OCR(tesseract)はオプションです。
最初に:製品を説明し、2つのコマンドを実行
発注元が製品を説明し、映像を希望する場合:
- 発明できないものだけを収集する:名前、唯一の約束(1文)、実際に真実である2〜4の事実(証明行)、もしあれば実際の数字、唯一の依頼(URL)、製品がWebページかネイティブ/スマホアプリか(その場合は画面収録を依頼、以下参照)。決して主張や数字を発明しないでください:映像は与えられたものだけを表示します。1メッセージで質問してください。長さの指定がない場合、6〜15秒がソーシャルカット、30〜60秒がヒーロー映画です。
python film.py new "<名前>" --promise "<約束>" --points "ラベル=値|ラベル=値" [--number "40%" --number-label "..."] [--slam "前置きなし"] [--action "ワンタップ"] --url <URL> [--music track.mp3 --drop-bar N] [--recording rec.mov]を実行すると、films/<スラッグ>/film.jsonとページが作成されます。python film.py make films/<スラッグ>:レンダリング、サウンド、ゲート。毎回のmakeは番号付きビルド(v1、v2、...)で、1つ前のビルドと比較してゲート判定されます。--masterで1920x1080、60fps。- 確認する(
python film.py sheet <film.mp4> films/<スラッグ>/sheet.jpgを実行し、画像を読む。ビデオは再生できません)、発注元にmp4の場所を伝えます。 - 味覚は発注元のもの。 ラウンド1は無難で汎用的。発注元に視聴してもらい、問題点を言ってもらうように依頼します。すべての発言をそのターン内に一字一句保存し(
film.py note "<発言>" --source "誰、日付" --store films/<スラッグ>/film-notes.json)、film.jsonまたはfilm.htmlを変更し、各メモを新しいビルドに対してチェックし(film.py tick N1 --film <mp4> --where 0:04 --store ...)、再度makeを実行します。ゲートは、チェックされていないメモがあるビルド、および前回より遅いまたは静止状態が多いビルドを拒否します。 - 発注元に率直に伝える:ゲートは劣化や停滞したカットを検出しますが、好みを判断することはできません。また、作業にはClaudeトークンが消費されます(最初の映像は数万トークン、修正ラウンドごとに1〜3万トークン、カスタムシーンはさらに多くかかります)。そのため、1ラウンドで複数の修正を行い、多くの静止画を個別に読むのではなく、1枚のコンタクトシートを読んでください。
ネイティブアプリまたはスマホアプリ(Webページではない場合):短い画面収録(5〜10秒、1タスク、通知オフ、画面に個人情報なし)を1つ依頼し、python film.py import-recording rec.mov films/<スラッグ> --start 2 --seconds 6 を実行します。これにより、描画されたカードの代わりに、ウィンドウ内に表示されるフレームが生成されます。
film.json を超えてページを変更する前に playbook.md を読んでください(最初に構造と編集セクション、音楽を選ぶ前にサウンドセクション)。音楽:生成されるプレースホルダーがデフォルトです。リポジトリにトラックを絶対に含めないでください。発注元が提供するトラックは、映像を公開できるライセンスが必要です。
手動パイプライン(make が行う内容のステップバイステップ)
ループ
- 一度のパスで概要をまとめる。 種類(プロモ、説明、ソーシャルカット)、映像が果たす唯一の約束(1文)、長さ、どこで再生されるか、表示を許可されているもの(発注元が公開できる素材のみ、使用権を明確にできないデータは不可)。発注元から長さの指定がない場合、ヒーロー映画は30〜60秒、ソーシャルは15秒。映像の作り方を尋ねないでください。それはあなたの仕事です。
- ピクセルより先に参考資料を入手する。 同じ分野の映像を2本以上入手し(視聴し、私的学習のために保持できるものだけをダウンロード)、
python film.py measure ref1.mp4 ref2.mp4を実行します。それらの平均ショット長、静止シェア、カードあたりの単語数が基準となります。playbook.mdを読んでください:書き始める前に構造と編集グループ、ミキシングの前にサウンドグループを参照。決して参考資料をコピーせず、その数値と技術を取り入れてください。 - 映像を1つのHTMLページとして書く(
academy/template.htmlから開始。これはfilm.py newによってプロジェクトにコピーされます。また、window.timeline()とwindow.cards()を定義し、ゲートが実際のカットとカードテキストを認識できるようにします)。契約:window.seek(t)は時間tにおけるページをtの純粋関数として描画し(タイマーや自動再生CSSアニメーションは不可)、window.duration()は秒数を返し、window.cues()はフレームに属するサウンドの[{t, sfx, db}]を返し、window.readyはフォントと画像のPromise、window.MISSINGはロードに失敗したアセットをリストします(エントリがあるとレンダリングは失敗します)。シーンの開始は音楽の小節グリッドに合わせます(bar = beats_per_bar * 60 / bpm)。ペイオフから始め(フレーム0は画像)、1つの約束、後半にキーモーメント、早い段階でブランド、エンドカードでもう一度ブランドを表示します。 - レンダリング前に確認する。 モデルはビデオを再生できません:
python film.py stills film.html out/stills 0,2.5,5を実行してPNGを読みます。レンダリング後はpython film.py sheet film.mp4 sheet.jpgで1秒あたり1フレームを1枚の画像にまとめます。見えた問題を修正します。 - レンダリング。
python film.py render film.html out/film.mp4 --fps 30 --size 1280x720 --workers 2(マスターには--fps 60 --size 1920x1080を使用)。N個のChromiumワーカーがそれぞれスライスを撮影します。ワーカーのクラッシュやアセットの欠落はレンダリング全体を失敗させ、短い映像にはなりません。ページのキューはout/film.cues.jsonに書き出されます。 - サウンド。
python film.py mix out/film.mp4 out/final.mp4 --plan plan.json --music track.mp3 --sfx sfx_dir --cues out/film.cues.json。プランは音楽セグメントを小節単位でリストし(track_bar->film_bar、bars)、すべてのジャンプがダウンビートに乗るようにします。最後のコードはエンドカードの下で響きます。ラウドネスは-14 LUFS、トゥルーピーク-1 dBTP(2パスloudnorm)に調整され、その後測定されます。音楽:公開できるライセンス付きのものを自身で用意してください(リポジトリにトラックを絶対に含めないでください)。効果音は<name>.wav。デフォルトでは音声はありません。フラットな合成音声はないよりはましです。 - 長い映像はパートに分ける。 各パートに独自のページとレンダリングを割り当て、複数の人やエージェントが並行して作業できるようにし、その後
python film.py join p1.mp4 p2.mp4 p3.mp4 --out film.mp4 --dissolve 0.5で結合します(各パートの.cues.jsonは全体の映像のクロックに合わせられます)。その後、全体に対して一度ミックスします。 - ゲート。
python film.py gate --film out/final.mp4 --against previous.mp4 --refs ref1.mp4 ref2.mp4 --timeline times.json --bpm 120。カットが前回より遅い、静止状態が多い、または小さなショットの連続/すべてのビートでカットが発生している場合に停止します(終了コード5)。カードあたりの単語数とラウドネスについては警告します。ffmpegのシーンスコアはイーズされたトランジションをほとんど認識しないため、times.jsonに実際のカット時間を指定します({"final": [2.0, 4.0, ...]}、ファイルのステムをキーとする)。映像を修正し、レンダリングし、再度ゲートを実行します。前回のカットを上回れない映像は完成しません。 - メモはすべてのカットを拘束する。 発注元が映像について何か言った場合、そのターン内に一字一句保存します:
python film.py note "<発言の正確な文言>" --source "誰、日付" [--means "あなたの解釈"]。ゲートの前に、各メモを該当ファイルのどこで回答されたかと共にチェックします:python film.py tick N1 --film out/final.mp4 --where 0:04(タイムスタンプまたはshot 7)。film.py gateは、そのファイルのハッシュに対してメモがチェックされていない場合に拒否します(終了コード6)。再レンダリングや音楽の差し替えは新しいファイルとなり、新しいチェックが必要です。python film.py notes --film out/final.mp4で未処理のメモをリスト表示します。発言は決して編集されません。あなたの解釈は--meansに入れます。 - 完成した映像を納品する。 発注元は最終カット(フル解像度マスター、ポスター用スチル)を確認します。アニマティック、ストーリーボード、半完成版ではありません。ドラフトを希望する場合は発注元の判断であり、デフォルトではありません。
守られてきたルール
- 発注元の好みはあらゆるスコアに優先します:ゲートは劣化と停滞したカットを検出しますが、優れた映像を選ぶわけではありません。発注元が映像の良し悪しを述べた場合、それを次の作品のためにプレイブックに追加します。
- 測定で既にカバーされているパイプラインの部分を再構築しないでください:まず測定し(
film.py measure)、その後変更します。 - 修正はこのフォルダ(プレイブック、ページテンプレート、プラン)に入れ、セッション後に失われるプロンプトには入れないでください。
- 参考映像、クリップ、ライセンス付きトラックはリポジトリに含めないでください:数値のみ。
ファイル
| ファイル | 内容 |
|---|---|
film.py | コマンドライン:new、make、import-recording、check、render、stills、join、mix、measure、gate、sheet、note、tick、notes |
academy/project.py、academy/template.html | new/make:映像プロジェクト、設定駆動型ページ |
academy/render.py | フレームごとのChromiumレンダラー(並列スライス、ffmpeg) |
academy/mix.py | 小節線に合わせた音楽カット、キューに合わせたヒット、-14 LUFSへの2パスloudnorm |
academy/join.py | パートをディゾルブで結合、キューをマージ |
academy/gate.py | 測定とチェック |
academy/notes.py | 逐語的メモ、ファイルハッシュに紐づくチェック |
playbook.md | 43のソース付きテクニックとゲートの数値 |
data/ | 参考数値(18の公開映像)とカット技術の限界(205映像)、数値のみ |
example/ | 10秒のオリジナル映像(bash example/build.sh):new してから make を架空の製品に対して実行 |