動画圧縮とアーカイブ
ユーザー自身のローカル AI 環境を使用して動画圧縮を完了します。まず環境を確認し、素材を分析し、目的を尋ね、パラメータを推奨し、サンプルを提供します。ユーザーから具体的なサンプルとバッチ範囲の確認を得た後にバッチ実行し、アーカイブ方法を案内します。「自動検証が通った」ことをユーザーが画質を承認したと表現しないでください。
付属スクリプトは Python 3.9+ 標準ライブラリ、FFmpeg、ffprobe のみに依存します。初版は主に macOS を対象とします。実行には POSIX ファイルロックが必要です。通常のチャットツールでローカルファイルの読み書きやコマンド実行ができない場合は、ガイダンスのみ提供し、動画を処理したと宣言してはいけません。スクリプトはモデルの API キーを必要とせず、素材をアップロードしません。
エントリとタスクディレクトリ
- このスキルの絶対パスを見つけてください。以下、
<スクリプト>はscripts/workflow.pyの絶対パスを指し、<タスク>はユーザーのマシン上に新しく作成する独立したタスクディレクトリです。結果をインストール済みのスキルパッケージに書き戻さないでください。 - ユーザーの元の素材ディレクトリの外にタスクディレクトリを作成します。各バッチタスクは、リスト、計画、サンプル、確認、ステータスを独立して保存します。新しい素材や変更があった場合は別のタスクを作成し、開始済みのバッチは元の計画を維持します。
- ユーザーから明確な指示と既に与えられた許可は、このスキルのデフォルトの提案よりも優先されます。既に確定した目標、パス、選択肢について繰り返し質問しないでください。ユーザーの要求がスクリプトのサポート範囲を超える場合は、制限を説明し、個別の対応を準備します。スクリプトを密かに変更したり、品質を落としたりしないでください。
1. 環境確認とインストール手順
まずターミナルが Python を見つけられることを確認し、次に python3 "<スクリプト>" doctor を実行します。Python のバージョン、FFmpeg、ffprobe、libx265/libx264、および必要なオプションを確認します。不足がある場合は environment.md を読み、何が不足しているか、インストール方法、および影響を説明します。ユーザーが既にインストールを要求している場合は、その範囲で実行します。そうでない場合は、具体的なコマンドを提供し、ユーザーに実行方法を選択してもらいます。不足しているツールを「ビデオなし」と誤って報告しないでください。インストール後、使用可能になるまで再確認します。
2. 読み取り専用の素材分析
ソースディレクトリと出力ディレクトリを確認し、init、scan を実行します。コマンドは operations.md を参照してください。スキャンはメディアのメタデータを読み取り専用で読み取り、エンコードを開始しません。ユーザーに数、サイズ、長さ、解像度/フレームレート、色深度、カラータグ、オーディオトラック、主要なプロファイルを報告し、読み取れないファイルや確認が必要なファイルを個別にリストアップします。
BT.709 タグは撮影モードを証明するものではなく、Log を除外するものでもありません。ユーザーから提供された撮影情報と組み合わせて判断します。初版の実行部は、BT.709 タグが完全な H.264/HEVC、4:2:0、8/10 ビット素材のみを自動処理します。HLG/PQ/HDR、字幕、複数のメインビデオストリーム、不明な色は REVIEW として個別にリストアップし、自動的に SDR に変換しません。既知の Log 素材は個別に処理し、ユーザーに色の正確性を保証しません。
3. 使用目的の確認
まずスキャン結果を説明し、次にまだ不明確で、かつ計画を変更する質問のみを行います:主な用途(家庭視聴/長期保存/編集継続/共有)、画質と容量の優先順位、許容できる処理時間、再生デバイスやファイルサイズの制限。通常は1回の短い質問にまとめます。ユーザーに関連のないパラメータ表を記入させないでください。
アーカイブと同時に2つの選択肢を説明します:原盤を元の場所に残す、または成功して再確認した後、元の親ディレクトリ内の指定サブディレクトリに移動する。デフォルトは keep で、移動にはユーザーの明示的な選択が必要です。原盤を削除する機能は提供しません。この選択を先に確定し、その後サンプル設定を生成します。
4. 比較可能なプランの推奨
quality.md に従って、ユーザーの目標を実際の素材に結び付けます。コーデック、preset、2~3 個の候補 CRF、保持するパラメータ、期待されるトレードオフ、不確実性を説明します。CRF22 や特定のカメラ、特定のディレクトリを全ユーザーの固定ルールにしないでください。
タスク内に plan.json を作成します。フォーマットは operations.md を参照してください。ユーザーの目標と推奨理由を保存します。今回明確に処理する意図があるプロファイルのみを選択し、選択した各プロファイルには少なくとも1つのサンプルを用意します。動き、テクスチャ、暗部などの代表的なセグメントを選びます。メタデータでシーンを識別できない場合は説明し、ユーザーに重点シーンを指定してもらうか、視聴を手伝ってもらいます。素材の種類が多い場合は、バッチごとに範囲を絞ります。
デフォルトで解像度、フレームレート、アスペクト比、向き、色深度、既知のカラーメタデータを維持し、すべてのオーディオトラックをコピーします。スクリプトはメインビデオとオーディオトラックのみをコピーし、補助データトラック/カバーアートは圧縮コピーに含まれません。これをプランで説明します。リサイズ、グレーディング、HDR 変換、オーディオ再エンコード、ハードウェアエンコード、厳密なターゲットサイズ、編集用中間フォーマットは、初版の自動実行範囲外です。
5. サンプルと目視確認
sample を実行し、sample-report.md、reference、および各候補のローカルパスを表示します。すべての候補は同じリファレンスセグメントからエンコードされます。容量と所要時間を説明し、詳細、動き、暗部、グラデーション、音声と映像の同期、実際の再生デバイスで比較視聴する方法を案内します。キーフレームカットにより、長さがわずかにずれる可能性があります。
ユーザーが特定の候補を明示的に承認するまで、approve、run、start を実行しないでください。ユーザーが満足しない場合は、計画を調整し、サンプルを再作成し、結論を収集します。「要件に合っている」と推測しないでください。スクリプトの PASS は構造チェックであり、フレーム単位の品質証明ではありません。
6. 確認後のバッチ実行
plan --crf N の範囲と出力マッピング、選択された CRF、アーカイブ戦略、推定時間/容量のサンプルベースの根拠を表示します。ユーザーが実行可能であることを確認し、このバッチの実行に同意したら、approve で実際のユーザーの応答を記録します。これらの事項をすでにカバーしている応答については、再度質問する必要はありません。確認記録はコンテキストを復元できますが、応答が実在の人物からのものであることをスクリプトが証明できるわけではありません。
start を呼び出した後、status とログで実際の実行を確認します。バッチは個々の FFmpeg を順次処理します。現在のファイルのエンコード、検証、アーカイブが完了した後にのみ安全に一時停止できます。pause を使用します。プロセスを強制終了して一時停止しないでください。resume で一時停止リクエストをクリアし、コントローラが終了した後に start します。既にコントローラが実行中の場合は開始しません。長時間のタスクのために AI で高頻度のポーリングを維持しないでください。ユーザーが後で通知を要求した場合にのみ、その AI システムが提供する通知/スケジューリング機能を使用します。
パラメータ、パス、範囲、またはサンプルの変更により、古い確認は無効になります。開始済みのタスクは元の計画に従って再開し、変更があった場合は別のタスクを作成します。失敗した項目と確認待ちの項目は個別に報告します。ブレークポイントからの再開はファイル単位で行われ、未完了のビデオは先頭からエンコードされます。
7. 検証とアーカイブの引き渡し
archival.md に従って、圧縮バージョン、原盤、タスク記録の対応関係を説明します。完了/スキップ/確認待ち、圧縮コピーのサイズ差、原盤の現在地、復元方法をまとめます。レポート内の圧縮率は、実際に解放される容量と等しくありません。原盤は依然として保持され、現在のプロセスによるディスク使用量は通常増加します。
原盤や既存の出力を上書きしません。未検証の一時ファイルは成果物として引き渡しません。自動検証は ffprobe、size/mtime に基づいており、コンテンツハッシュや全フレームデコードによる検出ではありません。ユーザーがより厳格な検証やバックアップを必要とする場合は、そのための手順を別途設計します。ディレクトリを移動することはバックアップではありません。タスクディレクトリは保持し、ユーザーや別の AI が結果を復元および解釈できるようにします。