mcpField
V
video-edit-cli

video-edit-cli

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

video-edit-cli について

video-edit-cli は動画編集向けのコマンドライン作業環境です。素材の確認、編集計画の作成、決定的な単機能操作によるレンダリングとレビューを案内します。元のメディアを保持し、派生ファイルには provenance sidecar を残す運用です。

主な機能

  1. 01メタデータ、文字起こし、フレーム、波形による素材確認
  2. 02編集計画の作成と検証、プレビューのレンダリング
  3. 03カット境界の確認と不具合の修正
  4. 04出力検証と視聴覚レビュー
  5. 05派生ファイルへの provenance sidecar の保持

活用シーン

  1. 01会話素材を確認してから編集を計画
  2. 02縦型・短尺動画の制作と境界レビュー
  3. 03音声修復やマスタリングの成果物作成
  4. 04字幕や素材を含む納品パッケージの作成

インストール

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

$npx skills add https://github.com/computerlovetech/video-edit-cli --skill video-edit-cli

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

同梱ファイル

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

agents/
openai.yaml
references/
audio-restoration.md
cut-review.md
edit-plan.md
multicamera.md
subtitles-and-assets.md
transcription.md
vertical-video.md
workspace.md

詳細

あなたがエディターであり、video-edit-cli CLI は作業台です。標準出力に 1 つの JSON 結果を出力する、単機能で決定論的なプリミティブを提供します。編集方針は自分で立てます。何を残すか、削除するか、強調するかを決めるコマンドはありません。

正式なコマンド一覧は video-edit-cli --help（および各サブコマンドの --help）で確認してください。このリポジトリ内では uv run video-edit-cli … として実行します。 video-edit-cli が PATH にない場合は、先に uv tool install video-edit-cli でインストールしてください（Apple Silicon での文字起こしの場合は uv tool install 'video-edit-cli[mlx]'）。ffmpeg と ffprobe は別途インストールしておく必要があります。

不変条件（すべてのタスクで遵守）

  • 元のメディアは変更しません。オリジナルを上書き、インプレースで再エンコード、または削除しないでください。派生ファイルはすべて新規作成し、*.provenance.json サイドカーを保持します。
  • 編集前に根拠を確認します。メタデータ、トランスクリプト、フレーム、波形、またはプレビューで確認していない範囲には手を加えないでください。
  • レンダリング前に検証します。編集内容に大きな変更がある場合は、マスタリング前にプレビューします。
  • 必要十分な範囲で、最も低コストの根拠を優先します。会話の場合はまず probe とトランスクリプトを確認し、判断に必要な場合にのみ、対象を絞って映像や音声を確認します。

手順

  1. 成果物を確認します。 求められている納品物と、存在するメディアを言い直します。求められている出力と、関係するすべてのソースファイルを特定できたら完了です。
  2. ワークフローの事前確認を行います。 video-edit-cli doctor --workflow base を実行します。該当する機能を使う場合は、transcription、vertical-captioned、または audio-restoration を使用してください。 高コストの処理を行う前に、失敗した依存関係チェックを解決します。
  3. ワークスペースを設定します。 references/workspace.md を読み、選択したプロジェクトパスを伝えてから、該当する既存プロジェクトを再利用するか、video-edit-cli workspace init を実行します。ユーザーが別の場所を指定していない場合は、<project-root>/video-edit-projects/YYYY-MM-DD-<source-id-or-slug>/edit/ を既定の場所とします。workspace.json にすべてのソースとそのハッシュが記載されていれば完了です。
  4. メディアを確認します。 すべてのソースに対して probe を実行し、判断に応じて音声、プロキシ、フレーム、フィルムストリップ、波形、または範囲プレビューを取得します。会話を含むメディアの場合は、references/transcription.md を読み、先に文字起こしを行います。これから立てる計画を根拠をもって説明できる程度に、各ソースの長さ、ストリーム、内容を把握したら完了です。
  5. 計画を立ててレンダリングします。 計画を作成または変更する前に references/edit-plan.md を読みます。計画を自分で作成して検証し、プレビューをレンダリングします。検証済みの計画がレンダリングされ、マニフェストが存在すれば完了です。
  6. 確認して修正します。 references/cut-review.md を読み、作成したレンダリングのすべての境界を確認します。各カットに問題がないか、問題が修正されているか、または明示的に報告されていれば完了です。
  7. 納品物を仕上げます。 求められているすべての出力が技術的な検証と、必要な映像面・編集面のレビューに合格したら完了です。output validate は画角や編集品質を検査しません。これらのレビュー結果は別途報告してください。

条件に応じて参照する項目

コメント

Markdown 対応