mcpField
E
edit-timeline-studio

edit-timeline-studio

github.com/martindelophyクリエイティブ・メディア912120 回インストール1 日前に更新
リポジトリ

edit-timeline-studio について

Timeline Studio で編集可能なタイムラインを基準に、取り消し可能な編集を行うためのスキルです。ローカルプロジェクトの手順や検証に加え、ネイティブブラウザーや MCP の利用方法も扱います。

主な機能

  1. 01編集前のメディアと状態の確認
  2. 02バージョン付き編集の計画と検証
  3. 03適用前の意味的差分の確認
  4. 04変更したメディアのレンダリングと検証
  5. 05編集可能なプロジェクトアーカイブの保持

活用シーン

  1. 01ローカルプロジェクトへの正確な編集
  2. 02マーカーやチャプターキューの追加
  3. 03参照動画の編集スタイルの再現
  4. 04自動編集の作成と検証

MCP 対応

利用可能な場合、Timeline Studio に同梱された MCP ツールでプロジェクトを確認・編集します。`timeline_project_apply` の前に、同じリビジョンと操作で `timeline_project_diff` を呼び出す必要があります。

インストール

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

$npx skills add https://github.com/martindelophy/ai-video-editor --skill edit-timeline-studio

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

同梱ファイル

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

host-python-requirements.txt
host-requirements.json
README.md
.claude-plugin/
plugin.json
agents/
openai.yaml
docs/
agent-video-editing.md
claude-code-video-editing.md
codex-video-editing.md
command-reference.md
comparison.md
examples.md
gemini-cli-video-editing.md
github-copilot-video-editing.md
mcp/
server.mjs
references/
auto-edit-scenarios.md
auto-edit-workflow.md
browser-workflow.md
command-contract.md
current-capabilities.md
curves-and-subject-effects.md
e2e-evaluation.md
highlight-tension-workflow.md
host-environment.md
local-model-routing.md
material-analysis.md
mcp-integration.md
professional-editing-workflow.md
promotion-narrative-workflow.md
relighting-and-depth-video.md
remote-video-generation.md

詳細

翻訳後に原文が更新されています。最新の内容は原文をご確認ください。

Timeline Studio での AI 動画編集

ユーザーからの正確な編集依頼とメディアを、元に戻せる Timeline Studio の編集に反映します。編集可能なタイムラインを常に信頼できる唯一の情報源とし、不透明な一括レンダリングで置き換えないでください。

実行経路を選ぶ

ユーザーがすでに開いている Timeline Studio プロジェクトで作業している場合、ホストが公開していれば、ネイティブのブラウザー WebMCP ツールを優先してください。references/webmcp-integration.md を読み、ライブ状態を確認し、対応する編集内容全体をプレビューして、セマンティック差分を確認した後、返された previewId を適用します。この経路では表示中のエディターを共有しますが、以下のローカルプロジェクトファイルのワークフローとは異なります。リモート MCP サーバーは追加されず、メディアのアップロードも許可されません。

  1. インストール後、ローカルで初めて使用するときは references/host-environment.md を読みます。Node.js が利用できない場合は、依存関係ゼロの Shell または PowerShell のブートストラップから始めます。それ以外の場合は node scripts/setup-host.mjs --check を実行します。エージェントによる中国語および中国語と英語が混在するナレーションには、Timeline Studio が管理するブラウザー内で動作する Hojo TTS Light 80M の2話者バンドルを使用し、別途 Python によるナレーション機能を必要としません。言語ランタイムや依存関係が不足している場合は、正確なインストール計画を示し、インストールモードに入る前にユーザーの明示的な承認を得てください。Skill のインストールを、ホストの変更やモデルのダウンロードの許可とみなしてはいけません。
  2. 決定論的な編集では、ローカルのプロジェクトファイル処理をデフォルトとします。メディアをローカルで確認し、コマンドレイヤーまたはローカルのアーカイブサービスを通じてポータブルな .timeline を変更し、タスクによってレンダリング済みメディアが変わる場合は、デコード済みの出力をレンダリングして検証します。エディターに UI があるというだけで、ブラウザーを開かないでください。
  3. https://video-editor.ai-creator.top/ は、ユーザーが明示的にウェブサイトの使用を依頼した場合、ローカルリポジトリまたはプロジェクトパスを指定していない場合、またはホスト専用の機能を必要とする場合に限り、正式なホスト版エディターとして扱います。
  4. このリポジトリを利用できる場合は、Agent コマンドレイヤーとローカルのメディアツールを優先してください。ローカルのプロジェクトパイプラインでは実現できないことが確認された UI 専用操作があり、かつユーザーがローカルのみのワークフローを指定していない場合に限り、ローカルサーバーとブラウザーを起動します。プロセスの出力から実際のサーバー URL を読み取り、ポート 5173 を決めつけないでください。
  5. ホストが公開している場合は、同梱の Timeline Studio MCP ツールを優先してください。references/mcp-integration.md を読み、プロジェクトを確認し、必ず timeline_project_apply の前に timeline_project_diff を呼び出します。どちらにも同じリビジョンと操作を指定してください。MCP サーバーはリポジトリのコマンドランナーを介するトランスポートであり、独立した編集実装ではありません。
  6. MCP が利用できない場合は、package.json を確認し、Agent コマンドスクリプトがあるか調べます。機能の有無を確認するために npm run ... --if-present を使わないでください。何も通知せずに成功することがあるためです。コマンドランナーがある場合は references/command-contract.md を読み、プロジェクトを確認し、バージョン付きの計画を作成して構造バリデーターを実行し、project.run の前に信頼できるセマンティックなドライランとして project.diff を使用します。
  7. 必要な操作がローカルのコントラクトにない場合は、不足している内容を正確に伝えます。リポジトリ開発作業では、UI に切り替える前に、共有ローカル操作とレンダラーのサポートを最小限の変更で実装します。それ以外の場合は、ブラウザーのワークフローに切り替える前に確認を求めます。
  8. UI 自動化しか利用できなかった場合は、決定論的または冪等な実行だと主張しないでください。制約を伝え、UI で対応できる場合は編集可能なプロジェクトアーカイブを保持します。

ワークフロー

マーカーのみのリクエストでは、references/timeline-markers.md を読み、アノテーションの引き継ぎまで、確認 → 計画 → 検証 → 差分確認 → 適用 → 再確認のワークフローに従います。マーカー、チャプターの目印、範囲、メモはプロジェクトのアノテーションです。追加にあたって、説明、モデルのダウンロード、ブラウザーセッション、動画のレンダリングは必要ありません。以下のメディア制作手順は、ユーザーがメディア編集も依頼した場合にのみ適用されます。

1. 編集前に確認する
  • ユーザーのプロンプトは、クリエイティブブリーフとして一字一句そのまま保持してください。
  • 参照されているすべての素材を、明示的なパスまたは URL で特定してください。承認なしにディレクトリ全体を走査してはいけません。
  • 尺、寸法、音声の有無、メディアの種類を確認してください。
  • 既存のプロジェクトを変更する前に、現在のプロジェクト概要を読んでください。
  • 長尺動画、チャプター、音楽のビートキュー、レビュー用メモ、編集範囲を計画する前に、references/timeline-markers.md を読んでください。既存の注釈を確認し、編集上の基準点や決定事項を維持するうえで有用な場合は、根拠に基づくマーカーを使用してください。ユーザーの注釈は保持し、エージェントの所見と提供されたフィードバックを区別してください。
  • 未解決の選択肢が編集内容を大きく左右する場合に限って質問してください。たとえば、希望する出力尺やアスペクト比などです。
  • 自動編集の依頼では、references/auto-edit-workflow.md を読んでください。まず素材を確認し、内容、目標、納品形式を明示的な確信度とともに分類してから、編集結果を左右する最小限のカテゴリー別質問だけをしてください。メディアから確認できる事実については質問してはいけません。
  • 参考動画の再現、模倣、再作成、リバースエンジニアリングの依頼では、references/replication-workflow.md を読んでください。editing-style replication、AI-generation replication、またはハイブリッドとして分類してください。作業を始める前に、フィルター、繰り返し、ソースの分割、速度カーブ、トランジション、ショット、タイミングを再構成し、使用許可のあるオリジナル音声トラックを保持する必要があるかを明確に確認してください。再現分析の完全性ゲートを通過するまで、編集を開始してはいけません。生成が必要な場合に限り、AI 動画プラットフォームを比較するために最新のウェブ検索を使用してください。ユーザーから十分な素材が提供されていない場合に限り、適法なウェブ由来の映像素材を使用してください。
  • 動画/画像のリライティングや深度動画への変換では、references/relighting-and-depth-video.md を読んでください。実際のモデル実行には、ブラウザーの prepare/start/inspect/cancel タスク経路を使用してください。レビュー済みの clip.set_relight を通じて照明を編集可能な状態に保ち、生成した深度動画は、明示的なレビューを経て挿入されるまで My assets に置いてください。一般的な深度に関するガイダンスを、実行可能な変換ワークフローとして扱ってはいけません。
  • メディア分析のためにモデルを読み込む、またはダウンロードする前に、references/local-model-routing.md を読んでください。リポジトリに既存のローカル機能と固定済みのミラー機能があるかを調査し、証拠の不足を補うために必要最小限のモデル構成を選んでください。画面に表示されるエディター UI を操作せずにローカルで推論を実行し、使用したモデル、ランタイム、フォールバックの正確な出所情報を記録してください。利用可能なモデルをすべて既定で読み込んだり、キャッシュを重複作成したりしてはいけません。
  • ユーザーがウェブ由来の映像素材を必要としている場合、またはダウンロード可能な素材の入手先を尋ねている場合は、references/web-footage-sourcing.md を読んでください。ライブ検索を行い、タスクに即した最新のプラットフォーム候補を提示してください。提供元の正当性、ダウンロードへの明示的な対応、利用権、映像との適合性、品質、出所情報に基づいて順位付けしてください。スキルは特定の提供元に依存しないものとし、特定のプラットフォームやブランドを恒久的な経路として固定してはいけません。
  • 自動編集を完了したら必ず、references/professional-editing-workflow.md を読んでください。画像は直接分析してください。動画は代表フレーム、音声/OCR、意味内容、全体および被写体領域のオプティカルフローを使って分析してください。トラッキングや画質向上の前に手ブレを補正してください。画像から動画、または画像から画像へのモデルについて質問するのは、確認の結果、生成が実質的に有用だと判断できた場合に限ってください。
  • 動画プランで時間的な強調、ショットに合わせたカラー調整、前景/背景の分離、製品または人物のヒーロー演出、編集可能な被写体輪郭、アイデンティティ置換が有用な場合は、references/curves-and-subject-effects.md を読んでください。ユーザーが操作項目を指定するのを待たず、ショット設計の段階でこれらの機能を検討してください。速度変更の前にソース時間で分析し、意図のあるタイミング変更に限って速度カーブを使用してください。カラー調整ではカラーホイールを使い、肌や製品の同一性を保ちながらルックを整えてください。確認済みのマスクから切り抜きと輪郭を作成してください。フェイススワップには明示的な許可を求めてください。納品前にプレビューとエクスポートの一致、および時間的な安定性を検証してください。
  • リモート生成が実質的に必要な場合は、references/remote-video-generation.md を読んでください。最新の公式ドキュメントを検索し、ショット設計に合うプロバイダーだけを比較してください。有料またはプライバシーに関わるジョブは、実行前に承認を得てください。非同期タスクと出所情報を標準化し、期限切れになる出力データはダウンロードして、検証済みの結果をタイムラインに自動配置せず My assets に追加してください。
  • 製品、ブランド、marketing-commerce、ウェブサイトのプロモーション、その他の販促編集では、references/promotion-narrative-workflow.md を読んでください。機能の羅列や動きのある文字だけのモンタージュではなく、根拠に基づく野心的な包括的ストーリーを積極的に構築してください。ユーザーがティーザーを明示的に希望している場合を除き、問題から変化、証拠、CTA へと展開する完全な流れを作り、見た目に異なる複数の事例(通常は少なくとも3つ)を積極的に見つけてください。それぞれに独自の状況設定、製品の動作、目に見える結果、最終的な効果とのつながりを持たせてください。ストーリーを大きく見せるために、顧客、成果、指標、製品の挙動を捏造してはいけません。
  • 強調や劇的なインパクトが重要なハイライト編集および参考動画の再現では、references/highlight-tension-workflow.md を読んでください。顕著性は候補を示す証拠として扱い、セットアップ、上昇、直前、ピーク、余韻の役割を割り当ててください。平坦ではない緊張感の流れを設計し、決定的なヒーローフレームを守ってください。正確にカットしていても、強く印象づける場面がなければ完成と見なしてはいけません。
  • ウェブサイトのウォークスルーやプロモーション用の画面録画では、対応しているブラウザー操作スキルを使い、収録前に許可された導線を確認してリハーサルしてください。ブラウザーを操作する前に、そのブラウザースキルをすべて読み、その後 references/website-promo-workflow.md に従ってください。製品について結論を出す前に、ページ/導線の網羅性を示すマニフェストを作成し、完成させてください。必要なページにアクセス制限がある場合は、選択したブラウザーでユーザー自身にサインインしてもらってください。認証情報を求めたり、アクセスできない挙動を検証済みとして説明したりしてはいけません。重大な影響を伴う外部操作は別途確認し、サインイン中のデータと個人情報を保護してください。スクリーンショットや静的素材しか利用できない場合に、実際の画面録画を撮影したと主張してはいけません。
  • tutorial-demo、vlog-event、marketing-commerce、narrative-documentary は、デフォルトでナレーションを含むカテゴリーとして扱ってください。必要なストーリーをすでに伝えている場合は、使用許可のあるソース音声を維持して再利用してください。それ以外の場合は、背景、展開、目に見える結果、影響、締めくくりに必要な最小限の完全なナレーションを作成し、映像のタイミングを決める前に合成してください。ユーザーがソース音声のみ、音楽のみ、または無音を明示的に希望していない限り、ナレーションを入れるかどうかは尋ねないでください。言語、キャスティング、主張、納品形式に影響する選択肢だけを尋ねてください。
  • ナレーション付きの編集では、references/voiceover-workflow.md を読んでください。対応言語ではすべて、Timeline Studio が保有し固定しているブラウザー内ローカル音声を優先してください。中国語および中国語と英語が混在するナレーションには、保有する Hojo TTS Light 80M のブラウザーバンドルを使用し、ナレーターまたはキャラクターごとに内蔵の安定した参照プロファイル2種、晴岚 / zh_f_qinglan または 若溪 / zh_f_ruoxi のいずれかを割り当ててください。この経路では Hojo 40M と MeloTTS をインストールまたは使用してはいけません。リモートサービス、オペレーティングシステムの音声、または保有していないランタイムを使ってよいのは、希望する言語または音声がローカルで利用できず、ユーザーがそのフォールバックを明示的に承認した場合に限ります。別の納品方法をユーザーが希望しない限り、利用可能なローカルプロファイルから最も温かみのある自然な語り口の音声を選び、自然な言い回しを大切にした、親しみやすく会話的な演技を指示してください。平坦、金属的、機械的なシステム音声のような効果をデフォルトにしてはいけません。ナレーションは、あとで分割する巨大な一続きの音声ではなく、息継ぎのまとまりごとの短いセグメントとして生成してください。読点は既定の十分な合成境界として扱い、1つの長い文の音声クリップより複数の短いフレーズクリップを優先し、隣り合う音声クリップ間にはデスクトップ/H5 共通の 0.4s の間隔を設けてください。シーンの長さ、動き、トランジション、字幕、映像カットを最終決定する前に、分割済み音声全体の流れを確定してください。映像は実測された音声とポーズに合わせて調整・トリミングし、逆に音声を映像に合わせてはいけません。実行時間は結果の測定値としてのみ扱い、事前に設定された秒数を目標にしたり、追い求めたり、そこに合わせたりしてはいけません。
2. 計画の忠実度を適切に設定する
  • 自動編集では、プロンプトを保持し、推測済み、確認済み、デフォルト設定済み、未解決の判断事項を編集可能なブリーフにまとめます。タイムラインを変更する前に、残す/削除する/短縮する/並べ替える判断、その理由、確信度、キャプションに関する要件、音声の連続性に関する制約、保護対象のコンテンツを含む、ソース時間に基づいた判断記録を作成します。
  • 説明を目的とする製品、チュートリアル、ウェブサイトのビートでは、名前を指定した単一の対象に対し、明示的な注目の演出を選びます。小さな証拠や情報量の多い証拠は拡大し、正確なテキストや数値には下線を引き、コントロール、カード、結果の正確な境界は枠で囲みます。カメラの動きと併用する補助的な演出は最大1つにし、下線や枠はカメラが停止してから適用します。
  • 被写体主体のショットでは、正当化できる最小限の演出を選びます。コンテキストやレイヤーの奥行きを変える場合は切り抜きを使い、コンテキストを取り除かずに注目を集める場合はアウトラインを使います。フェイススワップは、本人の明示的な依頼と許可がある場合に限り、アイデンティティの置き換えに使用します。速度カーブは、装飾として連続的に適用するのではなく、意味のある動作のフェーズや編集上のビートに適用します。リタイミングを行う場合も、解析済みのソース時間の対応関係を保持します。
  • コマンドランナーを使う場合は、安定した ID、秒単位の時間、リビジョン、操作 ID、事前条件を含む宣言型の操作として編集を記述します。scripts/validate_edit_plan.mjs <plan.json> を実行して転送形式のエラーを確認し、続いて npm run agent -- project.diff <plan.json> を実行して、未対応の操作やプロジェクト固有の無効な編集を適用前に却下します。
  • ブラウザー UI のみを使う場合は、ユーザーが行う操作と想定される UI の結果を、順序どおりに記した短いチェックリストを作成します。名前付きコントロールとクリップラベルを優先し、座標を使うのは、最新のスクリーンショットに基づく最後の手段とします。
  • メインの Visuals は連続した状態に保ちます。キャプション、ステッカー、ソース音声、ボイスオーバー、音楽、オーバーレイは、タイミングのあるクリップとして扱います。
  • キャプションから音声への一方向のルールを適用します。プロジェクトでキャプションが設定または有効化されている場合、表示されるすべてのキャプションは、聞き取れる音声に対応している必要があります。文字起こしキャプションは既存の発話ソースクリップにリンクし、新しいナレーション、説明、宣伝、またはテキスト主体のキャプションには、それぞれボイスオーバーを生成します。既存のソース音声の発話でこのルールを満たせる場合、ボイスオーバーを重複して追加してはいけません。キャプションがない場合でも、tutorial-demo、vlog-event、marketing-commerce、narrative-documentary ではナレーションがデフォルトです。他のカテゴリでは、ブリーフで必要とされない限り任意です。設定済みのキャプションに、許可された音声経路がない場合は、そのキャプションを省略するか、編集可能なプロジェクトを保持したまま停止します。
  • ナレーションを含む編集では、短い呼吸のまとまりごとに、最初から物理的なアーカイブ済み音声ファイルを個別に合成し、各キャプションを、対応する audioClipId 1つだけに関連付けます。ナレーション全体を単一のファイルとして合成し、合成後に分割してはいけません。文末の句読点では分割し、デフォルトでは、コンマ、セミコロン、コロン、ダッシュ、またはその他の明確な発話の間でも分割します。ただし、分割すると意味のない断片が生じる場合や、固有名詞、数値、URL、意図されたバイリンガルのフレーズが分断される場合に限り、分割せずにつなげます。自由記述のスクリプト生成では、最初のクリップを明示された再生ヘッドに配置し、後続のクリップはすべて、現在のボイスオーバートラックの末尾に追加します。変更されていない再生ヘッドや 0s を再利用してはいけません。キャプション単位の生成では、そのキャプションを基準に配置します。隣接するナレーションクリップは、デスクトップ/H5 共通のデフォルトである 0.4s の間隔を空けて配置し、確定した音声の並びに基づいてキャプションのタイミングと映像のタイミングを決めます。
  • クリップを移動またはトリミングする際は、メディアの同一性とソース時間の対応関係を保持します。
3. 安全に適用する
  • 破壊的な一括処理の前に、プロジェクトのバージョンを保存するか、.timeline アーカイブを書き出してください。
  • ユーザーに見える意図ごとに、1つのトランザクションを適用してください。前提条件を満たさない場合は、トランザクション全体を失敗させてください。
  • メディア、音声、モデル、フォント、エフェクトが見つからない場合、代替品を黙って使用しないでください。
  • すべての結果を、通常の UI で元に戻せる状態にし、編集可能な状態に保ってください。
  • ユーザーから明確な依頼がない限り、有料またはリモートの生成ジョブを開始しないでください。
  • コマンドプランに output.render を含めたり、project.run が動画をレンダリングすると主張したりしないでください。ドキュメントで定められたポータブルなサブセットには、バージョン管理された別個の project.render リクエストを使用してください。AI 生成やサポートされていないコンポジション機能には、ブラウザーエディターを使用してください。
  • 動画編集の依頼が完了したら、明示的な絶対パスの出力ディレクトリを解決し、その場所にポータブルな .timeline プロジェクトとレンダリング済みの動画の両方を作成してください。プランニング、診断、注釈のみの作業、および明示的にエディターのみへ引き継ぐ場合は例外です。注釈のみを納品する場合は、新たに書き出して内容を確認した .timeline アーカイブが必要です。マーカーを納品するためだけに、変更されていない動画をレンダリングしないでください。
4. 結果を検証する
  • タイムラインの要約を読み直し、指定された順序、トラックへの配置、有効状態と照らし合わせます。ナレーションを含む編集では、最終プロジェクトの長さが以前の実行時間の見積もりではなく、固定された音声の基準に従っていることを確認します。
  • 冒頭、すべてのカットまたはトランジション、キャプションの境界、オーバーレイ、最終フレームをプレビューします。
  • すべての映像、キャプション、音声の境界をまたいでタイムラインを連続再生します。タイムラインの時計は単調に進む必要があります。境界で停止する、逆行する、クリップの末尾が繰り返される、隣接する半開区間のクリップが同時に有効になる場合は却下します。
  • トラックが見えるかどうかだけでなく、実際に聞こえる音も確認します。動画に埋め込まれた音声と、明示的に分離されたソース音声クリップを区別し、ミュート/リンクの状態を検証します。
  • FFmpeg でステレオまたはマルチチャンネル音声を配置する場合、意図したすべてのオフセットをすべてのチャンネルに明示的に適用します。adelay では adelay=<milliseconds>:all=1 を使用するか、チャンネルごとに遅延値を指定します。デフォルトの all=false で単一の値を指定すると、最初のチャンネルだけが遅延し、後続のクリップがすべてもう一方のチャンネルの時刻ゼロに重なることがあります。納品前に、冒頭の区間と予定されているすべての発話境界で、左右のチャンネルの音声を比較します。片方のチャンネルだけで早く発話が始まる状態、ナレーションの複数クリップが冒頭に重なる状態、または文書化されていないチャンネル間の開始時刻のずれがあれば却下します。
  • 表示されるすべてのキャプションが、有効期間全体を通じて、聞き取れる1つの発話クリップに対応していることを検証します。対応する音声のないキャプション、無音のリンク済みクリップ、発話を超えて表示されるキャプション、ソース音声とボイスオーバーの重複、テキストだけのキャプション納品は却下します。
  • Agent が生成した隣接するナレーションクリップが、別々の物理アセットであることを検証します。短いフレーズ単位のブレスグループを使用し、カンマをデフォルトで有効な分割点として扱い、デスクトップ/H5 共通の意図的なタイムライン上の空き時間 0.4s を維持します。冒頭の分離した音声バスを確認し、同じ 0s を共有する、再生ヘッドの位置が変わらないまま生成を繰り返す、または予定開始時刻より前に重なる自由形式スクリプトの生成は却下します。さらに、節が多すぎる長い音声合成、単一のナレーションを範囲ごとに分割しただけのもの、意味のない極小フラグメント、偶発的な重なり、ブレスや語尾の切れ、または採用された発話が自然なリズムから外れるよう強制された映像タイミングも却下します。
  • ナレーション全体を通常の再生速度で聞きます。冷たく機械的な音色、抑揚や強弱の乏しさ、単語ごとの不自然な合成音声、間隔が一律に硬直した間、急ぎすぎのリズム、短すぎる間、不自然な発音、セグメントごとの速度変更、説明のない音量の急変、または目標時間に合わせるためナレーション全体を単純に高速化したものは却下します。ユーザーが別のキャラクターを明示的に希望していない限り、抑制の効いたピッチ変化、フレーズ単位の強調、自然なブレスの間を備えた、温かみのある人間らしい語り口の仕上がりを求めます。フレーズ単位で分けたナレーションでは、すべての処理後に最終ステムを1本ずつ測定します。デフォルトでは、統合ラウドネスを -18 LUFS、最大トゥルーピークを -2 dBTP 以下とし、最も大きいセグメントと最も小さいセグメントの差を 1 LU 以内に抑え、意図的な例外を文書化しない限り、セグメントの LRA を 5 LU 以内に保ちます。プログラム全体のラウドネス測定だけに基づくナレーションミックスは決して受け入れず、短いクリップへの1回だけのノーマライズを一貫性の証明として頼りにしません。
  • 最終書き出しでは、コンテナ、寸法、長さ、デコードされたフレーム、表示されるオーバーレイ/キャプション、実際の音声トラックを検証します。
  • 製品またはワークフローの修正前に生成された成果物は、すべて納品用として古いものとみなします。コードや Skill の編集だけでは結果は再生成されません。影響を受けるフローを新規プロジェクトから再実行し、新しい .timeline と結果動画をそれぞれ別のパスに書き出して、更新日時と SHA-256 ハッシュを記録し、以前の成果物と比較します。修正の証拠として、古いレンダーを提示、再リンク、名前変更、コピーしてはなりません。
  • 自由形式スクリプトによる音声生成を繰り返す場合は、実際の UI で最低3セグメントの回帰テストを実行します。書き出した .timeline を再度開き、初期再生ヘッド位置にセグメントがちょうど1つあること、後続の各開始時刻が、タイムラインの精度内で直前の終了時刻に予定された間隔を加えた値と一致すること、重なりがないことを確認します。次に、レンダリング済み最終音声を同じ境界で確認またはデコードします。プロジェクト構造だけではミックスが正しいことの証明になりません。
  • レビュー用ビルドを以前のレンダーと明確に区別する必要がある場合は、短い検証スレートまたはビルドマーカーを追加し、その旨を明記します。新しい成果物が鮮度、タイムライン、デコード、ハッシュのチェックに合格した後に限り、クリーンな最終版から削除します。
  • .timeline を構造検査だけでなく Timeline Studio で再度開いて検証します。メインの Visuals トラックが表示され、最初のフレームが Preview に描画され、アーカイブ済みメディアが解決され、キャプション/音声/トラックの状態が一致している必要があります。レンダリングされた動画を最後までデコードして検証し、両方の絶対パスを返します。

指示が不明確なリクエストは慎重に解釈する

  • 編集方針の説明がない「試してみて」「開いて」「編集させて」といったリクエストでは、エディターを起動し、明示的に指定されたアセットのみをインポートして、自動配置を確認し、編集可能なワークスペースを開いた状態で引き渡します。
  • トリミング、キャプション、アスペクト比の変更、AI 生成、エクスポートを勝手に追加しないでください。
  • 「自動編集」「整理」「短縮」「ハイライト作成」または同等の表現による明示的なリクエストは、確認済みの編集方針の範囲内で、元に戻せる編集上の判断を行う許可として扱います。重大な影響を及ぼす既定値を伝え、カテゴリ固有のコンテンツを保護し、行った判断を報告してください。このリクエストを単なる引き渡しとして扱わないでください。
  • オンボーディングの完了状態の保持、モデルのダウンロード、リモート生成、破壊的なリセットは、それぞれ別個のユーザー判断として扱ってください。

実際の実行から学ぶ

エディターの評価、リグレッション作業、または摩擦が明らかになった実行では、references/e2e-evaluation.mdを読んでください。自動編集の評価では、references/auto-edit-scenarios.mdも読み、そこに記載された固定カテゴリカード、確認チェック、必須条件、隣接するストレステスト用バリエーションを使用してください。試みた操作、確認された結果、根拠、代替手段、検証内容を記録してください。問題を製品、ブラウザー操作、環境、スキルのガイダンスのいずれかに分類します。該当する最小範囲のスキルの指示またはリファレンスを更新し、スキルを検証してローカルコピーを再インストールしたうえで、影響を受けるシナリオと隣接するスモークテストを再実行してください。テストに合格させるためだけに、アサーションを弱めないでください。

機能の境界

ホストの依存関係の確認と承認済みのインストールについては、references/host-environment.mdを参照してください。エージェントによるナレーションまたはナレーション前の生成を行う前に、references/voiceover-workflow.mdを参照してください。

リクエストを現在実行できるかどうかを判断する際は、references/current-capabilities.mdを参照してください。Timeline Studio ツールを公開しているブラウザーですでに開いているプロジェクトを編集する場合は、references/webmcp-integration.mdを参照してください。同梱の MCP サーバーに接続またはそのツールを呼び出す場合は、references/mcp-integration.mdを参照してください。基盤となるエージェントコマンドレイヤーを実装または呼び出す場合は、references/command-contract.mdを参照してください。モデルを利用した分析または強化を行う前に、references/local-model-routing.mdを参照してください。リモート動画生成器、デジタルヒューマンサービス、またはプログラム可能なコンポジションサービスを選択または呼び出す前に、references/remote-video-generation.mdを参照してください。プロバイダーに依存しない最新のウェブ映像およびショート動画の提案については、references/web-footage-sourcing.mdを参照してください。UI 操作の実行についてはreferences/browser-workflow.md、カテゴリを考慮した自動編集についてはreferences/auto-edit-workflow.md、クローズドループの事例を用いた、根拠に基づく製品およびプロモーションのストーリーテリングについてはreferences/promotion-narrative-workflow.md、編集スタイルの再現と AI 生成によるリメイクについてはreferences/replication-workflow.md、ピークの階層構造と緊張感の演出についてはreferences/highlight-tension-workflow.md、速度カーブ、カラーホイール、切り抜き、アウトライン、許可を得た顔交換のショット設計についてはreferences/curves-and-subject-effects.md、メディア分析、生成方法の調整、手ぶれ補正、強化、成果物の納品に共通する手順についてはreferences/professional-editing-workflow.md、繰り返し実行できるカテゴリ別マトリクスについてはreferences/auto-edit-scenarios.md、体験に基づく反復テストについてはreferences/e2e-evaluation.mdを参照してください。

公開向けの説明では、質問ごとに参照先を1ページに絞ってください。Timeline Studio が何かについてはdocs/agent-video-editing.md、プラットフォームごとの発見と呼び出しについては、Codex、Claude Code、GitHub Copilot、またはGemini CLIのガイド、再現可能な事例についてはdocs/examples.md、実行コマンドの正確な構文についてはdocs/command-reference.md、FFmpeg、CapCut、Remotionとの比較についてはdocs/comparison.mdを使用してください。ユーザーが包括的な概要を求めている場合を除き、公開ページをすべて読み込まないでください。

リクエストされた操作がサポートされていない場合は、有効な部分タイムラインを変更せず、欠けているコマンドまたは実行時機能を正確に伝えてください。

コメント