mcpField
N
net-new-video-editor

net-new-video-editor

github.com/ericosiuクリエイティブ・メディア3.7k40 回インストール5 週間前に更新
リポジトリ

net-new-video-editor について

新しい録画素材から、後から変更できる初稿を作る動画編集スキルです。編集上の判断をJSONに保存し、同梱スクリプトでレンダリングします。編集プランを検証し、9:16のMP4草稿とQA資料を生成します。

主な機能

  1. 01録画素材とプロジェクト入力の確認
  2. 02タイムスタンプ付きJSON編集プラン
  3. 03カットと主張範囲の検証
  4. 04縦型H.264/AAC動画のレンダリング
  5. 05QAフレームとレポートの生成
  6. 06素材の保持と版の比較

活用シーン

  1. 01提供された録画素材から初稿を編集
  2. 02字幕とフックカード付き縦型動画の作成
  3. 03同期、クロップ、音声、主張の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ericosiu/ai-marketing-skills --skill net-new-video-editor

インストール後、Claude Code で/net-new-video-editorを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

requirements.txt
agents/
openai.yaml
references/
project-contract.md
scripts/
net_new_video_editor.py

詳細

新規動画編集

新しい録画素材から、元に戻せる初回編集を作成します。クリエイティブ上の判断は JSON にまとめ、ピクセル操作は同梱のレンダラーで行います。

前文

任意の共有テレメトリヘルパーがある場合は、リポジトリのルートから実行します。

python3 telemetry/version_check.py 2>/dev/null || true
python3 telemetry/telemetry_init.py 2>/dev/null || true

リモートテレメトリはオプトイン方式であり、コンテンツ、ファイルパス、リポジトリ名、認証情報は一切含まれません。

パッケージの準備

references/project-contract.md を読みます。該当する録画素材、トランスクリプト、アイデアカードまたはブリーフ、証拠素材、画面録画を特定します。別の録画、ブランド、アカウント、素材ライブラリで代用してはいけません。

出力先が明確な場合に限り、新しいプロジェクトを初期化します。

python3 scripts/net_new_video_editor.py init --project <project-dir>

ユーザーが使用を許可した入力のみを、生成されたパッケージにコピーするか、参照先として指定します。オリジナルは保持します。

編集前の確認

次を実行します。

python3 scripts/net_new_video_editor.py inspect --project <project-dir>

intake-report.json を確認します。パッケージに再生可能なテイクがない場合、要求されたターゲットが提供された映像素材と一致しない場合、または必要な外部素材が不足している場合は、作業を中止します。

編集プランの作成

トランスクリプトとブリーフを使って、edit-plan-clean.json を作成します。話されたフックと主張の境界を正確な基準として扱います。

  • 使用するソーステイクを明示的に選択します。
  • セグメントの順序に意図を持たせ、タイムスタンプをソースの長さの範囲内に収めます。
  • カットが自然に保たれる場合に限り、明らかな言い直し、長い無音、単独のフィラーを取り除きます。
  • 意味の理解に役立つ息継ぎは残します。
  • フックの画面表示は最大 5 秒にします。
  • 字幕は短く読みやすいフレーズにします。
  • 証拠素材や画面挿入は、提供されていて関連性がある場合にのみ追加します。同梱のレンダラーは基本的な編集を行います。複雑なオーバーレイは、別途ドキュメント化した工程で追加します。
  • 音声をクリッピングさせずに正規化します。

2 つ目のバージョンを作る場合は、プランを edit-plan-aggressive.json にコピーし、明示した視聴維持率向上の編集のみを加えます。事実に関する主張を黙って変更してはいけません。

各プランを検証します。

python3 scripts/net_new_video_editor.py validate --project <project-dir> --plan <plan.json>

再現性のあるレンダリング

このスキルのディレクトリからレンダラーを実行します。

python3 scripts/net_new_video_editor.py render \
  --project <project-dir> \
  --plan <plan.json>

レンダラーは、音声と映像を対応させてトリミングし、選択したセグメントを連結して、中央を安全範囲とする 9:16 のフレームを作成します。また、Pillow で字幕とフックカードをラスタライズし、FFmpeg で合成して音声を正規化し、H.264/AAC の MP4 を書き出します。さらに、QA フレーム 3 枚と qa-report.json を作成します。

FFmpeg コマンドを確認するには --dry-run を使います。対象の派生書き出しファイルを置き換える意図がある場合に限り、--force を使います。

出力の確認

書き出された MP4、3 枚すべての QA フレーム、qa-report.json、および各バージョン間のプランの差分を確認します。次の点を検証します。

  • すべてのカットの後で、音声と口の動きの同期が保たれている。
  • 単語の冒頭や末尾が不自然に途切れていない。
  • 字幕が発話と一致し、安全マージン内に収まっている。
  • クロップ後も話者が見える。
  • フックが読みやすく、動画内でその期待に応えている。
  • 音量が一定で、ピークによる歪みがない。
  • すべての証拠素材と数値に関する主張に、提供された出典がある。
  • ブリーフで別の形式が求められていない限り、書き出し形式が 1080x1920 H.264/AAC である。

プラン、書き出し先のパス、QA の証拠、および必要な追加撮影素材を提出します。現在の明示的な承認なしに、公開、アップロード、オリジナルの削除、承認済みマスターの上書きを行ってはいけません。

完了状態

  • DONE：レンダリングと QA の両方に合格し、レビュー用成果物がそろっています。
  • DONE_WITH_CONCERNS：ドラフトは使用可能ですが、明示されたクリエイティブ上またはソース上の懸念が残っています。
  • NEEDS_CONTEXT：テイク、トランスクリプト、ブリーフ、または承認済み素材が不足しています。
  • BLOCKED：FFmpeg、ソースへのアクセス、または形式の検証に問題があり、安全にレンダリングできません。

コメント

Markdown 対応