マルチビデオバリアント は何をしますか?
承認済みマスター1つからN個の出力を生成します。どのファイルがどのソース状態から来たのか、制御を失うことなく管理します。バリアントマトリックス、マスターフリーズ、リレイアウトコピー、共有ミックス、命名規則、1度に1レンダリングのキュー、エージェント監視ルール、マニフェストゲートを担当します。マスターのデザイン(タイプスキルが担当)は行わず、ファイルごとのQA(render-qa-deliver)も置き換えません。
このファイルよりも優先されるルール
- マスターが先、その後フリーズ。 派生ファイルは、自身の完全なQAを通過し、
manifest_check.py freezeで記録されたマスターからのみ作成されます。後で修正が必要な場合は、マスターで修正し、changeで記録し、同じラウンドですべてのコピーに適用し、すべての派生ファイルを再レンダリングして再記録します。コピーのみを修正することは禁止されています。 - リレイアウト、クロップは禁止。 各アスペクトはマスターソースのコピー(
hf_9x16/、hf_1x1/...)であり、独自のキャンバス、安全ゾーン、タイプスケール、キャプションレール、カメラキー、フェイスセンタリングを持ちます。レンダリング済みマスターをFFmpegでクロップまたはスケールすることはバリアントではありません。 - 1つのミックス。 リレイアウトとフックバリアントは、同じ
cues.jsとassets/mix.wavのバイトを使用し、その1つのファイルからマックスされます。バリアントごとにオーディオが再構築されることはありません。独自のミックス(ノーミュージック、独自ボイスオーバー、再カット長)が本当に必要なバリアントは、マニフェストで理由を宣言します。 - マシン全体で1度に1つの重いジョブ(レンダリング、
check、マット、ASR、Blender)をrender_lockの下で実行します。並行作業は、非重いタスク(レイアウト、仕様、QA読み取り)に制限されます。最大4エージェントの並列、各エージェントは最大2サブエージェント。 - 「準備完了」は計算され、主張されません。 この単語は、
manifest_check.py checkが0で終了した場合にのみ許可されます。タイムアウト、空のフォルダ、欠落したハッシュ、qa: not_runまたは欠落した証拠はblocked/INSUFFICIENT_EVIDENCEであり、passではありません。 - 有料アクションは
paid-generation-gateなしでは行わないでください。別のClaudeセッションにメッセージを送信しないでください。ユーザーとプロジェクトの制限がこの手順を上書きします。安全ゾーン、-14 LUFS、キャンバスはハウスプリセットv1(決定デフォルトQ5)であり、プラットフォームの法則ではありません。
入力 -> 出力
入力:承認済みマスター(hf/、PROMPT.md、DESIGN.md、cues.js、assets/mix.wav)とインテークからのバリアントマトリックス。出力:final/<name>_<platform>_<hook>_<aspect>.mp4 x N、final/manifest.json(最終ファイル+マニフェストのみ)、ファイルごとのQAレポート(_work/qa/<aspect>/<round>/の下)、_work/agents/<agent>.progress.md、_work/STATE.md(キュー)。
命名:<name>_<platform>_<hook>_<aspect>.mp4、<name>は小文字のASCIIスラッグ(アンダースコア許可)、<platform> = meta|tiktok|yt|ig|linkedin|x|all、<hook> = master | hookA | hookA-nomusic | hookA-nocaps、<aspect> = 9x16|4x5|1x1|16x9。また、ショート形式<name>_<aspect>.mp4(プラットフォームall、フックmaster)も受け入れます(配信プレイブックと同様)。ユーザーが元帳で指定した名前は規則を上書きし、元帳IDとともに記録されます(record --name-ledger-id)。
手順
| # | ステージ | 実行内容 | 成果物 |
|---|---|---|---|
| 0 | インテーク時のマトリックス | ファイルごとに1元帳行:アスペクト、プラットフォーム、ルート(オーガニック/広告/スパーク)、フック、バージョン(フル、ノーミュージック、ノーキャプション、長さ)、マスターアスペクト。後発の「可能性のある」アスペクト比:レイアウトノートを今書いておき、後でリクエストがあっても1エージェントで対応でき、再構築を防ぐ(references/variant-matrix-and-layout.md) | PROMPT.md <inputs> 内のマトリックス、マニフェスト内のmatrixリスト |
| 1 | マスターゲート | マスター承認済み、render-qa-deliverの全フレームQA通過、manifest_check.py freeze <project> --hf hf --matrix ... | フリーズされたsrc_hash + mix_sha256 |
| 2 | リレイアウトコピー | アスペクトごとに1エージェントがコピー上で作業。同じキューとミックス。レイアウトテーブルを埋める(要素ごとの変更点、references/variant-matrix-and-layout.md)。プリフライトエラー0。フック、オファー、エンドカードのスナップショットオーバーレイ(--describe false、呼び出しごとに最大5タイムスタンプ) | hf_<aspect>/、_work/qa/<aspect>/layout.md |
| 3 | フック/バージョンバリアント | フック = アスペクトのコピー内の変数にバインドされたサブコンポジション、バリアントごとに1行。最初に1つのバリエーションをテスト(バッチ変数はプロジェクトで未テスト)。共有ミックスをマックス。ノーミュージック/ノーキャプション = 宣言されたミックスまたはレイヤーバリアント | rows.json、バリアントファイル |
| 4 | キュー | _work/STATE.mdにレンダリング順序を書き込む(マスター、次に各アスペクト、次にバリアント)。各レンダリングの前にmanifest_check.py stamp。レンダリングはhf_deliver / render_lock runを通じて1度に1つ。レンダリング所有者は2つ目の重いジョブを開始しない | ロックログ、スタンプ |
| 5 | 記録 | 各レンダリング後:record(ハッシュ、適用されたマスター修正、ミックスバリアント、QA状態、最終ファイルで測定されたラウドネス) | manifest.json |
| 6 | 出力ごとのQA | frame_qa、caption_qa --band <top>:1450(9:16)、motion_qa(レイアウトがモーションを変更した場合)、face_center audit(スピーカーフッテージ用)、qa delivery。ビジュアルレビュー軸1(コンポジション/クロップ)と4(可読性)のみ。軸2-3はモーションが変更されない限り継承 | レポート + 証拠パス |
| 7 | 準備完了ゲート | manifest_check.py check <project> --jsonが0で終了。ソースハッシュ、QA状態、LUFS/TPとともにファイルリストをユーザーに表示。ギャップを正直にリスト | READYレポート |
| 8 | 学習 | ファイルごとのタイミング元帳行、受信トレイへの教訓 | _work/timing_ledger.jsonl |
ゲート
状態は、理由とともにpass | fail | blocked | n/aです。タイムアウト、空のサンプル、または入力欠落はblockedであり、passではありません。成功したツール呼び出しは実行証拠です。表示されたレンダリングは外観証拠です。
| ゲート | 前提条件 | 証拠 | 偽の場合 | 所有者 | 再チェック時期 |
|---|---|---|---|---|---|
| G1 マトリックス | すべての出力に、構築前に元帳行(アスペクト、プラットフォーム、ルート、フック、バージョン)がある | PROMPT.mdとマニフェスト内のmatrix | 不足している軸を今すぐ尋ねる。構築しない | このスキル + video-intake | 新しいアスペクト比/バリアントリクエスト時 |
| G2 マスター凍結 | マスターが完全なQAを通過。freezeが記録済み。派生ファイルがそれより早く開始されていない | マニフェストのmaster.src_hash、frozen_utcがすべてのスタンプより古い | 派生ファイルを停止。フリーズ | このスキル | マスターソースの変更時 |
| G3 リレイアウト | 各派生ファイルが独自のルートキャンバス、要素ごとのレイアウト行、そのアスペクトの安全ゾーンを持つ。クロップされたマスターレンダリングがない | layout.md行 + オーバーレイスナップショット + プリフライト0エラー | 失敗している要素をリレイアウト。フレーム全体をスケールしない | アスペクトのエージェント | マスターレイアウトの変更、新しいコピー時 |
| G4 共有アセット | cues.*とassets/mix.wavがすべてのリレイアウト/フックコピーでマスターと同一。フックバリアントはマックス、リミックスしない | manifest_check.py check:M035/M041なし | マスターのキュー/ミックスをコピーして戻す。再レンダリング | このスキル | マスターキューまたはミックスの変更時 |
| G5 出力ごとのQA | 各ファイルがqa: passで証拠ファイルとLUFS -14 +/- 0.5、TP <= -1(最終ファイルに対して)を持つ(ハウスゲート) | マニフェスト内のqa_evidenceパス、lufs、tp数値 | そのファイルのみ修正して再レンダリング | render-qa-deliver | 再レンダリング時 |
| G6 重いジョブの規律 | 一度に正確に1つの重いジョブ。<= 4エージェント、各<= 2サブエージェント、各エージェントはファイルリスト、出力ファイル、期限、進捗ファイルを持つ | render_lockログ、_work/agents/*.progress.mdのmtime | キューに入れる、余分なジョブを停止(自身のプロセスのみ) | このスキル | 各エージェント起動時 |
| G7 マニフェスト準備完了 | 古い / 孤立 / 欠落 / レンダリング後に変更されたものすべてが存在しない | manifest_check.py check終了コード0 | 失敗しているファイルをユーザーにリスト。古いものを再レンダリング | manifest_check.py | 「準備完了」と言う前、変更後 |
数値(ハウスプリセットv1、日付2026-10-02、詳細はreferences/house-presets.md)
- キャンバス:9:16 1080x1920、4:5 1080x1350、1:1 1080x1080、16:9 1920x1080。H.264 SDR yuv420p、AAC 48 kHz、30 fpsデフォルト。
- 安全ゾーン、キーテキスト/CTA/ロゴ/価格:9:16 上300 / 下672(y <= 1248)/ 左140 / 右192、キャプションレール下 <= y 1450。16:9 x <= 1824、上54、下162。4:5と1:1は各側54 px。デバイスで未確認:オーバーレイ演習を実行。
- ラウドネス:-14 LUFS統合 +/- 0.5、トゥルーピーク <= -1 dBTP、最終ファイルで測定。ミックス中間TP <= -1.5。
- 監視:約15分ごとにハートビートチェック。20分間沈黙または期限超過 = チェック、交換または停止。沈黙が約10分続いたらユーザーにステータス行。レンダリングタイムアウト = 測定ETAの3倍。(出典:distilled 02ワークフロー§13.6、2026-10-01)
決定ルール
| もし | ならば |
|---|---|
| 派生ファイルが存在した後にマスター修正が必要 | マスターを修正、change、パッチをすべてのコピーに適用、すべてを再レンダリングして再記録 |
| コピーに異なるタイミングやキューが必要 | それはマスター変更。または、独自の元帳行を持つ新しい編集(recut)。静かなフォークは禁止 |
| フックに異なる話し言葉が必要 | 理由とともにown-voを宣言。他のすべてのバリアントは共有ミックスを維持 |
| アスペクト比が後でリクエストされた | レイアウトテーブルを書き込み、凍結されたマスターのコピー上で1エージェントを起動。マスターに触れない |
| 2つのレンダリングが同時にリクエストされた | キューに入れる。ロックが決定。STATE.mdに順序を書き込む |
| エージェントが期限を過ぎて沈黙 | 進捗ファイルを確認し、その後交換または停止(自身のプロセスのみ)、その後render_lock status |
| finalsフォルダに古いレンダリングがある | _work/delivered/v<N>/に移動。「準備完了」はフォルダがマニフェストと一致するまでブロックされる |
| ユーザーがファイルに名前を付ける | ユーザーの名前が優先。--name-ledger-idで記録し、platform/hook/aspectフィールドは明示的に維持 |
ブロック状態(報告し、回避しない)
manifest_check.py BLOCKED または INSUFFICIENT_EVIDENCE。from_masterが古い、またはマスター修正が欠落している派生ファイル。レンダリング後に変更されたソース。共有キューまたはミックスのずれ。qaがpassでない。約束されたバリアントが欠落。計画外のファイルが存在。どのファイル、どのコード、修正方法を伝える。
それぞれ実際の時間を浪費する落とし穴
配信時の後発16:9リクエスト(完全なリレイアウト、ドロップ)。3.7秒のマスター修正が1:1に適用されなかった。古いレンダリングが新しいものの横に残され、誰もフラグを立てなかった。派生エージェントがマスターバグを見つけて自分のコピーのみを修正した。3つのエージェントが同時にレンダリング(並行Blenderジョブがレンダリングを2倍にし、11.5分が21.5分に、所有者のラップトップ)。MetaとTikTokのカット間での命名衝突。1つのフックバリアントが静かに異なるミックスを運んだ。各アスペクトの表示されたコンタクトシートは依然として必要:ハッシュは顔にかぶったキャプションを見ることができない。
参照(必要なときに読み込む)
references/variant-matrix-and-layout.md- マトリックスの書き方、アスペクトのリレイアウト、フック/ノーミュージック/ノーキャプション/長さバリアント。references/manifest-schema.md- ファイルの記録、manifest_check.pyの結果の読み取り、古い派生ファイルのライフサイクル。references/parallel-and-agents.md- エージェントの起動、キュー、ロック、ハートビート、停止、トークンバジェット。references/house-presets.md- キャンバス、安全ゾーン、ラウドネス、プラットフォーム番号を引用する前に(日付付きモジュール)。agent-content/references/platform-specs.md(正規のプラットフォーム事実、他で所有)およびagent-content/playbooks/wf-08-deliver.md(配信プレイブック:命名、マニフェストルール) - エクスポートプリセットとプレイブック。数値が異なる場合、正規ファイルが優先され、references/house-presets.mdが更新される。- 他のスキル:
render-qa-deliver(ファイルごとのQA)、hebrew-captions-asr(キャプションレール)、edit-ad-promo(フックランキング)、revision-round(アスペクト間のノート)、paid-generation-gate。 - スクリプト:
scripts/manifest_check.py(--self-check29ケース、終了コード0 READY / 1 BLOCKED / 2 INSUFFICIENT_EVIDENCE)およびscripts/test_manifest_check.py(単体テスト)。