Video Watch
GitHub Copilotが検査できる動画アーティファクト(キャプション、フレームコンタクトシート、フレームインデックス、マニフェスト、プロンプトパケット)を準備します。
このスキルはbradautomates/claude-videoに着想を得ていますが、GitHub Copilotワークフローを対象としています。Claude CodeのRead並列処理は想定しないでください。まずファイルを生成し、その後ユーザーの質問に必要なアーティファクトのみを検査します。
使用するタイミング
- ユーザーが動画の視聴、検査、要約、比較、または診断を依頼した場合。
- 入力が
yt-dlpでサポートされている動画URL、またはローカルの.mp4、.mov、.mkv、.webmファイルである場合。 - タスクが、画面に表示される内容と音声の両方に依存する場合(バグの再現、製品デモ、ローンチ動画、チュートリアル、ウェビナー、広告、画面録画など)。
適さないケース
- DRM、ペイウォール、認証、サイト利用規約を回避しないでください。
- クッキー、ベアラートークン、署名付きURL、プライベートメディアの認証情報を要求または保存しないでください。
- 公式APIや既存のトランスクリプトでタスクが解決できる場合は、動画処理よりもその軽量な方法を優先してください。
コアワークフロー
- 依存関係が不明な場合はプリフライトを実行します:
python .github/skills/video-watch/scripts/preflight.pyURL入力の場合はpython .github/skills/video-watch/scripts/preflight.py --url-modeを使用します。 - アーティファクトを生成します:
python .github/skills/video-watch/scripts/video_watch.py <url-or-path> --question "<what to answer>"別のツール、Azure Speech、またはSpeech Translator Desktop Plusが既にトランスクリプトを生成している場合は、--transcript-file <path>を使用します。 プライベートまたは認証が必要なメディアの場合は、--detail transcript --metadata-only --transcript-file <path>を推奨し、クッキー、ベアラートークン、署名付きURL認証情報を渡さないでください。 - アーティファクトを次の順序で読み取ります:
manifest.json→prompt.md→transcript.md→frame-index.md→contact-sheet.jpg→ 必要に応じてframes/内の選択されたファイル。manifest.jsonは、ローカルソースのバイト、またはダウンロードが発生した場合のURL動画バイトのSHA-256を記録します。メタデータのみのURL実行では、メディアを取得せずにハッシュをnullのままにします。 - アーティファクトから回答します。回答がトランスクリプトのみ、フレームのみ、またはまばらなサンプリングに制限されている場合は、その旨を明記します。
- 特定の瞬間については、
--start/--endを使用して再実行し、フレーム予算を集中させます。
詳細モード
| モード | 用途 |
|---|---|
transcript | キャプションまたはサイドカートランスクリプトのみ。最速。 |
efficient | 迅速なトリアージのための小さなビジュアルパス。 |
balanced | ほとんどの画面録画やデモに適したデフォルトのコンタクトシート。 |
token-burner | ユーザーが広範なビジュアルカバレッジを明示的に必要とする場合の大きなビジュアルパス。 |
ラバーダックチェックポイント
- このスキルのワークフローを変更する前に、プリミティブの選択、隠れた依存関係、セーフティバウンダリ、Copilotアーティファクトの順序について計画をレビューします。
- 編集後、
SKILL.md、スクリプト、および参照が自己完結型の動作、トリガーの品質、行数、実行可能な検証についてレビューします。 - 批評家を読み取り専用として扱います。プロデューサーが変更を適用し、検証を再実行します。
参照
| 必要なもの | 参照 |
|---|---|
| 詳細ワークフロー | references/workflow.md |
| 依存関係とセットアップ | references/dependencies.md |
| フレーム予算とコンタクトシート | references/frame-budget.md |
| オプションのScout/Whisper/Azure Speechバックエンド | references/backends.md |