video-analysis

動画分析

使用する場合

• ユーザーがローカルの動画ファイルまたは動画 URL を提供し、視聴、検査、 分解、デコンストラクト、フックの分析、ショットの理解、発話された セリフのキャプチャ、または動画がなぜ機能するかの説明を求めた場合。
• これはメタデータを超えた動画レベルのエビデンスに使用します。実際の 動画理解リクエストを文字起こしの推測や一般的なマーケティング知識から 回答しないでください。

使用しない場合

• タスクがアイデア出し、QA、または引き継ぎセクションに記載された別の リリース済みスキルに属する場合。
• 必須の入力が欠けており、推測すると結果が変わる場合。

実行範囲

• 分析は postplus media analyze を通じて実行されます。現在のフラグは postplus media schema --json で確認してください。
• サポートされるローカル形式は .mp4、.m4v、.mov、.webm です。
• ローカルパス、HTTPS URL、既存の PostPlus メディア参照、または動画データ URI を直接 --video に渡します。PostPlus がメディアを準備してリクエストを 実行します。事前にアップロードしたり、手動でリクエストオブジェクトを 作成したりしないでください。
• メディアの準備または分析が失敗した場合は、そのエラーで停止します。

ソースとパス

• ローカルファイルまたは HTTPS 動画 URL を直接分析できます。
• sourceId、sourceUrl、videoFilePath、sourceMetadataPath または データセットパス、モデル、プロンプトバージョン、ソースの根拠を保持し、 結果をソースメタデータに結合できるようにします。
• 入手にコストがかかる動画はダウンロードしたまま保持します。分析の Markdown ファイルとマニフェストは安定したワークスペースパスの下に 保持します。

分析範囲

• デフォルトの分析は、ソース動画ごとに 1 つの出力です。
• フック、ペーシング、ショットのビート、VO/オンスクリーンテキスト、 製品のタイミング、クリエイティブ戦略など、実用的なショートフォームの 構造をカバーします。
• 可視化されている場合は、Visual & Brand Signals も求めます。ジャンル/ ムード、カラーパレット、ライティング、カメラ言語、編集リズム、ブランドの 印象、最適なクリエイティブ用途などです。

出力と引き継ぎ

• media analyze はホストされた分析レスポンスを返します。そのレスポンスから 分析テキストを読み取り、ソース動画ごとに自然な Markdown ファイルを 1 つ、 安定したワークスペースパスに書き込みます。バッチランナーやサマリーファイルは ありません。
• 分析は、ショットのビート、タイムライン、VO/オンスクリーンテキスト、 再利用可能なコンテンツ構造、クリエイティブ戦略など、関連する場合に 有用な動画エビデンスをカバーするべきです。結果が分析を JSON で ラップしている場合は、コンテキスト内で読みやすい Markdown に 展開してください。
• 結果は観察可能な動画エビデンスに基づいている必要があります。データベース フィールド、カタログのフロントマター、検索インデックスは別の取り込み ステップに属し、一般的な動画分析の範囲には含まれません。

公開コマンドの境界

• postplus media analyze <model-key> --video <local-path-or-url> --prompt <analysis-prompt> --output <result.json> を実行します。 ソース動画の長さが判明している場合（たとえばローカルファイルから）、 --video-seconds <n> を渡して、ホストされた境界が対象のショート動画を 効率的にルーティングできるようにします。長さが不明な場合は省略します。

postplus media analyze video-analysis \
  --video ./reference.mp4 \
  --prompt "Describe the result you need" \
  --wait \
  --output ./result.json

• モデルキーとリクエストの形状は postplus media schema --json で確認します。 別の実行インターフェースを使用しないでください。
• CLI が引用確認チャレンジを返した場合は、postplus quote confirm --json --challenge-file <challenge.json> を実行し、返されたトークンで再試行します。
• ユーザー入力から一致する最小のコマンドを選択し、直接実行します。
• レディネス診断: postplus doctor --skill video-analysis。 コマンドが失敗した場合は、正確なエラーを報告して停止します。メタデータから 回答したり、メディアを書き換えたり、レディネスプローブしたり、所有権のない フォールバックを使用したりして、失敗を回避しないでください。