Communitygithub.com

lightning-emperor

CG(Blender/Cycles)を実写プレートに合成するためのワークフローとツール。特にブルースクリーンやグリーンスクリーンの置き換えに使用します。カメラマッチング(レンズ、センサー、被写体距離の二重検証)、実写照明マッチング、キーイングとデスピル、マーカートラッキング、アクターの影のCGへの合成、グレインマッチング、リニアライト合成をカバーします。ユーザーがCGの実写プレートへの合成、グリーン/ブルースクリーンや背景の置き換え、CGセットや壁をプレートに固定、CG照明やカメラをショットに合わせる、スピル、マット品質、カメラトラックの揺れ、影のキャッチ、グレインマッチング、またはVFXショットのレンダリングについて言及したときはいつでも使用してください(「VFX」やツール名が明示されなくても)。

lightning-emperor とは?

Lightning Emperor は、実写プレートに CG を合成するための包括的なワークフローとツールセットです。特にブルースクリーンやグリーンスクリーンの置き換えを想定して設計されており、MCP サーバー(lightning-emperor-mcp)、CLI(lightning-emperorコマンド)、Blender アドオンの 3 つの形式で提供されます。すべて同じコードベースで動作し、接続可能な場合は MCP ツールが優先され、それ以外では CLI が使用されます。このスキルは、カメラマッチング(レンズ、センサー、被写体距離の二重検証)、実写照明のマッチング、キーイングとデスピル、マーカートラッキング、アクターの影のCGへの合成、グレインマッチング、リニアライト合成など、VFX 合成のあらゆる側面をカバーします。主なルールは、プレートの測定を最優先し、絶対スケールを二重に検証し、リニアライトで合成し、オリジナルファイルを決して上書きしないことです。ワークフローは、取り込み、カメラ、照明、キーイング、トラッキング、影、グレイン、合成、引き継ぎの順に構成されており、各工程で関連するリファレンス文書を参照するよう指示されています。このスキルは、Claude Code、Cursor、Codex などの AI エージェントとの連携を想定しており、ユーザーが CG 合成に関するタスクを要求したときに、測定と検証を徹底しながら高品質な VFX ショットを実現することを目的としています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LucidMach/LightningEmperor/tree/HEAD/skill/lightning-emperor

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Lightning Emperor: CG-into-plate compositing

実写アクターの背後や周囲に CG を配置するためのワークフローとツール。ツールは次の 3 つの方法で提供され、すべて同じコードを実行します。 MCP サーバー (lightning-emperor-mcp)、CLI (lightning-emperor ...)、および Blender アドオンです。MCP ツールが接続されている場合はそれを優先し、それ以外の場合は CLI を使用します。このファイルは判断基準です。何を測定するか、何が問題になるか、自身の作業をどのように確認するかを示します。

高額なミスを防ぐルール

  1. プレートを決定する前に測定する。 レンズ、センサー、露出、ホワイトバランス、スクリーンの色と強度、ノイズ、光の方向。10秒の測定で1時間の推測が不要になります。
  2. 絶対スケールを最初に正しく取得し、それを2つの方法で確認する。 アクターに対する CG スケールは、カメラから被写体までの距離に直接依存します。既知のもののピクセルサイズ(頭部は頭頂からあごまで約 0.24 m)と、カメラファイルのレンズ焦点距離の両方から測定します。それらが一致しない場合は、停止して解決します。距離を誤ると、すべてのフレームで CG セット全体のサイズが間違ったものになります。スケールエラーを隠すために補正係数を追加してはいけません。
  3. キーライトは、ブリーフやセット写真ではなく、アクターから見つける。 リニアライトで顔の両側を比較します。セット写真は存在するライトを示しますが、プレートはどれが支配的かを示します。
  4. リニアライトで合成し、プレートが何であるかを明示する。 ディスプレイ参照ビデオ:線形化、混合、再エンコードします。画像がフラットに見えるからといってログを想定してはいけません。
  5. 画像をフルサイズと部分拡大で確認する。 サムネイルはスピル、穴、フリンジを隠します。ツールが書き込んだプレビューを信頼する前に、必ず開いて確認します。
  6. 修正がバグよりも悪化する場合がある。 各修正後、フレーム全体を再確認し、保護していたものを再測定します。
  7. 動画を見ることはできない。 動きは数値(ステップサイズ、ジッター)で測定し、ユーザーの目だけが判断できることを明確に述べます。
  8. オリジナルを決して上書きしない。 長時間のレンダリングの前に入力サイズ/時間を確認し、ソースファイルはそのままにしておきます。
  9. 限界について正直になる。 ユーザーが何かおかしいと言うとき、それはほとんどの場合正しいです。調査し、数値を報告し、何を間違えたかを伝えます。

ワークフロー

0. 取り込み。 すべてのファイルをプローブします。フォーマットが許可する場合はカメラメタデータを読み取ります(read_camera_metadata / lightning-emperor metadata):焦点距離(ズームしたか?)、焦点距離、ISO、ホワイトバランス。作業に影響するものだけを尋ねます:CG がアクターに対してどこに位置するか、カメラの高さ、出力形式。

1. カメラ。 プレート内の既知のサイズとレンズ焦点距離から solve_camera_distance を実行し、agree: true を要求します。次に plan_camera(ポーズ、オーバースキャンサイズ、メートルあたりのピクセル数)を実行します。オーバースキャン(約 1.25)でレンダリングし、トラッキングされた動きがレンダリング端を露出しないようにします。

2. 照明。 顔からキーサイドを見つけます。plan_lights は開始位置と色を提供します(方位角 0 = カメラから、+90 = カメラ右、ケルビン色)。CG 露出は、プレート内の測定値(肌パッチ、背景)に合わせて校正し、目視では行いません。点滅する照明器具:practical_states はレンダリングするフレーム(オン/オフ)を提供します。

3. キー。 key_frame を実行し、preview_on_grey.png を開きます。キーはスクリーンに自己校正しますが、references/keying.md を読んで確認すべき点(暗い服の穴、スピルの色かぶり、島として残るマーク)を確認します。

4. トラック(カメラが動き、背景が置き換えられる場合のみ)。 track_markers は、ホモグラフィを使用してフレームごとにマーカー群を追跡します。references/tracking.md を参照してください:マーカーの少ないフレームはノイズが多く、平らな背景は平面です(ホモグラフィが適切なモデル)、視野内にマーカーがない場合はホールドまたは補間していることを意味します。

5. 影。 shadow_offset は、ライトのジオメトリとアクターと壁の隙間から、アクターの影が背景に落ちる位置を計算します。references/shadows-and-grain.md を参照してください。

6. グレイン。 平らなスクリーン領域から measure_grain を実行し、CG に適用して貼り付けたように見えないようにします。最終解像度で測定します。

7. 合成。 最初に1フレームで composite_frame を実行します。壁のサイズがアクターに比べて適切か、影の側面、エッジ、黒レベルを確認してからスケールアップします。長時間のジョブはチャンクでレンダリングし、フレーム数を確認します。

8. 引き継ぎ。 トラッキングが一定期間信頼できない場合は、アーティストにレイヤードパスとフレームごとの正直な品質フラグを渡し、完成したふりをした合成は渡しません。

ツールマップ

ニーズMCP ツールCLIアドオン
カメラファイルからのレンズ/露出read_camera_metadatametadataプレートパネル
書き出しをカメラファイルに合わせるalign_clipalign
被写体距離solve_camera_distancedistance被写体 + カメラ
カメラポーズ、レンダリングサイズplan_camera, build_shot_sceneショットカメラを作成
ライトリグplan_lightsライト
照明器具のオン/オフフレームpractical_states点滅
CG ステートのレンダリングrender_statesCG をレンダリング
マット + デスピルkey_framekeyプレートツール
マーカートラッキングtrack_markerstrackプレートツール
影のオフセットshadow_offsetshadow-offset
グレインmeasure_graingrainプレートツール
1フレーム合成composite_framecomp

ツールエラーは {"error": "..."} と理由が返されます。入力を修正して再試行してください。 Blender はヘッドレスジョブとして実行されます。実行中の Blender ウィンドウ内でコードを実行するソケットを開こうとしないでください。

リファレンス(該当する段階で読むこと)

  • references/failure-modes.md - 何が問題になるか、その理由と修正方法。最初にざっと読むこと。
  • references/scale-and-distance.md - カメラ距離の誤りとそれを防ぐルール。
  • references/lighting.md - 実際のキーライトを見つけ、リグを構築し校正する方法。
  • references/compositing.md - マット、4種類のスピル、ペデスタル、ソフトネス、ライトラップ、チェック項目。
  • references/camera-metadata.md - カメラファイルが伝える情報と、書き出しをそれに合わせる方法。
  • references/review.md - 批判エージェントを自己欺瞞なく使用する方法。
  • references/keying.md - マット、デスピル、エッジ処理、実際の映像から学んだこと。
  • references/tracking.md - マーカートラッキング、安定化、ギャップ処理。
  • references/shadows-and-grain.md - 影のジオメトリ、グレインの測定とマッチング。
  • references/blender-notes.md - ヘッドレス作業のための Blender 4.2-5.x スクリプティングノート。

関連スキル