100x-video-reverse

100X Video Reverse v2.3

参考動画を、ユーザーが直接確認でき、下流の生成 Skill が利用できる標準的なリバースエンジニアリングパッケージに変換します。デフォルトでは分析と検証のみを行い、有料の生成処理は呼び出さず、元動画をアップロードせず、素材も公開しません。

開始前

1. ユーザーが提供した動画が読み取り可能であり、利用許諾の範囲が明確であることを確認します。ユーザーが出力先ディレクトリを指定していない場合は、現在のワークスペースの outputs/100x-video-reverse/<video-stem>-<timestamp>/ をそのまま使用し、ディレクトリ選択について追加で質問しません。常にソースファイルは読み取り専用とし、新しい独立したディレクトリに出力します。
2. 必ず workflow.md、output-contract.md、native-output.md を読みます。モデル分析を行う場合は、さらに analysis-prompt.md を読みます。商用コピー、密な編集、外部アップロード、または生成工程に渡す準備に関わる場合は、failure-gates.md を読みます。この Skill の評価、置き換え、アップグレードを行う場合に限り、golden-baseline.md を読みます。デフォルトの成果物は scripts/digest.py が機械パッケージから決定論的に生成します。Agent が手作業でクリップを並べ替えてはいけません。
3. ffmpeg、ffprobe、Python jsonschema、ローカルの読み書き権限を確認します。jsonschema がない場合、バリデーターは必ず停止しなければなりません。依存関係の追加は隔離環境内でのみ行い、グローバルにはインストールしません。外部モデルを呼び出す前に、公式モデル一覧と入力制限をその都度確認します。ユーザーが指定したモデルを優先します。確認できない場合は外部呼び出しを停止しますが、ローカルのエビデンスパッケージの作成は続行します。

実行フロー

1. scripts/prepare_evidence.py を使用して、ソースファイルのフィンガープリント、仕様、二重閾値によるカット候補、密なフレーム列、独立した音声トラックを作成します。自動カットは診断シグナルにすぎず、実際のショット境界ではありません。
2. 動画全体とエビデンスパッケージを同時に確認し、現在の Agent が利用できるローカルのメディア理解機能を優先します。ユーザーに追加の API 設定を求めません。現在のタスクで外部の意味解析が明確に許可されている場合に限り、金標準で使用した Google 公式の gemini-3.7-flash を引き続き使用できます。呼び出し前に公式モデル一覧で実際の ID と動画入力機能を確認します。使用できない場合は元のエラーを保持して外部工程を停止し、旧モデルへ黙って切り替えてはいけません。references/analysis-prompt.md に従ってショットのタイムラインを調整し、観察できる事実、推論、不明点を区別します。固定間隔で意味的なショット分割を代用してはいけません。
3. 安定したアセット ID とショット間で一貫性を保つためのアンカーを作成し、人物、商品、シーン、小道具、衣装、音声、テキストを網羅します。判読できない、または聞き取れないブランド名、価格、効能、台詞、画面上の文字を補ってはいけません。
4. 完全な reverse.json を生成します。ショット、4 種類のキーフレーム、アセット参照、音声／字幕、汎用プロンプト、モデル適応プロンプト、セグメント構成、結合説明、must_not_change を含めます。各セグメントには execution_plan も含めます。目標時間、生成状態、選定モデル、生成方式、入力素材を記載します。モデル機能をその場で確認していない場合は、明確に needs_model_selection と記載し、実行可能であるかのように装ってはいけません。
5. scripts/materialize_reverse_media.py を使用して、ショットフレームとアセットのスクリーンショットをパッケージ内の相対パスに実体化し、materialization_manifest.json を生成します。既存のメディアを再利用できるのは、ソース SHA-256、リクエストのタイムスタンプ、ファイル SHA-256 のすべてが provenance と一致する場合に限ります。一致しない場合は必ず停止し、上書きしてはいけません。
6. scripts/validate_reverse_package.py で、メディアと契約を事前検証します。ハードエラーは続行前に修正しなければなりません。警告は残して説明し、合格に変更してはいけません。
7. 厳密な検証に合格した後、scripts/digest.py を実行し、native-output.md に従ってそのまま納品します。Codex では --format fragment --fragment-dir <本轮 thread 可视化目录> を使用します。最初のタブには、左側に細い 9:16 プレーヤー、右側にセグメント素材ボードを表示します。各セグメントには、先頭フレーム／ハイライトフレーム／末尾フレームを同じグループ内に固定表示します。画像はドラッグして JPEG プレビューを取得でき、元画像が必要な場合はパッケージ内の元フレームのパスをコピーします。「ショット位置」はショットごとの連動を維持します。3 枚のフレームまたはショットのいずれかをクリックすると動画が一時停止して該当位置に移動し、最初に中国語の操作説明を表示してから、該当セグメントの英語生成プロンプトを表示します。狭い画面では縦並びに変更しますが、3 枚のフレームは引き続き同じグループにまとめます。その他のクライアントではデフォルトで --format md を使用します。クライアントの機能を判断できない場合は、インラインプロトコルに賭けてはいけません。

ユーザーから視聴後のフィードバックがあった場合は、各フィードバックを具体的なショット、アセット、またはプロンプトのフィールドに対応付け、「ユーザーの好み／修正」と明記します。元動画の観察事実に書き戻してはいけません。新しい修正版パッケージを作成し、影響を受けるフィールドとメディアのみを変更してから、完全に検証します。前の版を上書きしてはいけません。

コマンド

python <skill-root>\scripts\prepare_evidence.py --video <source.mp4> --out <new-package-dir>
python <skill-root>\scripts\materialize_reverse_media.py --video <source.mp4> --package <new-package-dir>\reverse.json --source-manifest <new-package-dir>\source_manifest.json
python <skill-root>\scripts\validate_reverse_package.py --package <new-package-dir>\reverse.json --source-manifest <new-package-dir>\source_manifest.json --require-media --report <new-package-dir>\validation.json
python <skill-root>\scripts\digest.py --package <new-package-dir> --format md
# Codex 内联；多包时改用 --out-root，自动生成 1 个批次总览 + N 个独立详情
python <skill-root>\scripts\digest.py --out-root <batch-root> --format fragment --fragment-dir <thread-visualization-dir>

<new-package-dir> は存在しないか、空でなければなりません。--out をソース動画のディレクトリに指定してはいけません。

決して越えてはならない境界

• リバースエンジニアリングパッケージの検証合格が示すのは、構造、エビデンス、参照が実行可能であることだけです。最終動画の視覚的な類似度が十分であることを意味しません。
• この Skill 内で生成、生成の再試行、後処理、採点を行いません。これらは独立した Skill が本出力契約を利用して行う必要があります。
• Agent のネイティブ返信は reverse.json とパッケージ内メディアの表示レイヤーにすぎず、第二の業務上の正本ではありません。修正する場合は、まず機械パッケージを変更してから現在の返信を更新します。
• ショットをクリックして表示するのは、そのショットが属する生成セグメントのプロンプトです。機械契約における生成単位はセグメントであり、ショットごとの独立したプロンプトが存在するかのように偽ってはいけません。
• デフォルトで表示する運用ラベル、状態、アセットカテゴリ、生成方式は中国語にします。モデル ID、素材 ID、逐語的なエビデンス、英語の生成プロンプトは元の値を維持します。過去のパッケージで人間向けのフィールドが英語の場合、原文を保持してその旨を示すことしかできません。digest が翻訳を捏造してはいけません。
• 現在のベンダーの制限を理由に、「固定 10 秒のクリップ」をショットの真実として記載してはいけません。実際のショットと物語上の境界に基づいてセグメント化することを優先します。バリデーターの 10 秒は、設定可能な下流互換性の警告にすぎません。
• 明確な許可がない限り、ローカル動画を公開 URL、オブジェクトストレージ、第三者サービスにアップロードしてはいけません。
• ライセンスが不明、または用途が異なる候補コードをコピーしてはいけません。同じサンプルで検証済みの手法と失敗から得た知見のみを取り入れます。

完了基準

完了時には、source_manifest.json、evidence/evidence_manifest.json、エビデンスメディア、reverse.json、materialization_manifest.json、validation.json が存在しなければなりません。厳密なメディア検証でハードエラーが 0 件である必要があります。Codex fragment の最初のタブには、全時間をプレビューできる表示が必須です。デスクトップでは、左側に細いプレーヤー列、右側に幅の広いセグメント素材ボードを表示し、各セグメントには先頭／ハイライト／末尾の 3 つのスロットを固定して同じグループに保ちます。素材がない場合はエラースロットを表示します。3 枚のフレームをドラッグすると、少なくとも利用可能な JPEG ファイルが生成され、元画像はパッケージ内のパスをコピーして取得できます。3 枚のフレームまたはショットをクリックして位置を移動し、該当するセグメントのプロンプトを確認できなければなりません。デフォルトの運用レイヤーは中国語とし、英語のプロンプトは必要に応じて展開します。その後に残りの 5 つのセクションを展開します。複数のパッケージがある場合は、まず簡潔なバッチ概要を提示し、続いて番号順に各項目の詳細を個別に示します。失敗した項目を省略してはいけません。本文には機械パッケージのパスも記載しなければなりません。--legacy-unverified-media は過去のパッケージの監査に限り使用でき、新規の引き継ぎには使用できません。

既知の制限

• fragment 内の「原動画」は、予算内で作成した全時間分の低ビットレート H.264/AAC 表示用コピーであり、2 つ目のソースファイルではありません。元のパスと SHA-256 は引き続き source_manifest.json を正とします。1 つのクリップにつき上限は 1 MB です。収まらない場合はフレーム画像に明示的に切り替え、動画を途中で切り詰めてはいけません。
• fragment から直接ドラッグできるのは、予算内の JPEG プレビュー派生画像であり、パッケージ内の元フレームではありません。ドラッグではブラウザー File、Chromium DownloadURL、data URI、元フレームのパスをあわせて提供します。対象アプリが対応するドラッグ＆ドロップ形式を受け入れるかどうかは、そのアプリ側の判断に委ねられます。元画像を劣化なく取得するには「元フレームのパスをコピー」を使用します。
• Claude Code Artifact のパスは実際のホスト環境でまだ検証されていません。レンダリングを確認できない場合は --format md に戻します。