mcpField
S
shot-by-shot-analysis

shot-by-shot-analysis

github.com/postplusaiクリエイティブ・メディア27499 回インストール1 日前に更新
リポジトリ

shot-by-shot-analysis について

shot-by-shot-analysis は、複数の参考動画を根拠付きの Markdown レポートにまとめるスキルです。各動画の証拠を記録してからスタイルの共通ルールを整理し、後続制作への引き継ぎ情報も作成します。

主な機能

  1. 01動画を個別に確認
  2. 02タイムコード付きのショット記録
  3. 03共通点と個別要素の比較
  4. 04スタイル規則と確信度の記述
  5. 05後続制作への引き継ぎ

活用シーン

  1. 01広告参考動画から共通のショット表現を抽出
  2. 02画像・動画制作向けに根拠を整理
  3. 03分析レポートの不確実性を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/postplusai/postplus-skills --skill shot-by-shot-analysis

インストール後、Claude Code で/shot-by-shot-analysisを入力して読み込まれたか確認します。

同梱ファイルreferences/report-template.md

詳細

ショットごとの分析

目的

複数の参照動画を、人間がレビューでき、下流の生成スキルが利用できる、エビデンスに基づいた 1 つの Markdown レポートに変換します。まず分析し、すべてのソースを検査した後にのみ統合します。

実行境界

  • 実際の動画理解には media-analysis を使用します。各ソースを、同じ正規のビートエビデンス契約を用いて個別のリクエストで分析します。
  • 画像、動画、プロンプト、ワークフロー、実行リクエストを生成しないでください。
  • 映像自体が検査されていない場合、メタデータ、ファイル名、トランスクリプト、サムネイル、一般的な知識から動画の内容を推測しないでください。
  • 生のホストされたレスポンスと一時的なリクエスト記録は内部に留めます。<case>-shot-by-shot-analysis.md という名前の 1 つの Markdown レポートを納品します。

ワークフロー

  1. すべての入力動画を棚卸しします。安定したソースラベル、パスまたは URL、判明している場合は再生時間、ソースの根拠を記録します。
  2. 各動画を独立して検査します。後の動画を分析している間は、以前の分析や共有スタイル理論の草案を参照しないでください。
  3. 観察可能なショットまたは意味のある連続したビートでセグメント化します。開始・終了のタイムコードを使用します。正確なタイミングが不明な場合は、おおよその境界であることを示します。
  4. 動画のより広い目的を解釈する前に、現在の動画のビートエビデンスブロックを完成させます。推論の前に、可視・可聴のエビデンスを記述します。
  5. ブロックが使用可能な全時間をカバーし、ソースの順序を保ち、発話、音、動き、製品、制作意図を捏造していないことを検証します。
  6. すべての動画が完全なビートエビデンスを持つまで繰り返します。
  7. 完成したすべてのエビデンスセットを比較します。反復する文法と、単発の詳細および独自の認識可能な要素を分離します。
  8. 具体的なルール、裏付けとなるソースとタイムコードの参照、再発性、信頼度を備えたスタイル文法レポートを作成します。
  9. コンパクトな下流ハンドオフセクションを追加します。スタイルの論理を保ちつつ、最終的なプロンプトや実行リクエストにはしないでください。

ビートエビデンス契約

各ソースについて、完全な media-analysis セクション 4 の Shot-By-Shot Evidence ブロックを保持します。正確なフィールドには references/report-template.md を使用します。それらを横長のテーブルに変換したり、フィールドを省略したりしないでください。

次のルールを適用します。

  • 解釈する前に、可視・可聴の内容を記述します。
  • 視覚的エビデンスは事実に基づいて保ちます。推論された物語上または商業上の機能は production purpose にのみ記載します。
  • フレーミングは、ショットサイズ、アングル、ヘッドルーム、被写体の配置、奥行き、前景、ネガティブスペースといった制作用語で記述します。
  • カメラの動きと被写体の動きを区別します。
  • 発話や可視テキストは、判読または聴取できる場合にのみ引用します。それ以外の場合は unclear、partially audible、または別の正確な不確実性マーカーを記述します。
  • 編集のリズムは、観察可能なカットの長さ、カットの種類、ポーズ、速度変化、モンタージュの密度、連続性の挙動を用いて記述します。
  • エビデンスが曖昧な場合は、推論された感情状態または制作意図に信頼度を付けます。
  • フィールドが実際に発生しない場合は not present を使用します。欠如を推測で埋めないでください。
  • コンパクトなテーブルは短い比較にのみ使用します。密な観察と引用された言語は縦型のビートブロックに留め、レポートが狭い画面やエージェントのコンテキストでも読みやすくなるようにします。

合成ルール

  • 早い段階で動画を平均化しないでください。完成したビートエビデンスのみから合成します。
  • パターンが反復していると見なすのは、複数のソースによって裏付けられている場合、または 1 つのソース内で独立した例が繰り返し確認される場合に限ります。より狭い根拠を明示してください。
  • エビデンスは <source-label> @ <timecode> として引用します。
  • すべての文法ディメンションについて、次を区別します:
    • shared rule: 再利用可能な制作上の振る舞い
    • evidence: 裏付けとなるソースとタイムコードの参照
    • recurrence: 反復的、ソース固有、または不確実
    • confidence: 高、中、または低
  • premium、cinematic、 authentic、native といったラベルよりも、具体的な言葉を優先してください。これらのラベルは、それを裏付ける視覚的・聴覚的エビデンスを説明した後にのみ使用します。
  • クリエイターのアイデンティティを保持することなく、カメラ文法、タイミング、オブジェクトロジック、関係性ロジック、音の振る舞い、感情の進行を保持します。

模倣の境界

以下をコピーしたり、コピーを推奨したりしないでください:

  • クリエイターのアイデンティティ、顔、声のアイデンティティ、または特徴的な個人的な癖
  • 正確なシーン、ロケーション、衣装、会話、ジョーク、またはショットの順序
  • ブランドマーク、パッケージのアイデンティティ、私的な詳細、または識別可能な背景 情報
  • 独自のオーバーレイ、シグネチャーグラフィック、その他のソースを識別する要素

有用な参照エビデンスを一般的な制作ルールに変換します。識別可能またはソース固有の要素は must_keep ではなく avoid の下に配置します。

Markdown 成果物

references/report-template.md から、完全なソース ビートエビデンス、順序付けられた Style Grammar Report、および簡潔なハンドオフを含む 1 つのレポートを作成します。

下流へのハンドオフ

ハンドオフは簡潔に保ち、レポートから導出します:

  • 画像生成: 静的なフレーミング、被写体の状態、シーン、ライティング、パレット、製品の配置、must_keep、can_vary、および avoid を抽出します。これを image-batch-runner の前にクリエイティブプランニングへ引き渡します。
  • 動画プロンプトアーキテクチャ: カメラ言語、動き、編集リズム、音、話し方の姿勢、感情の進行、製品の振る舞い、連続性、およびジェネレーターのリスクを video-batch-runner の前に抽出します。
  • ワークフロー作成: 完全なレポートをソースエビデンスとして提供します。その ルールをポジティブで実行可能なシーンキャリアと明示的な参照ジョブにコンパイルします; 分析の言葉や模倣の警告をモデルプロンプトに貼り付けないでください。

ユーザーが明示的に要求しない限り、別個のハンドオフファイルを作成しないでください。

品質チェック

ハンドオフの前に、次を確認します:

  • すべての入力動画に完全で順序付けられたビートエビデンスがある
  • 合成は最終的なソースエビデンスセットの後にのみ開始される
  • 共有される主張が裏付けとなるソースとタイムコードを引用している
  • 反復的な詳細と一度限りの詳細が分離されている
  • 不確実性が黙って解消されるのではなく可視化されている
  • 制作目的の推論が観察として提示されていない
  • 独自または識別可能なアイデンティティ、ブランド、および私的な詳細が 再利用可能なルールから除外されている;レポートが人間に読みやすく、制作に特化したままである

停止条件

  • ソース動画にアクセスできない、または実際に検査できない場合は停止します。
  • ソースの欠落が、要求された動画横断の 合成を大きく変える場合は停止します。
  • ホストされた分析コマンドが失敗した場合は、正確なエラーを報告し、動画エビデンスを推測で置き換えないでください。

コメント