音声付きキネティックショートの作成
すべてのレンダリングは、このファイルの隣にある pipeline/ のバンドルパイプラインで行われます
(スキルロード時に表示される「このスキルのベースディレクトリ」)。
0. セットアップ(プロジェクトごとに1回)
プロジェクトに video_gen/ フォルダがなく、その中に kinetic_build.py がない場合は作成します。
mkdir -p video_gen && cp <skill dir>/pipeline/* video_gen/
cd video_gen
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt # 描画(Python 3.11+)
python3.12 -m venv .venv-tts && .venv-tts/bin/pip install -r requirements-tts.txt # Kokoro音声
ffmpeg がPATHに含まれている必要があります。voice.py は隣の .venv-tts 内でTTSワーカーを実行します。
すべてのコマンドは video_gen/ から実行します。
1. ルールを読む
DESIGN.md- キネティックなビジュアルスタイル。厳格なルール:ボックスは1列の全幅で積み上げ、横並び禁止;ボックスエッジにアクセントバーなし;大きなテキスト;各要素は読み上げられる単語に合わせて表示;見出しは1行(約30文字)に収める;焼き込み字幕禁止。PARTS.md-part.mdのフォーマット、ナレーションのルール、ガイドの分割方法。 デバッグ時を除き、engine_short.py、templates.py、skin.pyは読まない。
2. 新シリーズ:最初に分割し、承認を得る
- ソースガイドを分析し、パート案を提案(各パート1コンセプト、約90~125秒)。ユーザーの承認を待つ。 長さを合わせるために内容を削らない;代わりに例や「なぜ」を追加する。
- 各
<series>/pNN_<slug>/part.mdと、分析とパート表を含む<series>/README.mdを作成する。 - シリーズフォルダを
build_part.pyのSERIESに追加(キッカー+フッター)。必要に応じて、kinetic.pyのMARKSにロゴマークを追加する。 - ナレーションをリントする:
.venv/bin/python build_part.py <part dir> --lintで全ての問題を修正する。 ナレーション:要約や歓迎の言葉は不要、トピックにすぐ入る;記号やコードは使わない;音声用に頭文字を読み上げる;最大45語。
3. シーン
各パートには SCENES を定義する scenes.py が必要です。2つのスタイルがあります(examples/ 参照):
- 宣言型ステージブロック(推奨、高速):
SCENES = K.part(word, tag, chips, [[blocks...], ...])Track, Pipe, Rows, Code, Lanes, Bars, Ring, Fan, Chips, Big, Noteを使用。キューは単語の接頭辞(ブロックの前のキューの後で検索)、(word, beat)またはビート番号。例:examples/p03_*。 - ブロックで表現できないメタファーのための手書き
Sceneクラス。例:examples/p01_*。 キューとなる単語は読み上げ順にリストする。そうしないと MISSING キューが発生する。
4. チェックしてからレンダリング
.venv/bin/python kinetic_build.py <part dir> --stills /tmp/pNN.png # コンタクトシート+キューレポート
.venv/bin/python kinetic_build.py <part dir> --out <series>/output # 最終 <slug>_voiced.mp4
.venv/bin/python cue_scan.py <series>/p*_* # テキストのみの同期チェック
最終レンダリングの前に、すべての MISSING キューと overflow を修正する。シリーズ全体の場合は、最初の2パートをレンダリングしてユーザーのOKをもらい、残りをバックグラウンドで3つずつ実行する(xargs -P 3)。
5. レポート
表形式:MP4リンク、トピック、長さ、最長無音区間(目標1秒未満)。シリーズのREADMEにレンダリング済みのパートをマークする。チェックしなかった事項(フレーム未確認、音声未聴取など)を明確に記載する。
禁止事項
- ボックスの横並び、エッジアクセントバー、小さなテキスト、焼き込み字幕の追加。
- ビデオごとの音声キャリブレーションの提案;同期は単語単位で汎用的。
engine_short.pyの直接編集;build_part.pyがメモリ内でパッチを適用する。