1仕組みと動作原理
本スキルはファミリー全体のオーケストレーション総合エントリーポイントです。「大まかなリクエスト」から「検証済みの最終レンダリング」まで、5ステップのメインプロセス（現状把握 → 制作成果物への変換 → 専門スキルへのルーティング → 階層的ビルド → 報告前の検証）を通じて進行します。
skills/end-to-end-video-playbook/SKILL.md
Use this skill to coordinate a complete video project from rough request to verified final render.
ここでの処理内容：「まずディスク上の既存ファイルを確認」し、「実行可能な成果物を生成」し、「専門スキルへディスパッチ」する順序で作業を分解し、いきなりシーンコードを書き始めるのを防ぎます。
最初のステップで「ロック済みシーン」とユーザー境界（例：Scene 01には手を加えない）の特定を要求し、storyboardテンプレートを用いた複数シーン構造の管理を義務付けます。
skills/end-to-end-video-playbook/SKILL.md
Identify locked scenes and user boundaries such as "do not modify Scene 01."
ここでの処理内容：「承認ステータス」を一級の入力として扱い、後続のsurgical系スキルの全停止条件をこの「ロック済み」の概念に基づいて構築します。
意図を成果物に変換：シーンごとに1つのscene-specを作成し、「プロジェクト固有コンテンツ」と「再利用可能な制作パターン」の分離を強制します（プライベート素材やブランド要素が再利用可能サンプルに混入するのを防止）。
skills/end-to-end-video-playbook/SKILL.md
- Separate user-specific content from reusable production patterns.
ここでの処理内容：リポジトリのAGENTS.mdにある「Keep private project assets out of this repository」およびREADMEのコントリビューション原則に対応し、ワークフロー自体で「再利用可能」と「プライベート」の境界規律を維持します。
ユーザーの言い回しを8つの専門スキルに直接マッピングするルーティングテーブルを内蔵（大まかなアイデアのみ→intake、参考用の最終フレームあり→intake→motion-design-systems→scene-builder、「特定の箇所以外は完璧」→render-qa）。
skills/end-to-end-video-playbook/SKILL.md
- User says "everything is perfect except": use `render-qa-and-surgical-changes`.
ここでの処理内容：本件で最も実用的な部分であり、「どのスキルを読み込むべきか」をエージェントの推測に頼らずテーブル参照で解決します。
階層的ビルド順序は厳格な制約：ドラフトシーンレンダリング → BGMなしナレーションマスター → 字幕 → 最後にBGMの順。ソースシーンと結合スクリプトが存在する場合に、過去の完成版動画に直接パッチを当てることは明示的に禁止されています。
skills/end-to-end-video-playbook/SKILL.md
- Assemble narration-only master before final music.
ここでの処理内容：「BGMが入った完成動画に対して字幕やBGMを調整する」といったズレを順序付けによって根本から排除し、audio-sync-assemblyやcaptions-and-music-bedの前提条件と整合させます。
完了基準はQuality Gateチェックリスト：最終の尺/解像度/FPSが確定、音声トラックの存在、字幕の存在（要求時）、シーン境界の証明、ユーザー指定タイムスタンプの証明、BGM終了処理の確認、ユーザー要求の主観プレビューの提示または明示的スキップ。
skills/end-to-end-video-playbook/SKILL.md
- Exact user-requested timestamp proofs exist.
ここでの処理内容：完了（done）を観察可能な証明の集合として定義し、末尾で「検証済み項目と主観的判断が残る項目」を明示させます。
質問の規律：実装を変更する質問のみを行い、「ファイルから調べられる内容」（クリップの長さ、シーン名、現在のFPS、特定タグを含むソースファイル、音声トラックの有無）の質問は明示的に禁止します。
skills/end-to-end-video-playbook/SKILL.md
Do not ask questions discoverable from files:
ここでの処理内容：「尋ねる前にまずディスクを読む」ことをルール化し、ツールを使って不確実性を解消することをエージェントに義務付けます（同ファミリーのvideo-intake-and-storyboardでも同様のルールを規定）。
2コア機能
01エンドツーエンドのオーケストレーションとルーティング：5ステップのメインプロセス＋12ステップの実施順序（シーンロック→spec準備→ソース構築→ドラフトレンダリング→証明フレーム抽出→BGMなし結合→字幕アラインメント→字幕焼き込み→BGM追加→音声ミックス→最終レンダリング→プルーフシートとプレビュー動画）
02成果物出力リスト：storyboardまたはtimeline manifest、シーンレンダリング、最終結合スクリプトまたはコマンド計画、字幕ファイル、最終MP4、プルーフフレーム/コンタクトシート、リスク区間のプレビュー動画
03意思決定チェックリスト（構築前に記録必須の10項目）：新規/シーン追加/仕上げ、既存シーンの承認有無、旧レンダリングが真のソースかプレビューのみか、字幕要否、BGM追加/変更/ダッキング/維持、製品デモのクロップ要否、正確なセリフタイミングの要否、無音フック/ポーズ/末尾ホールドの有無、最終FPSを24/30/48/60またはソースFPSにするか、レンダリング前の証明確認をユーザーが求めているか
04ユーザーの発話に基づくルーティングテーブル（rough idea / reference final frame / scene must start from another scene / raw screen recording / captions late or too big / narration changed / everything perfect except）
054つの制作ルール：ソースが存在するときに過去の完成版にパッチを当てない、わずかなポーズのために全体をスローダウンさせない、無音とリズムにはホールドフレームを優先する、仕上げの修正では影響を受けたシーンのみを再レンダリングし重複キャリーオーバーフレームを検査する
06質問リスト（実装を左右する6つの質問）と「質問してはならない」ファイルから確認可能な5項目
07引き継ぎフォーマット：最終レンダリングパス、重要シーンとレンダリングパス、使用したコマンドまたはスクリプト、証明フレーム/プレビューのパス、実施済みテスト、未検証項目
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | HyperFrames（场景合成与渲染引擎；本件在 description 与「构建场景」路由中点到，具体命令由 hyperframes-scene-builder 给出） |
| cli | FFmpeg / ffprobe（装配与探针；文中以 media probe 表述，具体命令在 audio-sync-assembly 与 render-qa-and-surgical-changes 中） |
| package | 兄弟 skill（同仓 8 件：video-intake-and-storyboard、hyperframes-scene-builder、motion-design-systems、scene-continuity-and-transitions、product-demo-integration、audio-sync-assembly、captions-and-music-bed、render-qa-and-surgical-changes）——被本 skill 按名点名调用，属宿主/仓库层协作，不改变本件档位 |
| package | 模板 templates/storyboard.md 与 templates/scene-spec.md（本件要求用它们承载多场景结构与逐场景 spec） |
| package | 素材输入：项目内既有资产、渲染、组合、脚本、音频、字幕与既往批准（本地读取，非外部服务） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- scripts/: ローカルスクリプトまたはコマンドの実行: （本スキルディレクトリ内に付属スクリプトはなし）ルーティングに基づきホストが実行：ffprobe/ffmpegによるプローブと結合、HyperFramesレンダリング、字幕および音声ミキシングコマンド
- 本地工作目录: ファイルの読み書きと成果物出力: storyboard、timeline manifest、シーンごとのscene-spec（制作成果物）
監査ノート： 本スキルのディレクトリにはSKILL.mdのみが存在します（純粋なワークフロー/ルーティングドキュメントであり、スクリプト、エンドポイント、認証情報は一切なし）。動作スコープはプロジェクト内ファイルの読み込み、制作成果物（spec/storyboard/レンダリング/字幕/証明フレーム）の書き込み、およびルーティングに応じたローカルCLIと関連スキルの呼び出しであり、Blue Tier（ローカル読み書き/ローカルツールのみ）に適合します。**外部サービスへの素材送信は行いません**：スキルディレクトリ内の全スキャンにより、http(s)://エンドポイント、fetch/requests、トークンや環境変数の読み込みがないことを確認済みです。記載されている8つの関連スキルは本件と同じリポジトリ・同じTier（いずれも純粋な指示＋ローカルツール）に属しており、パラダイムに従って波及的なTier引き上げは行わず、連携はreasonおよびrisksにのみ記録します。ファミリーの9スキルすべてで判定基準は一貫しており、ディレクトリ内にはSKILL.md（+ references）のみで、動作はローカル読み書きとローカルCLIに限定され、エンドポイント、認証情報、外部への素材送信は存在しません。
5二重目の独立検証
- [ok] 路由表点名的 skill 是否都存在（避免指向不存在的 skill） — 本仓 skills/ 下确为 9 个目录：audio-sync-assembly、captions-and-music-bed、end-to-end-video-playbook、hyperframes-scene-builder、motion-design-systems、product-demo-integration、render-qa-and-surgical-changes、scene-continuity-and-transitions、video-intake-and-storyboard；路由表点到的 8 个全部存在，含自身构成完整闭环。
- [ok] 是否存在隐藏网络调用（编排层最容易藏外发） — 全目录仅一个 SKILL.md，正则扫描无 http(s):// / fetch / requests / api_key / token / .env / curl；所有外部能力都表现为「本地 CLI 或同仓 skill」，无素材上传与生成服务。
- [discrepancy] Run media probes 是否指得出具体命令 — 本件只说 Run media probes on final outputs.（步骤 5）而未点名 ffprobe 或仓库脚本；具体命令分散在 render-qa-and-surgical-changes（六个脚本清单）与 audio-sync-assembly（ffprobe 与 setpts 模板）。只加载本件的 agent 需自行选择探测方式。
- [ok] Quality Gate 是否可机械判定 — 七项中六项可观察（时长/分辨率/FPS/音轨存在/边界证明帧/点名时间戳证明），一项是流程性（音乐收尾行为已查），一项是主观项并要求显式声明跳过——判据明确，不靠感觉。
- [ok] 5 步主流程与 12 步实施顺序是否冲突 — 两者是层级关系：5 步是阶段划分（ground/intent/route/build/verify），12 步是「构建 + 装配」段的展开，前 5 步对应 build 前的准备、后 7 步对应 build 与 verify；无相互矛盾的指令。
- [ok] 「不要 patch 旧成片」是否在族内一致 — 本件 Production Rules 的 Never patch an old final MP4 when source scenes and assembly scripts exist. 与 render-qa-and-surgical-changes、workflows/surgical-final-edit.md 的同一规则一致（后者另写 Do not patch an old final MP4 if source scene renders and assembly scripts exist.）。
6結論
最適な用途： 最適：完全な要望（フル動画、マルチシーン編集、ローンチ動画、製品/デモ動画、UGC風編集、企業向け解説動画、あるいはプロンプト/スクリプト/素材から直接最終MP4を出力）を受け取った際の初期エントリーポイント。また、8つの専門スキルへ適切に処理を割り振るマルチスキル動画リポジトリの常駐エントリードキュメントとしても適しています。
不向きな用途： 不適：① 単一箇所の軽微な修正（ユーザーが「特定箇所以外はすべて完璧」と述べている場合 → intake成果物をスキップし、直接render-qa-and-surgical-changesを使用すべき）；② 具体的な実装詳細が必要な場面（本件にはコード、コマンド、スタイル判定基準が含まれないため、専門スキルとの併用が必須）；③ 素材のライセンス確認やコンプライアンス審査が必要なプロジェクト（品質ゲートの対象外）；④ オンライン協調作業やホスト型クラウプレンダリング（ローカルCLIおよびローカルプロジェクトディレクトリを前提としているため）。
Install Agent-Ready
① Verified Mirror 2026-09-28
Option A · Direct DownloadDownload end-to-end-video-playbook.tar.gz
sha256:
Option B · Copy Guide for Agent70061b50836680c0…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit f6b043d9fd.