フィルム構築
開始
sh ~/.claude/skills/film-build/kit/init.sh marketing/videos/<film> # 空でないフォルダは拒否
cd marketing/videos/<film> && npm i && npx playwright install chromium # NEXT と表示された場合
キットが提供するもの:
| ファイル | 説明 |
|---|---|
film/core.js | エンジン: scene({name, from, to, build, run, after}) (時間は拍 = 秒 × 2), put(el, {o, css}), reg(el, base), C.W/C.H/C.FMT, C.start() |
film/film.js | スターターファイル。以下のすべてのヘルパーと4つのショット例 (line, prompt, split, persona card) を含む。各ヘルパーのコメントには、それがどのリジェクションから生まれたかが書かれている。ショットを置き換え、ヘルパーは維持すること。 |
film/mock.js | window.MOCK: 実際のUI部品 (ダッシュボード、ウィンドウ、電話画面) のHTML (画面ピクセル単位) |
film/index.html | assets/fonts/{display,ui}.woff2 からフォントをロード (ローカルのサンセリフ代替フォールバック付き) |
scripts/render.mjs | --sheet, --at t1,t2, --draft, --range a,b, --verify, final, --mux, --fmt 9x16, --all |
scripts/sync.mjs | timeline.json をページにコピー |
scripts/review.py | レンダリングされたMP4からの批評キット: コンタクトシート、最速アクションストリップ、電話ビュー、9:16セーフゾーン、メトリクス |
tools/probe.mjs | cuts (すべてのカットと各ショットの中間点、動画秒単位) または任意の式、例: "window.UNWARP(12.4)" |
tools/sheet.py | 静止画をタイル状に並べ、ラベル付きの1枚のシートにする |
tools/pack_grid.py | 4×3のキャラクターシート (透明または白背景) を sprite() 用の12セルストリップにカット;セルサイズを出力 |
tools/cut_cast.py | 一列のラインアップを個々の静止画キャラクターにカット |
assets/characters/ | 4つのサンプルキャラクター (創業者、開発者、営業、学生)、360pxセルの12フレームストリップ |
tools/same.sh | 変更前後の静止画間のPSNR回帰テスト: save / check |
スターターファイルのヘルパー (使用すること、再発明しないこと)
io(クインティック インアウト) カメラ移動とモーフィング用;oq(クィントアウト) エントランス用;back小さなオーバーシュート用。cam(e, s, fx, fy)は、1920×1080平面のフォーカスポイント (fx, fy) を、スケール s でフレーム中央に配置する。camDは平面の端を超えて表示しない (カバースケール; 9:16 で必須)。posIn(e, root)は、移動する平面内での要素の位置を読み取る (カーソルターゲット、キャレット追従用)。typed()は、単語を1文字ずつ行に表示する;keyed()は実際のキーボード風: 文字ごとに不規則なタイミング、スペースでの長い休止、点滅するキャレットを表示。wordsHTML()は、すべての単語を最初のフレームから最終幅で配置し、タイミングが来るまで透明にすることで、行がリフローしないようにする (「テキストトランジションがまったくスムーズでない」問題対策)。cursor()/putCursor()/bump(): 実際の矢印カーソル: 滑らかに移動し、早めに到着し、クリック時に15%沈む。pop()小アイテムの着地用。sprite(parent, src, cellW, cellH, h)/putSprite(e, t, a, z, loops)描かれたキャラクター用: a→z の12フレームをステップ、小さな呼吸 (完全静止しない) を加える。<img>要素のため、エンジンは読み込みを待つ。shot(name, t0, t1, build, run)はsceneを秒単位でラップ。- ペーシングワープ (下部):
SLOW(全体のストレッチ),EVホールド (読むための瞬間停止) と挿入;window.CUTSとwindow.UNWARPは音声・ナレーション配置用の動画時間を提供。 PT/pk(a16, a9)1つのファイルでフォーマットごとの値を選択。
エンジンのルール (決定論)
フィルムは t の純粋関数です。どのフレームも、最初にレンダリングしたときも、他のフレームの後でレンダリングしたときも、同じように描画されなければなりません。
- 2D 変換のみ:
translate3d,will-change, CSS トランジション,Math.randomは使用不可 (代わりにインデックスのハッシュを使用)。 - 初期状態で非表示の要素:
reg(el, {o: 0})を使用し、インラインのopacity:0は禁止。 - レイアウトの計測は
after()またはbuild内で1回だけ;run内では行わない (前のフレームを読み取ってしまう)。 - 3Dビュー: 毎フレーム
insertBefore(v, firstChild)で再挿入し、キャッシュされたラスターが残らないようにする。 - 埋め込みCSSアニメーション (例: プロダクトウィジェットの内部アニメーション): 一時停止し、
animation-delay: calc(-1s * var(--t))を設定。 - 画像とフォント (
decode(),document.fonts.ready) の読み込みを最初のフレームの前に待つ。 - プロダクトCSSは一意のルートクラスの下にスコープ; フィルム内では一意のクラス名を使用 (
.wが一度リークした)。 classList.addを使用し、className =は禁止。node scripts/render.mjs --verifyは、レンダリングを送信する前に 12/12 と表示しなければなりません。
リアリズム: 画面を構築する前に references/realism.md を読むこと
簡略版: 実際のアプリは実際の密度で、実際のロゴはブランドの公式サイトから、実際のOSに存在するアプリのOSクローム、実際の壁紙、実際のランチャーグリッド上の実際のdpサイズの電話 (製品自身のレンダラーで描画)、予想以上にリッチな製品UI、ブランドマーク表示時の帰属表示行。
構築ループ (レビュー駆動)
- 承認されたストーリーボードからのショットリスト を
film.jsに、各shot()として、引き継ぎ用に重なりを持たせて記述。 - まず静止画。
node tools/probe.mjs cuts→ 各ショットの中間点と各引き継ぎ時点の静止画をレンダリング:node scripts/render.mjs --at …の後でpython3 tools/sheet.py review/stills/16x9 review/sheet.jpg <times>。自分でシートを確認。修正。繰り返し。(完全レンダリングの25分以上に対して、約1~2分/ラウンド) - レビュー提出前のQAパス: フィルムを≤ 1.5秒ステップおよびすべての引き継ぎ時点で再生 (各トランジション上の10~15fpsコンタクトシート)。
references/qa.mdを項目ごとにチェック: 重なり、クリッピング、空白フレーム、読み取り時間、テキストのスムーズさ、タイピング、ロゴ表示、OSリアリズム、電話サイズ。 - 静止画を送付 (シート) をオーナーに初回確認用。待つ。
- ドラフト:
node scripts/render.mjs --draft(30fps, 約4分),python3 scripts/review.py 1 --draft、ストリップを確認。ドラフトMP4を送付。30fpsのブラーなしドラフトであることを明確に伝える (最終版より粗く見える)。 - 「最終レンダリング」: バックグラウンドで
node scripts/render.mjs(60fps, モーションブラー; 60秒で約25~35分)。レンダリング中はfilm.jsを編集しないこと: 作業を続ける必要がある場合は、まずプロジェクトをコピーすること。 - 承認ラウンドごとに フィルムコードとタイムラインをコミット。
ペース
初回カットはほぼ常に速すぎる。画面上のテキストは、単語あたり約0.3秒 + 完全な不透明度で1秒 (最低1.5秒) 必要。すべてのショットのタイミングを変更するよりも、ワープ (SLOW 1.1~1.25, 行に対する EV ホールド) を優先。ペース変更後は、音声とナレーションの位置が変わるため、probe.mjs cuts を再実行すること。
9:16: references/formats.md を読むこと
同じフィルムを1つのファイルで pk() を使ってリフレーム; tools/same.sh で16:9が変更されていないことを証明 (すべての静止画PSNR = inf); --verify --fmt 9x16; オーナー用の静止画シート; その後、バックグラウンドで --fmt 9x16 最終版、次に --mux --fmt 9x16。