AsLSX99/ai-video-workflow

AI 動画全ワークフロー（Codex ディレクター版）

このワークフローは、1 つの問題を解決します。最小限のコストと低い再生成率で、アイデアから自分が満足できる AI 動画を作成することです。この方法は Eian の実践記事（x.com/EianLu/article/2118317430665613741）に基づいています。このスキルでは、総合ディレクターを Claude から Codex に置き換えます。Codex だけを使って、ストーリーの執筆、プロンプトの作成、画像の描画、ポストプロダクションコードの記述をすべて Codex が一貫して行います。

中核原則：お金を使う前に間違いを防ぐ

コスト段階によって、すべての作業順序が決まります。

• プロンプトの数文字を変更：ほぼ無料
• 画像の再描画：追加費用なし
• 動画の再生成：秒単位で課金（2.5 約 ¥1.5/秒、2.0 mini 約 ¥0.5/秒、720p）

したがって：テキストで発見できるエラーは画像に持ち越さず、画像で発見できるエラーは動画に持ち越さない。 各ステップに独立したレビューチェックポイントを設定し、前のステップで「承認」された場合のみ次のステップに進みます。

役割分担

役割	担当
私（人間）	方向性の選択、アートスタイルの確認、予算の承認、動画の確認、音声の確認
Codex（総合ディレクター兼アーティスト）	ストーリーとストーリーボードの作成、すべてのプロンプトの作成、自身の画像生成ツールを使用したコンセプトアート/サンプルフレーム/開始・終了フレームの描画、各画像の抜き打ちチェック、ffmpeg/Python ポストプロダクションコードの記述
Seedance（アニメーター）	開始フレームと終了フレームを数秒の動画に変換
独立レビューセッション	各ステップごとに新しいセッションを開始し、材料のみを提供して結論は一切与えず、エラーのみを指摘してファイルは修正しない

独立レビューが低い再生成率の秘訣です。メインセッションはあなたと長く会話しており、あなたの意図を理解しているため、資料を自動的に補完して解釈します。新しいセッションは何も知らないため、どこが理解できないかが、どこが明確に説明できていないかを正確に示します。レビューセッションは現在のステップの材料のみを受け取り、結論は一切受け取らず、他のファイルも受け取りません。

環境チェック（作業開始時の最初のタスク）

python scripts/env_check.py を実行し、codex、ffmpeg、Python ≥3.9、環境変数 ARK_API_KEY を確認します。不足しているものがあれば、ユーザーにそれを補うように伝えます。

新しいプロジェクトフォルダを作成し、すべてのファイルをその中に配置します。推奨構造：

プロジェクトフォルダ/
├── 00-story/        # ストーリー、ストーリーボード
├── 01-style/        # アートスタイル、コンセプトアート
├── 02-frames/       # 各ショットの開始・終了フレーム
├── 03-prompts/      # 各動画クリップのプロンプト
├── 04-videos/       # 生成されたクリップ（旧バージョンはすべて保持）
├── 05-post/         # ポストプロダクション中間ファイル、最終出力
└── review-log.md    # 各ステップのレビュー結果とコスト記録

開始プロンプト

templates/00-director.md の全文を Codex に送信してプロジェクトを開始します。まず、動画の長さ、アスペクト比、総予算、BGM/字幕について質問し、その後環境をチェックします。その後は、Codex とのみコミュニケーションを取ります。

8 ステップワークフロー

各ステップには以下が記載されています：何をするか → 使用するテンプレート → 合格条件。

ステップ 1：アイデア → 完全なストーリー

• 最初のアイデアを Codex に伝え、一緒に話し合ってストーリーラインを確定します。ストーリー構造は、断片的なスタイル（ショット間のつなぎが不要で、最も安定）を最優先し、連続的なスタイルは最も破綻しやすいです。
• 優れたストーリーの 5 つの基準：①現実的な論理に従っている（すべての転換点で問いかける：なぜそうなるのか？ 物はどこから来るのか？ 手が届くのか？）②一言で何を伝えたいか言える③冒頭で惹きつける④周囲の反応が現実的である（すべての転換点を 3 つの段階に分ける：問題 → 主人公がどう解決するか → 周囲がどう反応するか、反応には順序が必要）⑤AI が撮影できる画面である（弱点リストを避ける：人物の交差、小さな物を持つ手、文字、鏡の反射、左右非対称、1 ショット内での照明変化、1 人の人物が連続して 3 つの動作をする、俯瞰で顔が見えない、脇役が多すぎる）。
• テンプレート：templates/01-story.md に記入して Codex に送信。
• 合格条件：新しいレビューセッションを開き、確定したストーリーのみを渡し、templates/02-story-review.md でレビューし、「承認」を得る。

ステップ 2：ストーリーボード（初期段階で最も重要、構図と配色はストーリーよりも重要）

• 各ショットに以下を明確に記述：シーン内の時間、生成秒数（切り上げて 0.5 秒多めに取る）、ショットサイズ、カメラアングル、カメラワーク、誰がどちらに動くか（画面の左右を明記）、どのような表情で進行するか、何が動いているか、次のショットにどう移行するか。
• 6 つの厳格な要件：①すべてのショットでアングルを変え、アイレベルの正面ショットは作品全体で最大 2 回まで②画面内に常に何かが動いている③全身/バスト/アップショットを交互に使用④各ショットで少なくとも 1 つのものが動いており、動くべきは動き、静止すべきは静止している⑤カメラワークには理由が必要（何かを追う/徐々に近づく/遠ざかる）⑥黄金比の構図で、頭や目は左から 38% または 62% の位置に配置。
• 配色は個別に設計し、各シーンのカラーパレットをリストアップ。白黒にして確認し、人物と背景が区別できない場合は配色を再調整。
• 参考動画がある場合は、Codex にフレームごとにカメラアングルと画面内外への出入りの比率を測定させてから模倣させる。
• テンプレート：templates/03-storyboard.md。
• 合格条件：色ブロックのサムネイル全体マップ（1920×1080、38%/62% のラインを表示）をユーザーに確認してもらう。

ステップ 3：アートスタイルの決定、コンセプトアートの作成

• 参考画像があれば最適で、直接渡す。Codex がプロンプトを作成し、自身で描画。ユーザーはスタイルが合っているかどうかのみを確認。
• 各キャラクターと固定小道具につき 1 枚のコンセプトアート：正面、側面、いくつかの表情。固定の特徴は位置を明確に記述（タトゥーは左腕にある）。
• 合格条件：ユーザーがアートスタイルを確認し、本番ショットの描画を許可する。

ステップ 4：各ショットの開始・終了フレームの作成（再生成率低減に最も重要なステップ）

• 順序：まず AI に各ショットの「開始フレームに何を描くか、終了フレームに何を描くか、その間で何が起こるか」を記述させる。レビューで承認されたら描画に進む（クレジット節約）→ まず最も内容の多い終了フレームを描画 → 終了フレームを修正して開始フレームを作成（カメラアングルと構図の一貫性を保証）→ 同じ場所、同じカメラアングルは直接部分的に修正 → ズームインショットは開始フレームの一部を切り取って拡大し、終了フレームとして使用 → 16:9 であり、開始フレームと終了フレームのサイズが一致していることを確認。
• 描画後、templates/04-frame-check.md を使用して 8 項目を 1 つずつチェック（動作と小道具が開始フレームに存在する、リアクションを事前に配置、ポーズをすべて同じにしない、アクションのためのスペースを確保、風向きの統一、スマートフォンサイズで確認、拡大して余分なオブジェクトを確認、開始フレームと終了フレームを重ねて位置ずれを確認）。
• 雨、帽子、タトゥーなどの小さなオブジェクトは、開始フレームと終了フレームの両方に必ず描画すること。テキストで記述するだけでは、生成中に消えてしまう。
• 合格条件：8 項目のチェックをすべて通過し、ユーザーが修正に同意した後に修正。

ステップ 5：動画プロンプトの作成、提出前のレビュー

• 固定の 7 部構成：【アートスタイル】【カメラワーク】【構図と配色】【人物】【秒単位の記述】【音声】【制約】、毎秒何が起こるかを詳細に記述。テンプレート：templates/05-video-prompt.md。
• 記述前に references/pitfall-table.md の 20 の一般的な落とし穴を確認する。問題が発生した場合、まずプロンプトを疑い、次にモデルを疑う。
• 合格条件：各セグメントを提出する前に、新しいレビューセッションを開き、templates/06-pre-submit-review.md を使用してプロンプトと画像のすべての詳細を照合する（これまでに、カップのサイズが 13% 異なる、ある画像に帽子のつばがあり別の画像にはない、左右が逆などが発見されている）。「承認」と記述されて初めて提出し、ユーザーが見積もりに同意して初めて費用が発生する。

ステップ 6：動画の生成

• scripts/seedance.py を使用して提出（720p、開始・終了フレームモード）、ポーリングでクリップを取得。
• 節約テクニック：720p で出力し、後で 1080p に拡大。テストクリップは撮影せず、最初の本番ショットから直接撮影。新しいアプローチは、まず最も難しい 1 ～ 2 ショットでテストし、うまくいけばすべてを提出。予算が限られている場合は、2.0 mini（約 1/3 の価格）を使用、複雑でないショットには十分。音声は必ず確認してから使用（2.5 は「音楽なし」と指定しても音楽が混入することが多い）。
• 問題発生時の対処順序：①クリップの先頭または末尾の数フレームだけに問題がある場合は、カットできるかどうか②コードで修正できるかどうか③最後に再撮影。その際は、まずプロンプトまたは開始・終了フレームを修正してから、そのショットのみ再撮影。古いクリップは絶対に削除せず、最後に新旧すべてから選択。
• 合格条件：ユーザーが動画と音声を確認。

ステップ 7：結合、トランジション、カラーグレーディング、アップスケーリング

• すべてコードで行い、Codex が ffmpeg/Python スクリプトを作成。テンプレート：templates/07-postprocess.md（トランジションはモーションブラー、8～16 分割ハーフフレームシャッター。彩度と明るさのみを調整し、色相は変更しない。BT.601 でデコード、中間はロスレス、納品は BT.709。lanczos で 1080p に拡大し、軽いシャープネスを追加。ビートマッチは元の曲から拍を検出）。
• 完了後、編集ポイントの前後 3 フレームを抜き打ちチェック。

ステップ 8：最終レビューと納品

• 新しいレビューセッションを開き、最終動画のみを渡し、結論は一切与えず、初めて見る観客のように最初から最後まで視聴させる。テンプレート：templates/08-final-review.md。
• Codex にサマリーをアーカイブとして作成させる：アートスタイル、プロンプト、犯した間違い。これらをプロジェクトフォルダに蓄積し、次の作品で直接再利用する。

4 スレッドモード（オプションの上級編）

作品が複雑で予算が大きい場合、templates/09-four-threads.md を Codex に送信する。メイン制作 + レビュー + 監督 + エージェントの 4 つのセッションが連携し、エージェントは総予算内でのみ提出を承認できる。日常的な短編作品では不要で、単一のレビューセッションで十分です。

不変のルール（すべての子セッションに適用）

1. 私がストーリーを確認するまで、画像は一切描画しない。私がアートスタイルを確認するまで、本番ショットは描画しない。
2. 動画生成を提出する前に、必ず独立レビューで「承認」を得ること。見積もりに私が同意して初めて提出する。
3. 動画に問題が発生した場合：まずカット、次にコードで修正、最後に再撮影。修正して再撮影するのはそのショットのみ。
4. 新しいバージョンは新しいファイルとして保存し、古いファイルを上書きしたり削除したりしない。
5. 動画や音声を確認していないものについては、「未確認/未視聴」と明確に伝える。
6. クレジットの購入やチャージは行わない。API が残高不足を返した場合は停止し、既存のクリップをラフカットして見せる。
7. Codex のクレジットが切れた場合は回復を待つ。一度にあまり多くの画像を同時に描画しない。小さな部分を修正する場合は、修正した部分を元の画像に貼り付ける。

ファイルインデックス

• templates/ — 10 個のプロンプトテンプレート、00–09 の番号でフローに対応。[角括弧] に記入して送信。
• references/pitfall-table.md — モデルの 20 の一般的な落とし穴のチェックリスト。プロンプト作成時に各項目を確認。
• references/roles.md — 役割分担表と 4 スレッドモードの役割説明。
• scripts/env_check.py — 環境チェック。
• scripts/seedance.py — Seedance 提出/ポーリング/ダウンロード。