super-video-cut

super-video-cut は何をしますか？

ポジショニング

すべての編集作業をエビデンスチェーンを持つエンジニアリング納品として扱います。感覚的なクリップの寄せ集めではありません。このスキルは、再現可能な客観的測定、項目ごとに正当化された評価、再利用可能なタイムラインテンプレート、納品前のQC、そして全体にわたる著作権の境界を提供します。

references/ には詳細な資料が格納されており、能力領域ごとに分割されています（約50の文書、ほとんどが100～250行のパラメータテーブルと仕様です）。すべてを事前に読まないでください — 以下のルーティングに従い、現在のステージで必要な1～3文書のみを読んでください。

このファイル全体で使用されるボリューム短縮表記: 09/02 は references/09-material-memory/02-*.md を意味します。

3つのレッドライン

いずれかに違反した場合、納品してはなりません。

1. 参照スタイル: 先に評価、その後にカット。 ユーザーが参照動画を提供した場合、3次元評価（編集技法 / サウンド / シーン）を各項目に正当化を付けて完了し、タイムラインに触れる前にユーザーの確認を得なければなりません。その確認なしに行われたカットは手戻りとみなします。
2. 素材: モデルにアクセスする前にキャッシュを確認する。 動画素材を分析する前に、必ず material_cache.py lookup を実行してください。ヒットした場合は、素材説明カードを直接読みます — ビデオモデルを再度呼び出すことは禁止です。ミスの場合のみ、1回の本格分析を行い、登録します。
3. コンプライアンスとQCが最優先。 著作権リスクが未確定の計画をカットしてはならず、qc_scan.sh に合格していない完成ファイルを引き渡してはなりません。法律関連ボリュームは参考資料であり、法的助言ではありません。商業目的または高リスクプロジェクトの場合は、ユーザーに弁護士によるレビューを依頼するよう伝えてください。

メインワークフロー M0～M6

ステージ	目標	必読	出力
M0 要件聞き取り	実行可能なパラメータを確定	このファイル	ブリーフ
M1 素材取り込み	同じトークンに二度支払わない	09/02 + scripts/material_cache.py	素材カードまたはキャッシュヒット
M2 スタイル評価	「感覚」をパラメータに変換	08/02 + 08/03 + scripts/reference_probe.sh	評価シート + フィンガープリント + 1ページ結論
M3 編集計画	フィンガープリント → タイムライン	08/04 + 該当するジャンルボリューム	セカンドレベル計画
M4 制作	カット / 声 / 字幕 / グレーディング	必要に応じて 01 / 02 / 03	ラフカットとプロジェクト
M5 納品QC	技術的 + コンプライアンス合格	06/01 + 06/02 + 06/03	QCレポート + 検出ログ
M6 フィードバック	候補のみを生成し、ルールを自動変更しない	08/05	自己改善記録

M0 要件聞き取り: 不足パラメータは最大3つ質問

以下を入手する必要があります: プラットフォームとアスペクト比（安全領域と尺を決定）、総尺、ナレーション/吹き替えの要否、商業利用かどうか、納品仕様（解像度 / ビットレート / コンテナ）。

既に持っている情報から推論できることは推論して明示し、ユーザーに項目ごとに尋問しないでください。商業利用かどうかは、使用できる音楽と素材を直接決定します — 不明な場合は、必ず質問しなければなりません。

M1 素材取り込み: 5つの状態に対するアクションはハードコード

SK="$HOME/.workbuddy/skills/super-video-cut"
export MDC_HOME="$PWD/material-cache"     # キャッシュはプロジェクト内に置き、スキルディレクトリ内には絶対に置かない
python "$SK/scripts/material_cache.py" lookup "<素材パス>"

状態	アクション
HIT	ビデオモデルを呼び出さない。 $MDC_HOME/cards/<MID>.yaml を読み、トピック適応のみを行う
MISS	ローカルE1プローブ → references/09-material-memory/templates/model-analysis-prompt.md を使用した1回の本格分析リクエスト → カード記入 → validate → register
STALE	素材が変更された。古いカードを superseded とマークし、MISSとしてやり直す
HIT_BLOCKED	権利関係が未クリア。使用しない — まず権利を解決する
キルスイッチ	_config.json に cache_enabled=false がある場合、すべてをMISSとして扱う。バイパスは禁止

説明カードは3層構造です: L0 識別情報（ハッシュ / 仕様）、L1 素材説明（何が映っているか / どこで撮影されたか / スタイル / 使用可能か）、L2 トピック適応（このトピックが何秒使用するか、およびどのようなナレーション的役割を果たすか）。「トピックXのオープニングとしてうまく機能する」はL2にのみ属します — L1に入れると他のすべてのトピックを汚染します。

場所フィールドは厳格なルールです: 画面上のテキスト、ランドマーク、または撮影記録がない場合、place_name: null に設定します。「海とヤシの木がある」という理由だけで都市を推論してはいけません。

M2 スタイル評価: ユーザーが参照動画を提供する場合の6ステップ

S1 コンプライアンス事前チェック → S2 客観的プローブ → S3 2回のフル視聴 → S4 次元ごとの評価
→ S5 1ページ結論 → S6 ★ユーザー確認ゲート★

• S1 分析のみ。その表現を再利用しない。オープニングおよびクロージングタイトル、セリフ、音楽、キネティックテキスト、ショットの演出はすべて protected: expression とタグ付けする。
• S2 プローブスクリプトを実行し、再現可能な数値（カットポイント、ショット長、ラウドネス、無音、色統計、コンタクトシート）を取得する。
• S3 全体を2回視聴する: 1回目は映像のみ、2回目は音声のみ。早送りするとリズムとホールドビートが失われる — これは最も一般的な方法論的エラーである。
• S4 3つのコアグループ — A 編集技法 / B サウンド / C シーン（各10サブ項目）— に加えて、D 字幕、E ナレーション、F プラットフォームコンテキスト、および G コンプライアンス境界（必須） について項目ごとに評価する。
• S5 1ページ結論を提示する: 3つの主要特性、3つの転送不可能な項目、全体的な信頼度。
• S6 ユーザーに確認を求める。その確認なしにM3に入ってはならない。

すべての評価エントリは5つの部分すべてを埋める必要があります。欠落がある場合、エントリ全体が無効になります:

① 観察（タイムコード + 具体的な現象）② 根拠（エビデンスID）③ 推論（なぜこのようにデザインされたか）④ アクション項目（このカットがどのように使用するか）⑤ 信頼度（高/中/低 + 理由）

悪い例（絶対に出力してはいけない）: 「編集はスムーズで非常に映画的です。」 — タイムコードなし、根拠なし、アクション項目なし、実行可能なものは何もありません。

すべてのアクション項目には転送タグを付ける必要があります: transferable: parameter（リズム、尺、ラウドネス、ショットサイズのシーケンス — 学習可能）または protected: expression（特定のショット、セリフ、音楽、キネティックテキスト — 再現不可）。スタイルとフォーマットはアイデアの領域にあり、借用してもよい。表現はコピーしてはならない。 これがこのスキルの著作権の下限であり、提案ではありません。

M3 編集計画: フィンガープリントをセカンドレベルタイムラインに変換

08/04 のマッピングルールを読み、直接実行可能なタイムラインを生成する: 各クリップのイン/アウトポイント、ショットサイズ、トランジションタイプとフレーム単位の長さ、効果音キューポイント、字幕のイン/アウトポイント、ラウドネスターゲット。

競合解決の順序: ユーザーの明示的なリクエスト > プラットフォームのハード制限 > 参照動画の特性 > デフォルトの美学。素材が何かをサポートできない場合は、はっきりと言う — 「参照動画ではテクニックXが使用されています。このプロジェクトには該当する素材がないため、Yで置き換えます」 — 無理に詰め込まない。

M4 制作: 現在のアクションごとに1つのボリュームのみ読む

作業	読む
リズム、トランジション、軸	01/01、01/02
プロジェクト構成、プロキシ、コンフォーム、納品	01/03
カラーグレーディング、Log/LUT、HDR	01/04
ボイス録音、納品、ADR	02/01
ミキシング、ラウドネス、EQ/コンプレッション	02/02
スコア、効果音、サウンドデザイン	02/03
AI音声、TTS、SSML	02/04
字幕レイアウトと尺	03/01
SRT/VTT/ASS/TTMLフォーマット	03/02
文字起こし、アラインメント、バーンイン	03/03
多言語、CC/SDH、アクセシビリティ	03/04
特定のジャンルのカット方法	04/01–04/06

ラウドネスアンカー（完全なターゲットテーブルは 02/02 にあります）: ストリーミング約 −14 LUFS、ポッドキャスト/Apple 約 −16 LUFS、放送 EBU R128 −23 LUFS、True Peak は通常 ≤ −1 dBTP が必要。ターゲットプラットフォームの公式ドキュメントを優先。不明な場合は、まず測定し、その後決定する。

M5 納品QC: 最初にスクリプトを実行し、その後人間として判断

bash "$SK/scripts/qc_scan.sh" "<完成ファイル>" "<出力ディレクトリ>"

1回の実行で、仕様JSON、デコード整合性、黒フレーム/フリーズ検出、無音、ラウドネス、コンタクトシートが得られます。スクリプトは技術的な異常のみを見つけられます — コンテンツとコンプライアンスは手動でテーブルを確認する必要があります:

• 06/01 技術仕様チェックリスト（解像度 / フレームレート / カラー / ビットレート / オーディオトラック / 尺 / 命名）
• 06/02 コンテンツおよびコンプライアンスレビュー（事実、センシティブコンテンツ、禁止されている広告主張、権利文書）
• 06/03 テーブルA～G記入テンプレート（アーカイブ用）

QC重大度: ブロッキング（黒フレーム、オーディオトラック欠落、ラウドネス許容範囲外、侵害リスク）は修正必須。改善項目はログ記録後に出荷可能。提案項目は次バージョンを待つ。

M6 フィードバックループ: 1回のヒット動画はルールを変更しない

実際のフィードバック（完了率、コンバージョン、クライアントノート）が届いたら、08/05 に従ってエラー帰属を行い、08/case-library/<CASE-ID>/self-improvement-record.md に書き込む。

ハードルール: 単一のケースは候補のみを生成する。変更は、同じ方向のサンプルが5つ以上、凍結された回帰セット、人間の承認、バージョニング、カナリアリリースの後にのみ有効になる。自己改善エンジンは、素材説明カードのE1/E2客観フィールドを自動的に書き換えてはならない — キャッシュは1つのエラーを後のすべてのトピックに広め、ヒット記録は依然として正常に見えるからです。

トリガー時の最短パス

ユーザーが言う	これを行う
「このバイラル動画のスタイルで何かカットして」	フルM2フロー → S6確認ゲート。カットを開始してはならない
「この動画を編集して」	M0 プラットフォーム/尺/商用を質問 → M1 素材 → M3 計画
「この素材は使える？何が映ってる？」	M1 lookup。HITなら即答、MISSの場合のみ分析
「字幕を追加して」	03/01 レイアウト + 03/03 文字起こしとアラインメント。読み取り速度と最小尺を確認
「ナレーションが変だ」	02/01 録音 → 02/02 処理チェーン → ラウドネス測定
「抖音 / WeChat Channels / Bilibili 用に書き出して」	04/01 プラットフォーム仕様 + 06/01 納品チェック
「この編集は著作権侵害になる？」	05/02 決定木 + 08/02 のG次元。リスクレベルを提示するが、確定した法的意見は提示しない
「完成したカットは大丈夫？」	qc_scan.sh + 06/01 / 06/02 を項目ごとに

スクリプト

スクリプト	目的	依存関係
scripts/material_cache.py	素材フィンガープリント、キャッシュルックアップ、登録、再利用、バリデーション、統計（8サブコマンド）	Python 3、サードパーティパッケージ不要
scripts/reference_probe.sh	参照ファイルまたは素材ファイルの客観的プローブ: カットポイント、ショット長、ラウドネス、無音、色、コンタクトシート	bash + ffmpeg/ffprobe
scripts/qc_scan.sh	完成ファイルの技術的QC: 仕様、デコード、黒フレーム、フリーズ、無音、ラウドネス、コンタクトシート	bash + ffmpeg/ffprobe

まず環境を確認: ffmpeg -version && ffprobe -version && python --version。ffmpegがないと、すべての客観的測定が利用できません — その場合は、手動評価のみ可能で再現可能な指標は提供できないことをユーザーに明確に伝えてください。数値をでっち上げてはいけません。

納品前セルフチェック

• 参照動画がS1～S6を通過し、ユーザーが確認済み（参照動画を使用した場合）
• すべての素材がキャッシュ内で出典と権利状態にトレース可能
• 「スムーズ」「プレミアム」「テクスチャード」のようなサポートされていないフレーズが評価または計画に登場しない
• ラウドネスが測定され、ターゲット許容範囲内; True Peakが制限以下
• 字幕が安全領域をはみ出しておらず、誤字がなく、読み取り速度制限を満たしている
• qc_scan.sh がブロッキング項目を報告せず、テーブルA～Gが記入済み
• 音楽 / フォント / 肖像 / ストック素材の権利文書が完全、またはリスクレベルが明記されている
• 納品ファイルの命名、コンテナ、ビットレートがプラットフォーム要件に一致している

資料の範囲（ユーザーに伝える必要あり）

• 法律関連ボリュームは法的助言ではありません。 記事や司法判断は変更される可能性があります。商業目的または高リスクプロジェクトの場合は、弁護士にレビューを依頼し、最新の公式テキストに依存してください。
• プラットフォームパラメータは変更されます。 尺、ビットレート、安全領域、ラウドネスターゲットはソース間で矛盾するため、「プラットフォームの最新の公式ドキュメントに従う」と常にマークされています。納品前にアップロードしてプレビューし、確認してください。
• 自己改善パラメータには業界標準がありません。 ボリューム 08 のη、δ、N_minなどは、このライブラリ独自の初期値です。これらはプロセスを実行可能にするために存在しており、検証された最適値だからではありません。
• 約190の「TO VERIFY（要検証）」項目 が各文書の本文または末尾にリスト化されており、references/00-overview/sources-and-reliability.md に集中しています（A/B/C/DのエビデンスグレードとP0/P1/P2の優先順位付き）。何かを引用する前に、そのファイルのエビデンスグレードを確認してください。

ルーティングとインデックス

• references/INDEX.md — ステージまたはタスクごとの最短パスと最小限の必要読書量
• references/00-overview/knowledge-map.md — 完全な能力領域マッピングとトラブルシューティングのクイックルックアップ
• references/00-overview/sources-and-reliability.md — エビデンスグレード、ソースリスト、TO VERIFY項目
• references/00-overview/manifest.csv — 機械可読ファイルインデックス

大きなファイルを検索する場合は、最初から最後まで読むのではなく、キーワードで位置を特定してください（例: grep -n "LUFS" references/02-audio-and-voice/02-audio-post-and-mixing.md）。