ビデオDNA は何をしますか？
素材が入ったフォルダを、その場にいた人が編集したかのような動画に変換します。DNAを保ち、テンプレートは決して再利用しません。すべての動画は、実際に撮影された出来事から抽出された、独自のテーマを持ちます。
ユーザーの言語で応答してください。キャプションや画面テキストは、特に指示がない限り素材の言語を使用します。
開始方法
python scripts/doctor.pyを実行して、この環境で何ができるか確認します。不足しているものがあればreferences/environments.mdを読んでください（クラウドサンドボックス内の場合も同様です）。- 作業フォルダを確認し、
references/brief.mdを読んでブリーフを収集します。リクエストと素材で既に答えがわかっていることだけは質問しないでください。 references/formats.mdを読み、リクエストに最も近いレシピを使用します。素材がない場合は、references/brief.mdの「素材なし」セクションに従います。- タイムラインを構築する前に
references/pipeline.mdを読み、ジョブがコアスクリプト以上のものを必要とする場合はreferences/tools.mdを参照してください。
ワークフロー
以下の順序で実行します。ステップ5より前にレンダリングを行わないでください。
- ブリーフ フォーマット、向き、長さ、リズム、モーション強度、ビジュアルアイデンティティ、オーディオを確定します。
references/brief.mdを参照してください。その選択を動画全体で使用します。 - 素材一覧 クリップ、写真、音楽、ロゴがあればリストアップします。
scripts/contact_sheet.pyでコンタクトシートを作成し、確認します。scripts/transcribe.pyで音声を書き起こし（最も短く密度の高いクリップから実行）。実際のセリフが一番面白い素材であることが多いです。 - ストーリー 実際に何が起こったか、順序通りに、最も優れた実際のセリフとそれを誰が言ったかを書き出します。人物について教えられていない場合は、誰なのか尋ねてください。
- テーマ 2～3個の新しいテーマを提案し、それぞれに実際の出来事から構築された具体的なギャグを2つ含めます。1つを推奨し、素材が既に示唆しているテーマを優先します。ここで一旦止めて、ユーザーに選んでもらいます。
references/themes.mdを参照してください。 - 音楽 セクションごとに1曲、ターゲットファイル名とともに提案し、ユーザーにファイルをフォルダに配置してもらいます。
2_chorus_0m45s.mp3のような名前は「0:45から開始」を意味します。たとえ依頼されても、商用音楽をダウンロードしないでください。代わりに生成サウンドと音楽なしバージョンを提供してください。 - まずサンプル 約45秒を超えるものについては、ユーザーが方向性を判断できるように、1つの短いチャプターだけをレンダリングします。その後、残りを構築します。
- チェック
scripts/qa.pyを実行し、抽出されたフレームを確認してreferences/qa-checklist.mdに目を通します。納品前に見つけた問題を修正します。 - 納品 以下の「完成した動画の配置場所」を参照してください。必要に応じて音楽なしバージョン、
references/copy.mdからコピペ可能なテキスト、および正直なレポートを含めてください。
完成した動画の配置場所
scripts/doctor.py が環境を報告します。すべての動画を次のように仕上げます。
- Claude Code: 完成した動画はユーザーのフォルダに直接書き込みます。作業フォルダ内の
output/ディレクトリ（ユーザーが別の場所を指定しない限り）に配置します。フルパスを指定してください。ユーザーが_work/内を探し回る必要がないようにします。 - Claude アプリ: 完成した動画はチャット内に直接ファイルとして配信し、ユーザーが会話から開いてダウンロードできるようにします。出力先フォルダ（
/mnt/user-data/outputsが存在する場合はそこ）にコピーし、ファイル共有ツールが利用可能な場合はそれを使用します。サンドボックスパスで止めず、ファイルが配信に失敗しない限り、分割や圧縮は行わないでください。
DNA
- 1つのテーマ、完全にコミットする 最初のフレームから最後のフレームまで、同じフォント、色、アニメーション、サウンドを使用します。すべてのグラフィックは、そのテーマの世界に属します。
- すべてのグラフィックは、この素材からの真実のジョークまたは真実の事実を伝える 装飾的なものや汎用的なものは禁止です。実際のディスプレイに表示されている実際の値を読むラベルは、どんなストックキャプションよりも優れています。
- コールバック 早い段階で何かを仕込み、後半で回収します。冒頭のセリフが最後に再登場します。
- 最初の2～3秒でフック 最も強力な瞬間で始め、その後テーマに属する方法で冒頭に戻ります。
- リズム ビートに合わせてカットし、パンチラインでパンチズーム、動きのあるトランジションを使用し、衝撃でシェイク、退屈な部分はスピードアップ。話されているセリフはそのまま残します。
- キャプション すべてのスピーチに、ワードバイワードで、テーマに合わせたスタイルで表示します。画面上でのみ言葉を検閲します。
- サウンドデザイン 各グラフィックには独自のサウンドがあります。音楽はセクションごとに変化し、トラックのサビがキーモーメントに合致し、音楽はスピーチの下で音量が下がります。
- 密度より明瞭さ ジョークに視聴者が欠いている文脈が必要なら、カットします。初めて見る視聴者にとって、何が、どこで、いつ、どれだけなのかが明確でなければなりません。
真実のルール
- 事実を決して捏造しないこと。推定、近似、または例示的なものはすべて確認のためにリストアップする必要があります：日付、役割、数値、賞、身長、誰が何を言ったか。
- 不確かな書き起こしの行は、ユーザーが確認できるようにリストアップします。
transcribe.pyは低信頼度の単語にフラグを立てます。 - 実際の結果として読まれる可能性のある例示的な数値は、フラグを立てるか、削除する必要があります。
- 実際の人物の口に引用として言葉を入れないでください。キャプションとして読まれる場合は、書かれたジョークは問題ありません。
- 人々の気まずい瞬間を含める前、および見知らぬ人の顔をぼかさずに表示する前に尋ねてください。
- スポンサーや資金提供者からの公式テキストは一字一句そのままにします。ロゴと一致しない場合は、編集する代わりに尋ねてください。
- QRコードの送信先を確認し、それが公開編集可能なドキュメントである場合はユーザーに警告します。
修正の処理
フィードバックを正確に適用し、他のすべてはそのままにします。タイムラインはデータとして保持し、1つの変更が影響を受けるセグメントのみを再レンダリングするようにします。長さ制限を超えないように何かを削除する必要がある場合は、削除したものを言及します。
正直なレポート
あなたは音声を聞いたり、リアルタイムで視聴したりすることはできません。これを毎回、平易な言葉で述べてください：
- あなたが確認したもの（抽出フレーム、長さ、レベル、QRデコード）
- ユーザーが耳と目で判断しなければならないもの（ビート同期、キャプションタイミング、ミックスバランス）
- あなたが削除したもの、そして依頼された通りにできなかったもの
- 商用音楽が原因でプラットフォームが動画をミュートする可能性があるかどうか
バンドルファイル
| ファイル | 用途 |
|---|---|
scripts/doctor.py | ツールと依存関係の確認 |
scripts/contact_sheet.py | フッテージとレンダリングを確認するためのタイムスタンプ付きフレームグリッド |
scripts/transcribe.py | 低信頼度フラグ付きの単語レベルのトランスクリプト |
scripts/captions.py | タイムラインにマッピングされたワードバイワードのASSキャプション |
scripts/beats.py | テンポ、ビートタイム、トラックの最も強いヒット |
scripts/sfx.py | 著作権フリーの効果音を生成 |
scripts/music.py | ループするシンプルなオリジナルチップチューンまたはパルス音楽を生成 |
scripts/setup_tools.py | プロファイルごとにオプションツールを確認してインストールし、Whisperモデルを保存 |
scripts/toolbox.py | シーン検出、切り抜き、顔、QR、フォント、HTMLシーン、ステム、ボイスオーバー、ラウドネス、タイムラインエクスポート |
scripts/render.py | タイムラインJSONから最終MP4へ、オプションで音楽なしバージョン |
scripts/qa.py | 長さ、フォーマット、サイズ、ラウドネス、ASS、QRのチェック |
scripts/fit_size.py | ターゲットサイズに圧縮、または転送のために分割 |
references/brief.md | 開始時に尋ねる質問と、空のフォルダの場合の対処法 |
references/formats.md | 動画タイプごとのレシピ |
references/themes.md | テーマの見つけ方と実例 |
references/pipeline.md | タイムラインフォーマット、レンダリングルール、ASSアニメーションレシピ |
references/tools.md | 各ニーズに対応するツール（Whisperバックエンドを含む） |
references/environments.md | Claude CodeとClaudeアプリの違い |
references/qa-checklist.md | 納品前チェックリスト |
references/copy.md | 投稿後のキャプションと共有可能なメッセージ |