Communitygithub.com

film-academy

エージェントが「フィルムアカデミー」を使って、計画、構築、編集を行い、最終的にffmpegベースの映像作品を生成する方法を示します。手順は、製品の説明、2つのコマンドの実行、手動パイプライン(makeが行う内容のステップバイステップ)で構成されます。新しいタスクでこの技術が必要になった場合に使用します。

film-academy とは?

film-academyは、AIエージェント(Claude Code、Cursor、Codexなど)向けに設計されたスキルで、HTMLシーンからプロモーション映像、デモ、ブランドフィルム、ソーシャルカットを生成します。Chromiumでページをフレームごとに撮影し、ffmpegで結合、音楽は小節線に合わせて-14 LUFSに調整、さらに数値ゲート(ショット長、静止フレーム、カードあたりの単語数、カットの技術)と発注元のメモに基づいてカットの完成度を判断します。このスキルはPythonとPlaywrightを使用し、`python film.py new` と `python film.py make` の2つのコマンドでプロジェクトを開始・ビルドします。測定基準として既存の映像を比較し、ゲートが前回より劣化したカットを拒否するため、品質が保証されます。発注元のフィードバックは逐語的に記録され、すべての指摘に対応するまでカットは通過できません。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tincurik/film-academy/tree/HEAD

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

フィルムアカデミー

コードのように構築、測定、修正される映像作品を作る方法。映像をWebページとして書き、レンダラーがそれを撮影し、ミキサーがビートに合わせて音を乗せ、ゲートが前回より遅くなったり静止したりしたカットを拒否し、発注元が映像について述べたことはすべて一字一句保存され、カットが通過する前にすべて回答されなければなりません。

すべてのコマンドはこのスキルのフォルダから実行します(python film.py ...)。必要なもの:ffmpeg、Python 3.9+、pip install playwright && playwright install chromium。python film.py check で不足を確認できます。OCR(tesseract)はオプションです。

最初に:製品を説明し、2つのコマンドを実行

発注元が製品を説明し、映像を希望する場合:

  1. 発明できないものだけを収集する:名前、唯一の約束(1文)、実際に真実である2〜4の事実(証明行)、もしあれば実際の数字、唯一の依頼(URL)、製品がWebページかネイティブ/スマホアプリか(その場合は画面収録を依頼、以下参照)。決して主張や数字を発明しないでください:映像は与えられたものだけを表示します。1メッセージで質問してください。長さの指定がない場合、6〜15秒がソーシャルカット、30〜60秒がヒーロー映画です。
  2. 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 とページが作成されます。
  3. python film.py make films/<スラッグ>:レンダリング、サウンド、ゲート。毎回のmakeは番号付きビルド(v1、v2、...)で、1つ前のビルドと比較してゲート判定されます。--master で1920x1080、60fps。
  4. 確認する(python film.py sheet <film.mp4> films/<スラッグ>/sheet.jpg を実行し、画像を読む。ビデオは再生できません)、発注元にmp4の場所を伝えます。
  5. 味覚は発注元のもの。 ラウンド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 を実行します。ゲートは、チェックされていないメモがあるビルド、および前回より遅いまたは静止状態が多いビルドを拒否します。
  6. 発注元に率直に伝える:ゲートは劣化や停滞したカットを検出しますが、好みを判断することはできません。また、作業には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. 一度のパスで概要をまとめる。 種類(プロモ、説明、ソーシャルカット)、映像が果たす唯一の約束(1文)、長さ、どこで再生されるか、表示を許可されているもの(発注元が公開できる素材のみ、使用権を明確にできないデータは不可)。発注元から長さの指定がない場合、ヒーロー映画は30〜60秒、ソーシャルは15秒。映像の作り方を尋ねないでください。それはあなたの仕事です。
  2. ピクセルより先に参考資料を入手する。 同じ分野の映像を2本以上入手し(視聴し、私的学習のために保持できるものだけをダウンロード)、python film.py measure ref1.mp4 ref2.mp4 を実行します。それらの平均ショット長、静止シェア、カードあたりの単語数が基準となります。playbook.md を読んでください:書き始める前に構造と編集グループ、ミキシングの前にサウンドグループを参照。決して参考資料をコピーせず、その数値と技術を取り入れてください。
  3. 映像を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つの約束、後半にキーモーメント、早い段階でブランド、エンドカードでもう一度ブランドを表示します。
  4. レンダリング前に確認する。 モデルはビデオを再生できません:python film.py stills film.html out/stills 0,2.5,5 を実行してPNGを読みます。レンダリング後は python film.py sheet film.mp4 sheet.jpg で1秒あたり1フレームを1枚の画像にまとめます。見えた問題を修正します。
  5. レンダリング。 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 に書き出されます。
  6. サウンド。 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。デフォルトでは音声はありません。フラットな合成音声はないよりはましです。
  7. 長い映像はパートに分ける。 各パートに独自のページとレンダリングを割り当て、複数の人やエージェントが並行して作業できるようにし、その後 python film.py join p1.mp4 p2.mp4 p3.mp4 --out film.mp4 --dissolve 0.5 で結合します(各パートの .cues.json は全体の映像のクロックに合わせられます)。その後、全体に対して一度ミックスします。
  8. ゲート。 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, ...]}、ファイルのステムをキーとする)。映像を修正し、レンダリングし、再度ゲートを実行します。前回のカットを上回れない映像は完成しません。
  9. メモはすべてのカットを拘束する。 発注元が映像について何か言った場合、そのターン内に一字一句保存します: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 に入れます。
  10. 完成した映像を納品する。 発注元は最終カット(フル解像度マスター、ポスター用スチル)を確認します。アニマティック、ストーリーボード、半完成版ではありません。ドラフトを希望する場合は発注元の判断であり、デフォルトではありません。

守られてきたルール

  • 発注元の好みはあらゆるスコアに優先します:ゲートは劣化と停滞したカットを検出しますが、優れた映像を選ぶわけではありません。発注元が映像の良し悪しを述べた場合、それを次の作品のためにプレイブックに追加します。
  • 測定で既にカバーされているパイプラインの部分を再構築しないでください:まず測定し(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.htmlnew/make:映像プロジェクト、設定駆動型ページ
academy/render.pyフレームごとのChromiumレンダラー(並列スライス、ffmpeg)
academy/mix.py小節線に合わせた音楽カット、キューに合わせたヒット、-14 LUFSへの2パスloudnorm
academy/join.pyパートをディゾルブで結合、キューをマージ
academy/gate.py測定とチェック
academy/notes.py逐語的メモ、ファイルハッシュに紐づくチェック
playbook.md43のソース付きテクニックとゲートの数値
data/参考数値(18の公開映像)とカット技術の限界(205映像)、数値のみ
example/10秒のオリジナル映像(bash example/build.sh):new してから make を架空の製品に対して実行

関連スキル