トーキングヘッド動画パイプライン
生の、または大まかにカットされたトーキングヘッド映像を、承認された作業用カット、編集可能なキャプション、動きがパッケージ化されたプレビュー、そして検証済みの最終書き出しに変換します。このファイルをルーター兼共有契約として扱ってください。現在のステージに必要な、ルーティングされた内部ワークフローと参照のみを読んでください。
初心者向けの約束
ユーザーがCodexでの編集経験がないことを前提とします。
- 安全に推定できない場合にのみ、一度に短い質問を1つ行います。
- 多くの技術的な選択肢を提示するよりも、動作するデフォルトを優先します。
- レンダラーの内部ではなく、次に表示される結果を説明します。
- 大まかなカット、文字起こしプロバイダー、またはAPIのセットアップは、生の映像が実際にその分岐を必要とする場合にのみ紹介します。
- 有料の選択肢とローカルの選択肢をわかりやすく説明し、有用な場合は1つを推奨しますが、決して強制しません。
- すべてのステージを、正確な出力パスとユーザーが次に言えるフレーズで終了します。
- 作業を最初からやり直すのではなく、既存の作業を再開します。
絶対的なルール
- ソースは不変です。 提供されたソースメディアを上書きしたり、破壊的に編集したりしないでください。
- メイン音声が基準です。 ユーザーが明示的にラフカット戦略を承認しない限り、音声のタイミング変更、並べ替え、リサンプリング、または置き換えを行わないでください。承認後、派生した
working_videoがダウンストリームの基準となり、オリジナルは不変のままです。 - 証拠は読みやすく保ちます。 スクリーンショットの本文テキスト、製品UI、顔、またはユーザーがマークしたセーフゾーンを覆わないでください。証拠アセットをぼかさないでください。
- 最終版の前にプレビュー。 公式プレビューを構築し、ユーザーが明示的に直接エクスポートを要求しない限り、承認を待ちます。
- オリジナル品質の最終版。 アップスケールされた低解像度プレビューを、真の高解像度最終版として提示しないでください。可能な限り、最終版のベースとしてオリジナルソースを使用します。
- 進行を中断しないでください。 レンダリングが進行中の場合は、待機して進捗を報告します。実際のエラーまたは明示的な承認があった場合にのみ、パイプラインを変更します。
- スキル内にプライベートデータはありません。 プロジェクトローカルのパス、メディア名、ブランドルール、スクリーンショット、顧客詳細、およびAPIキーは、ユーザーのプロジェクト内に残ります。
- 明示的なフィードバックからのみ学習します。 沈黙や未確認のドラフト1つから、永続的なスタイルルールを推測しないでください。
- タイポグラフィは正確さの一部です。 承認前にフォントファミリー、実際のウェイト、キャプション行ポリシー、ベースライン配置、および最長ラベルの収まりを宣言して検証します。
- 公開デフォルトはブランドニュートラルを保ちます。 クリエイターパレット、定期的なカードシステム、およびプライベートなビジュアルルールは、ローカルプロファイルにのみ保存します。
- 公開インストールでは1つのスキルを公開します。 ステージモジュールは
references/workflows/の下に保持し、パッケージマネージャーが個別に登録する可能性のあるネストされたSKILL.mdファイルを追加しないでください。 - インストール操作は復元可能です。 置き換え前に既存のインストールをバックアップし、再帰的な強制削除を実行する代わりに、アンインストールターゲットをアーカイブします。
- オプションのプロバイダーはオプションのままです。 キュレーションされたデフォルトのショットパックは、ネイティブのHyperFrames + GSAPです。ユーザーの明示的な同意なしに、ShotCraft、Remotion、または他のプロバイダーをクローン、インストール、更新、または要求しないでください。ネイティブレシピは完全なフォールバックとして残っている必要があります。
プレビューまたはエクスポート作業の前に、references/quality-gates.mdを読んでください。
ルートテーブル
| ユーザーの意図またはフレーズ | ルート | 典型的な出力 |
|---|---|---|
初始化视频项目, 第一次用, start a video project | references/workflows/init.md | 状態、編集計画、デザインプロファイル |
原片还没剪, 删口误和停顿, 帮我粗剪, raw takes, rough cut | references/workflows/rough-cut.md | 承認された非破壊的なラフカットとタイミングの引き継ぎ |
抽字幕轴, 只做字幕, transcribe, 改字幕 | references/workflows/captions.md | SRT、CSV、文字起こしJSON |
帮我设计, 换颜色风格, 规划弹窗, design | references/workflows/design.md | DESIGNと完全な編集計画 |
参考这张截图设计, 按这张图的视觉语言, style reference | references/workflows/design.md 参照ブランチ | プロジェクトローカルのSTYLE_REFERENCE |
按语义匹配动效, GSAP 动效丰富一点, semantic motion | references/workflows/design.md、次にプレビュー | 検証済みのMOTION_PLANとプレビュー |
参考 ShotCraft, 推荐电影感镜头, cinematic shot reference | references/workflows/design.md ShotCraftブランチ | MOTION_PLAN内のオプションのマッピングされたショット参照 |
做预览, 加动效, build preview | references/workflows/preview.md | 公式プレビューURL |
出成片, 导出 4K, export final | references/workflows/export.md | 検証済みの最終動画 |
改这个, 恢复上一版, revise | references/workflows/revise.md | スコープ指定されたリビジョンと新しいプレビュー/最終版 |
进度, 到哪了, status | references/workflows/status.md | 現在のステージと次のアクション |
体检, 为什么失败, doctor | references/workflows/doctor.md | 読み取り専用の診断 |
以后都这样, 记住这个风格, learn this | references/workflows/learn.md | 確認されたプロジェクトローカルのレッスン |
复盘成片, 下次怎么改进, retro | references/workflows/retro.md | 構造化された納品振り返り |
升级状态, 迁移, migrate | references/workflows/migrate.md | 状態スキーマのアップグレード |
モード検出
ルーティングの前に:
- このスキルリポジトリではなく、ユーザーの動画プロジェクトディレクトリを特定します。
.naive-video-state.jsonを探します。- それが存在せず、タスクが1回限りのキャプションテキスト編集以上の場合は、initワークフローをロードします。
- 存在する場合は、それに加えて、関連する場合にのみ
EDIT_PLAN.md、DESIGN.md、VIDEO_LESSONS.mdを読みます。存在する場合はworking_videoを使用し、それ以外の場合はmain_videoを使用します。 - 状態とファイルが矛盾する場合は、
python3 tools/video_doctor.py --project <project_dir>を実行します。
次のステージを使用します:
initialized -> captions_ready -> design_ready -> preview_ready
-> approved -> rendering -> final_ready
品質ゲートが通過するまで、後のステージをマークしないでください。
デフォルトパイプライン
ユーザーが完全なワークフローを要求した場合:
ffprobeでソースメディアを検査します。- プロジェクトの状態と安全な出力ディレクトリを初期化します。
- 映像がすでにラフカットされているかどうかが不明な場合にのみ質問します。生の場合は、オプションのラフカットワークフローをロードし、戦略の承認を要求します。
working_videoが存在する場合はそこから、それ以外の場合はmain_videoからキャプションファイルを生成または検証します。- スクリーンショット、録画、製品画像、チャート、またはデモを表示する必要があるかどうかを尋ねます。ユーザーに意味的な配置、正確な秒数/発話文アンカー、またはハイブリッドを選択させます。正確なアンカーの方がより正確であることを説明します。
- 利用可能な場合は単語レベルのタイミングを正規化し、発話を視聴者向けの論理グループに分割します。キャプション全体の開始時刻から単語の精度を偽装しないでください。
- スタイルプロファイルとセーフゾーンを収集または推測します。初心者にはオプションでスクリーンショット参照マッチングを提供します。
- 要求されたすべての挿入、論理グループリンク、および時間範囲を含む編集計画と意味的動き計画を作成します。
- 新しいプロジェクトの場合、ユーザーが
skipを選択しない限り、いくつかの安全な意味的ノードをキュレーションされたShotCraftに触発されたネイティブパックに自動的にマッピングします。既存の承認済みプロジェクト、ネイティブレシピ、およびオフラインフォールバックを保持します。 - 初回使用、新しいスタイル、または推論を多用する作業の場合は、代表的な静止キーフレームをレンダリングし、完全な動的プレビューの前に合成の問題を解決します。
- 必要に応じてブラウザフレンドリなプロキシを使用して、HyperFrames + GSAPプレビューを構築します。
- プレビューの品質ゲートを実行し、公式プレビューURLを提供します。
- 明示的にスキップするように指示されない限り、承認を待ちます。
- 承認された作業用動画とその音声クロックを使用して、オーバーレイまたは最終合成をレンダリングします。
- ファイルの存在、期間、解像度、フレームレート、および音声を検証します。
- 確認されたフィードバックのみをプロジェクトローカルのレッスンとして記録します。
- 納品後、事実に基づく振り返りを実行し、明示的でプライバシーセーフなルールのみを昇格させます。
プロジェクトファイル
initワークフローは、ソースメディアに触れることなく、次の最小限のプロジェクトメモリを作成します:
<project_dir>/
├── .naive-video-state.json
├── EDIT_PLAN.md
├── DESIGN.md
├── CONTENT_LOGIC.json # 視聴者向けの推論グループとタイミングビート
├── STYLE_REFERENCE.md # 参照画像が使用された場合にのみ作成
├── MOTION_PLAN.json # 意味的動きが計画された場合に作成
├── VIDEO_LESSONS.md
├── VIDEO_RETRO.md
├── edit/
│ ├── rough-cut.mp4 # オプション; オリジナルメディアは決して上書きされません
│ ├── rough-cut-edl.json # オプションの決定記録
│ ├── script-aligned.srt
│ ├── caption-table.csv
│ └── transcripts/
├── preview/
├── final/
└── qa/
└── KEYFRAME_REVIEW.md # 動的プレビュー前の静的合成レビュー
状態は動作メタデータであり、メディアデータベースではありません。小さく保ち、文字起こし本文、プライベートスクリーンショット、またはシークレットを保存しないでください。references/state-management.mdを参照してください。
スタイルのデフォルト
ユーザーがスピードを求め、参照を提供しない場合:
- ソースのアスペクト比を維持します。
- 設定可能な1つのアクセントカラーを使用した、クリーンで読みやすいカードシステムを使用します。
- 控えめなキーワード強調のある太字のキャプションを使用します。
- 動きにはGSAPのトランスフォームと不透明度を使用します。
- 検証済みの空きスペースにカードを配置します。
- スクリーンショットやデモが表示されている間は、動きの密度を減らします。
- 読みやすいテキストレベルとベースライン配置を維持し、ラベルを歪める代わりに、包含コンポーネントをアニメーション化します。
- 明示的なキャプションの最大行数と折り返しポリシーを選択します。
ブランドの一貫性が重要である場合にのみ、アクセントカラーを尋ねます。それ以外の場合は、ニュートラルなプリセットを使用し、後で簡単に変更できるようにします。初心者はオプションでスクリーンショットを提供し、低、中、高の参照強度を選択できます。スキルはソースのブランドやコンテンツではなく、視覚言語をコピーすることを説明します。動きの密度は控えめ、バランス、または活発です。references/style-onboarding.mdを参照してください。
詳細なGSAPレシピと意味的マッピングはreferences/motion-recipes.mdにあります。ランタイムとプラグインの選択はreferences/gsap-runtime.mdにあります。スクリーンショット抽出とコピー防止ルールはreferences/style-reference-workflow.mdにあります。アセットタイミングの選択はreferences/asset-onboarding.mdにあります。一致するデザインブランチに対してのみロードしてください。
ShotCraftの発見と適応ルールはreferences/shotcraft-integration.mdにあります。ネイティブのビギナーパックはreferences/shotcraft-default-pack.mdにあります。新しい自動プロジェクト、名前付きカード、または映画的なショットのリクエストのためにロードしてください。プロバイダーをサイレントにインストールしないでください。
単語レベルのタイミング、視聴者向けの論理グループ、および蓄積/終了動作はreferences/content-logic-workflow.mdにあります。キャプションの後、意味的デザインの前にロードしてください。
タイポグラフィ、コンポーネントジオメトリ、ガラス通知、およびシークセーフなフォーカス/タイプ/分割の適応はreferences/visual-quality-rules.mdにあります。すべてのデザインまたはプレビュータスクのためにロードしてください。
自己反復契約
自己反復とは、現在のユーザーのワークフローを改善することを意味し、それを公開デフォルトに漏洩させないことを意味します。
フィードバックを次のいずれかのスコープに分類します:
project: この動画にのみ適用されます。profile: このユーザーの将来の動画に適用されます。明示的な確認後にのみ書き込みます。product: プライバシーセーフで一般的な信頼性向上策です。スキルメンテナーに個別に提案します。
プロファイルフィードバックは、ユーザーの言葉、確認されたルール、影響を受ける項目とともにVIDEO_LESSONS.mdに記録します。