muapi-cinema-director

🎬 AI シネマディレクター スキル

AI エージェントが高品質なシネマティック動画を演出するための専門スキルです。 シネマディレクタースキルは、抽象度の高い創作意図を、最先端の動画モデル（Veo3、Kling、Luma）向けの技術的な撮影指示に変換します。

中核となる能力

1. ショット構図の分析：感情の展開を適切なフレーミングに対応付けます（例：親密さにはエクストリーム・クローズアップ、孤独感にはワイドショット）。
2. カメラワークの構成：複雑な物理的動き（ドリー、トラック、クレーン）やレンズ効果（ラックフォーカス、ドリーズーム）を指示します。
3. ライティングと雰囲気の設計：時間帯やスタイルに応じたライティングを指定します（ゴールデンアワー、キアロスクーロ、ボリューメトリック・ゴッドレイ）。
4. 技術パラメーターの最適化：最適なフレームレート、アスペクト比、モデル固有のバイアスを自動的に選択します。

---

🏗️ 技術仕様

1. 意図の対応表

創作意図	フレーミング	動き	ライティング
ヒーローの登場	ローアングル／ワイド	クレーンアップ／オービット	リムライト／ハイコントラスト
緊張感／不安感	ダッチアングル	手持ちカメラの揺れ	ローキー／強い影
内省的	クローズアップ	ゆっくりプッシュイン	柔らかなレンブラント照明／窓からの光
荘厳／壮大	エクストリームワイド	ドローンの空撮	ゴールデンアワー／ボリューメトリック
憂うつ	プロファイル／ミディアム	ゆっくりプルアウト	ブルーアワー／彩度を抑えた色調

2. カメラの物理的な動き

• Dolly In/Out：被写体に向かって、または被写体から離れるように、レール上でカメラを物理的に移動させます。
• Truck Left/Right：横方向への物理的な移動です。
• Crane/Jib：高所から上下に大きく移動します。
• Orbit：中心点の周りを円を描くように移動します。
• Pedestal：カメラを傾けずに垂直方向へ移動します。

3. レンズと光学効果の制御

• Shallow DOF：背景をぼかします（ボケ）。
• Anamorphic：横方向のフレアとワイドスクリーンのシネマティックな雰囲気を生み出します。
• Rack Focus：ショット内で異なる距離にある被写体の間で焦点を移動させます。

---

🧠 プロンプト最適化プロトコル（エージェント向け指示）

スクリプトを呼び出す前に、エージェントは必ず以下のディレクタールールに従って、ユーザーの未加工のプロンプトを拡張してください。

1. 技術要素の付与：「かっこいいアクション」を技術的なショット指示に変換します。
   • 式：[ショットタイプ] + [被写体／アクション] + [環境] + [ライティング] + [カメラの動き] + [レンズ効果]
2. 動きのダイナミクス：映画的な動詞を使います。Dolly In（親密さ）、Crane Up（壮大さ）、Orbit（英雄的な印象）、Truck（並行移動）。
3. ライティングのレシピ：具体的な照明手法を適用します。Volumetric God Rays、Teal-and-Orange Grade、Cyberpunk Rim Lighting、Rembrandt Portrait Lighting。
4. 物理的な整合性：モデルの推論を促すため、光の関係を描写します（例：「雨に濡れたアスファルトに揺らめくネオンの反射」）。

---

🚀 プロトコル：シネマディレクターの使用方法

ステップ 1：クリエイティブブリーフを定義する

エージェントに、被写体と「ディレクターの意図」を伝えます。

ステップ 2：スクリプトを呼び出す

generate-film.sh スクリプトは --brief を受け付け、内部の撮影知識を使って内容を拡張します。

# Directing a scene
bash scripts/generate-film.sh 
  --subject "A lone samurai in a blizzard" 
  --intent "epic reveal" 
  --model "kling-master"

ステップ 3：非同期応答を処理する

動画の生成は非同期で行われます。返された request_id を使い、core/platform/check-result.sh で完了を確認します。

---

⚠️ 制約とガードレール

• 時間的一貫性：1つのショット内で、被写体を複雑に変化させることは避けてください（例：「男性が鳥に変身する」）。
• 動きの衝突：矛盾する動きを同時に組み合わせないでください（例：「Dolly In」と「Dolly Out」を同時に指定する）。
• 物理的なリアリズム：よりプロフェッショナルな「映画」のような見た目にするため、現実の機材で実現可能な動きを優先してください。
• モデルのバイアス：
  • Veo3：ゆっくりとした高品質な美的ショットに最適です。
  • Kling：複雑なキャラクターの動きや物理表現に最適です。
  • Luma：テンポが速く、アクション性の高いシネマティックなシーケンスに最適です。

---

⚙️ 実装の詳細

このスキルは、core/media/generate-video.sh プリミティブ向けの「エキスパート翻訳者」として機能します。映画のスタイルの辞書を保持し、実行前にプロンプトへ技術的な指示を追加します。