1实现原理 · 为什么它能做到
本 skill 是整族的编排总入口：把「一个粗略请求」推进到「经核验的最终渲染」，方法是五步主流程（接地 → 转成生产工件 → 路由到专职 skill → 分层构建 → 报告前先验证）。
skills/end-to-end-video-playbook/SKILL.md
Use this skill to coordinate a complete video project from rough request to verified final render.
注：这里在做什么：把工作拆成「先看盘上已有什么」再「产出可执行工件」再「派给专职 skill」的顺序，避免一上来就写场景代码。
第一步就要求识别「已锁场景」与用户边界（例如别动 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 类 skill 的所有停止条件都建立在这个「已锁」概念上。
把意图转成工件：每场景一份 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 个专职 skill（只有粗略想法→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`.
注：这里在做什么：这是本件最实用的部分——把「该加载哪个 skill」变成查表，而不是让 agent 自己猜。
分层构建顺序是硬约束：先草稿场景渲染 → 先出无音乐旁白母版 → 字幕 → 最后才是音乐床；规则明确禁止在源场景与装配脚本存在时去 patch 旧成片。
skills/end-to-end-video-playbook/SKILL.md
- Assemble narration-only master before final music.
注：这里在做什么：用顺序把「字幕/音乐对着带音乐的成片做」这类漂移一次性挡掉，与 audio-sync-assembly、captions-and-music-bed 的分层前提一致。
完成判据是一张 Quality Gate 清单：最终时长/分辨率/FPS 已知、音轨存在、字幕在（若要求）、场景边界证明存在、用户点名时间戳证明存在、音乐收尾行为已查、用户要求的主观预览已展示或明确跳过。
skills/end-to-end-video-playbook/SKILL.md
- Exact user-requested timestamp proofs exist.
注：这里在做什么：把 done 定义成可观察证明的集合，并要求在末尾声明「哪些是验证过的、哪些仍主观」。
提问纪律：只问会改变实现的问题，并显式禁止问「能从文件里查到」的问题（片段时长、场景名、当前帧率、哪个源文件含某标签、有没有音轨）。
skills/end-to-end-video-playbook/SKILL.md
Do not ask questions discoverable from files:
注：这里在做什么：把「先读盘再问」写成规则，等价于要求 agent 用工具消除不确定性；同族 video-intake-and-storyboard 复述了同一条。
2核心能力
01端到端编排与路由：5 步主流程 + 12 步实施顺序（锁场景→备 spec→建源→渲草稿→抽证明帧→无音乐装配→字幕对齐→压字幕→音乐床→混音→出成片→证明表与预览片）
02工件产出清单：storyboard 或 timeline manifest、场景渲染、最终装配脚本或命令计划、字幕文件、最终 MP4、证明帧/接触表、风险段预览片
03决策清单（10 项，构建前必须记录）：新片/加场景/收尾、既有场景是否已批准、旧渲染是真源还是仅预览、是否要字幕、音乐加/换/降/不动、产品演示是否裁切、是否要精确台词时序、是否有静默 hook/停顿/结尾保持、最终帧率取 24/30/48/60 还是源帧率、用户是否期望渲染前先看证明
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）
05生产规则四条：源存在时不要 patch 旧成片、不要为一个小停顿全局减速、静音与节奏优先用保持帧、收尾改动只重渲受影响场景并检查重复 carryover 帧
06问题清单（只问会改变实现的 6 个）与「不要问」的 5 个可从文件查明的项
07交接格式：最终渲染路径、重要场景与渲染路径、用过的命令或脚本、证明帧/预览路径、做过的测试、未验证项
3外部依赖
| 类型 | 依赖 |
|---|---|
| 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风险提醒 风险提醒：蓝色 · 知晓即可
风险提醒：蓝色 · 知晓即可
- 编排层无自带工具，media probe 等动作缺少具体命令 — 本件通篇只有判据与路由，未给 ffprobe/ffmpeg/HyperFrames 的具体命令；若宿主只加载本件，入门者可能漏做探测或自行发明命令（建议同时加载 render-qa-and-surgical-changes）。
- 路由依赖 skill 名称字面匹配 — 路由表与实施顺序均以 audio-sync-assembly、render-qa-and-surgical-changes 等目录名点名；若使用者把 skills/ 下的目录复制或改名（README 建议过 copy selected folders），路由提示会失效，agent 需靠描述自行匹配。
- 「不要问可查明的」与「读盘即信盘」的组合是注入面 — 规则鼓励 agent 直接读项目文件并把内容作为约束（时段/文件名/标签/音轨），若项目文件由第三方投喂，其中的指令式文本可能被当作流程要求执行；本件没有对项目内文件可信度的校验要求。
- Quality Gate 不含版权与授权检查 — 门禁覆盖时长/分辨率/音轨/字幕/证明帧/音乐收尾，唯独没有素材授权或私密信息检查（仓库 AGENTS.md 只要求不要把私有资产放进本仓库，未要求检查成片内容）。
- 对「全片重渲」缺少依赖闭包定义 — Production Rules 写了只重渲受影响场景，但未定义场景依赖闭包（哪些场景因 carryover 受影响），实际执行仍依赖 scene-continuity-and-transitions 的搜索程序；遗漏会导致边界旧帧残留。
风险提醒：蓝色，知晓即可。本 skill 目录只有 SKILL.md（纯流程/路由文档，无脚本、无端点、无凭证）；行为面是读项目内文件、写生产工件（spec/storyboard/渲染/字幕/证明帧）与按路由调用本地 CLI 与兄弟 skill，符合蓝档「仅本地读写/本地工具」。**没有把素材送外部服务**：全量扫描本 skill 目录内无 http(s):// 端点、无 fetch/requests、无 token/env 读取。被点名的 8 个兄弟 skill 与本件同仓同档位（均为纯指令 + 本地工具），按范式不做传递式抬档，相关协作只记入 reason 与 risks。九件同族 skill 判级口径一致：目录内只有 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）时的第一站；也适合作为一个多 skill 视频仓库的入口文档被长期加载，用它来分发其余 8 件。
不适合：不适合：① 单点小改（用户已说「除了某处全都完美」→ 直接用 render-qa-and-surgical-changes，跳过本件的 intake 工件）；② 需要具体实现细节的场合——本件不含代码、命令与样式判据，必须叠加专职 skill；③ 需要素材授权或合规审查的项目（门禁不覆盖）；④ 需要在线协作或托管渲染（本流程假定本地 CLI 与本地项目目录）。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-28
方式 A · 人下载镜像包下载 end-to-end-video-playbook.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agent70061b50836680c0…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库saranambiar / saranambiar/hyperframes-video-agent-skills
Stars48
最近推送2026-06-14
本 skill commit
f6b043d9fd许可Apache-2.0（仓库根 LICENSE 为 Apache License Version 2.0；GitHub API license.spdx_id = Apache-2.0）
本站信息
收录日期2026-09-06
分类内容创作
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。