media-analysis について
media-analysisは、動画や画像の証拠を扱うエージェント向けのスキルです。ローカルフレームと表示字幕の確認を優先し、クラウド分析の条件や証拠の限界の伝え方も定めています。
主な機能
- 01タイムスタンプ付きコンタクトシートの作成
- 02ローカル動画フレームと画像の確認
- 03短いショットのサンプリング調整
- 04クラウド分析の利用条件の提示
- 05結果の保存と証拠範囲の明示
活用シーン
- 01動画フレームからシーン順を把握
- 02画面内の文字や製品の確認
- 03字幕で不十分な場合の音声分析
- 04既存のフレームやレポートを使った追加質問への回答
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ postplusai/ postplus-skills --skill media-analysisインストール後、Claude Code で/media-analysisを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/ordered-image-evidence.mdsingle-video-report.mdvideo-analysis.mdvideo-frames.md詳細
メディア分析
動画を分析するときは、まずローカルのコンタクトシートを作成してください。CLI は、約1秒ごとのフレーム、シーンチェンジ候補、最後にデコードされたフレームを、実際のソースタイムスタンプとともにまとめます。クラウド推論を選ぶ前に、返されたシートを確認してください。画像を準備しただけでは分析は完了していません。
確認後に次のステップを選択する
- 視覚に関する質問にはローカルで対応します。 確認した画像から、構成、シーンの順序、構図、表示されているテキスト、製品の見せ方を読み取ります。小さな文字や製品の詳細は、フルサイズのフレームを開いて確認してください。短いショット、短い字幕、動作の順序は、ローカルでより高密度にフレームを確認して絞り込みます。ローカルフレームを参照してください。1秒間隔の確認では、短いショット全体を見落とすことがあります。シーン候補と終了フレームによってカバー範囲は広がりますが、すべてのカットや動作を捉えた証明にはなりません。
- クラウド分析は、重要な音声情報の不足が残る場合にのみ使用します。 質問への回答に必要な話し言葉の内容を、読み取れる字幕から確認できない場合は、保持されている元のローカル動画に
--cloudを指定して使用してください。クラウド実行と復旧を参照してください。話している人物がいること、MP4 拡張子であること、またはより完全に見えるレポートが欲しいというだけでは、クラウド分析を使う理由になりません。 - 証拠が質問に答えられたら終了します。 既存の読み取り可能なレポートやフレームで、追加の質問に答えられることがあります。裏付けのある視覚的な回答を確認するために、クラウド分析を購入しないでください。「この動画を分析して」のように内容が指定されていない場合は、対象範囲を明示して、視覚情報と字幕から分かった内容を提示します。話題を理解するうえで重要な音声情報が不足している場合は解消してください。
字幕は表示されているテキストであり、元の音声を検証したものではありません。フレームからは、音楽、声のトーン、聞こえていない会話を確認できず、画面外のナレーターの存在も否定できません。確認していない音声は未評価として明記してください。ローカルでの準備に失敗した場合、その失敗は失敗のままです。クラウド分析を購入して回避しないでください。
画像は引き続き直接目視で確認します。アクセス可能な画像を確認するか、順序付きの画像投稿には postplus media prepare --source <url> を使用してください(画像の証拠を参照)。複数のソースと、それぞれの証拠、レポート、失敗は個別に扱ってください。
ローカルの視覚的証拠から始める
postplus media analyze video-analysis \
--video ./reference.mp4 \
--json \
--output ./contact-sheet.json
CLI の構造化された結果と報告された次のアクションに従ってください。自由記述のメッセージから復旧方法を推測しないでください。 既存の認可範囲内で依頼された作業には、既存の PostPlus クレジットを使用してください。見積もりのみの依頼では実行しません。適用される認可がない限り、チャージ、サブスクリプションの購入、公開、外部広告費の変更は行わないでください。最初の予約額は最終価格でも、確定した費用上限でもありません。必須の最終費用上限を適用できない場合は、実行せず、その上限について説明してください。 送信前に明らかなフィールドや形式の誤りがあれば、依頼された意図、モード、出力制約を変更せずに修正してください。送信後、または結果が不明な場合は、返されたチェックポイントまたはアクションを通じて同じ操作を再開してください。不確かな操作を再送信したり、復旧手段を使い切った後に繰り返したり、失敗を回避するためにプロバイダーを切り替えたりしてはいけません。 生の結果、操作 ID、復旧コマンドは実行記録に残してください。通常のチャットでは、結果、重要な制限事項、判明している費用、必要なユーザーの判断を伝えてください。アップロード、ポーリング、内部 ID、JSON について説明する必要はありません。メディアの作成方法を尋ねられた場合は、実際に使用したモデル、ユーザーの言語で送信したプロンプト、実際に送信した参照情報とその役割を提示してください。
デフォルトのコマンドは、Agent が確認するためのコンタクトシートとフレームのパスを返します。推論のためにアップロードすることはありません。ローカル動画にはアカウント接続は不要ですが、リモートソースの取得にはクレジットがかかる場合があります。返されたローカルファイルを再利用して、調整や後続のクラウド分析を行い、再取得を避けてください。
video-analysis は CLI の機能キーであり、別のスキルではありません。明示的なクラウド処理では、PostPlus が元のタイムライン全体に対して固定の分析プロンプトを使用します。カスタムの質問、形式、マーケティング指示を追加、置換、追記しないでください。クラウド処理に短縮版や詳細版の分岐はありません。ローカルフレームの制御にはコマンドのヘルプを使用してください。不明なクラウド入力を修正する場合に限り、postplus media schema --json を使用してください。
提供
ローカル作業では、実際に確認した画像、測定したタイムスタンプ、サンプリング/調整と音声のカバー範囲に関する簡潔な注記を添えて、ユーザーの質問に回答してください。目に見える事実や記録された文言と解釈を区別してください。視覚的なタイムラインの調査は、完全な音声・映像の記録ではありません。ローカルでの観察にクラウドレポートのテンプレートを適用しないでください。根拠となる画像を埋め込み、一時的なソースをクリーンアップした後も、保存済みの添付ファイルが読める状態を保ってください。ユーザーファイルは保持してください。
クラウド分析では、返されたモデルの Markdown を変更せずに提供し、レポートが長い場合は完全版へのリンクを付けてください。要約、マーケティング上の評価、整形した文字起こし、書き換えたショットリストで代用しないでください。レポートの範囲を参照してください。このフローの一環として、追加の Agent による完全性レビュー、戦略の統合、有料での再実行を予定しないでください。解釈や戦略を別途求められた場合は、保存済みの元のレポートを使い、その作業を別個に提供してください。分析プロンプトを変更したり、元の記録を置き換えたりしてはいけません。
ソース、レポート、失敗は分けて管理してください。ユーザーファイルと提供した証拠を保持してください。スクリーンショットだけでは、動きや音声の全範囲を確認できません。分析の失敗は失敗のままです。一部のスクリーンショットや字幕の観察には、制限があることを明記してください。
待機と復旧
ソースの取得やクラウドタスクでは、構造化された進捗と次のアクションに従ってください。切断後に待機を再開する場合は、同じタスク、アカウント、環境に対して返されたポーリング/チェックポイントのアクションを使用してください。 不確かな有料分析を最初からやり直してはいけません。PostPlus に範囲を限定した復旧を任せてください。不確かな作業を再送信したり、復旧回数の上限に達した後に再度復旧を試みたり、失敗を回避するためにプロバイダーを切り替えたりしてはいけません。
送信前にローカルで明確なパラメーター拒否が発生した場合は、コマンドのヘルプを参照して一度だけ修正してください。準備状態に関する失敗には、postplus doctor --skill media-analysis を使用してください。依頼された範囲内で既存の PostPlus クレジットと既存の支出承認を使用してください。見積もりは最終費用の上限を保証するものではありません。サーバーが強制できない明示的な最終費用の上限を設定して実行してはいけません。
表現や内容の品質に対する印象を理由に、やり直しを購入してはいけません。
最終的に失敗した場合は、影響を受けた分析、その理由、判明している費用状況、必要なユーザーの対応を説明してください。操作 ID と技術的な復旧アクションを実行記録に保存してください。結果が不明、または使用状況が記録されていないからといって、料金が発生していないとは限りません。見ていない、または聞いていない内容を分析したと主張してはいけません。