Communitygithub.com

视频审查与交付

将构建完成的影片转化为可交付成品的循环流程。检查帧画面、测量音频、运行检查、向用户展示样片和样稿、根据反馈执行操作、渲染最终版、验证成品文件、编写项目记录并报告。在每次构建或修改后、每次渲染前,以及每次收到反馈时使用。

视频审查与交付 是什么?

该技能定义了一个完整的视频后期制作与交付工作流,适用于需要从项目构建到最终交付全流程管理的AI代理。它围绕“构建-审查-反馈-渲染-交付”的迭代循环,详细说明了每个阶段的具体操作步骤和检查标准。技能强调在低成本的快照和草稿阶段完成大部分视觉和声音检查,以节省昂贵的最终渲染时间。它支持基于`hyperframes`和`ffmpeg`等工具的命令行操作,涵盖帧级审核、音频响度测量、样片展示、用户反馈处理、最终渲染及验证、项目记录书写和交付消息编写等环节。该技能特别注重效率和准确性,提倡在渲染前彻底检查,将用户反馈转化为具体行动,并维护项目文档的完整性和可追溯性。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shubhamnshukla/video-agent-kit/tree/main/skills/video-review-and-delivery

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

审查与交付

1. 每次修改后的循环

  1. npx hyperframes lint。零错误。
  2. npx hyperframes snapshot --at 3.4,7.8,35.2,... 在你修改的时间点,以及前后各一个时间点。 打开联系表并认真查看:每张卡片是否完整,是否有任何面孔被遮挡,是否有文本超出其容器,是否有任何本应完成的部分只画了一半?
  3. 修复并重复,直到帧画面正确。
  4. npx hyperframes check --json(或使用4K素材的 scripts/check.sh)。修复错误。阅读一次警告并决定:修复它,或保留它并在 REVIEW.md 中说明原因。值得处理的警告包括:画面超过三秒无变化、第一帧为空、文本超出容器。

快照成本低;渲染成本高。在渲染前完成所有能做的检查。

2. 样片

样片是全片低质量版本:npx hyperframes render --quality draft -o renders/draft-01.mp4,对于一部100秒的1080p影片,耗时一到三分钟。然后:

  • 制作渲染文件的单帧图(scripts/sheet.sh renders/draft-01.mp4 sheet.jpg 1/2.6 8x5)并阅读它。 它展示的是编码后的影片,包括素材,这可能会与快照结果有出入。
  • 测量响度:ffmpeg -i draft.mp4 -af ebur128=peak=true -f null -。
  • 每两秒测量一次电平(scripts/levels.py draft.mp4 2)并与计划比较:安静的部分是否足够安静,产品出现时音量提升是否到位?

将样片交给用户,并附上简短说明,指出样片内容以及希望他们关注的视听要点。第一版样片就是用来被纠正的;尽早交给用户,而不是打磨完美。

3. 展示选项

当问题涉及视觉风格(高亮样式、字体、布局、颜色)时,展示静态帧,而不是渲染视频。

  • 创建每个选项,对相同的三到四个时间点进行快照,并排保存联系表,使用简洁的名称(A-underline.jpg,B-band.jpg)。
  • 用一句话分别说明A和B是什么,以及你会选择哪个及原因。
  • 仅就这个问题等待答复;继续处理所有不依赖于此的部分。

当用户的表述可能有两种含义时,这就是你弄清问题的方式。这只需要一分钟。错误的完整渲染则需要十分钟,并消耗他们的耐心。

4. 处理反馈

反馈通常简短、非正式,有时还带着情绪。这样处理:

  • 在行动前,将其重述为一个操作,用一句话:“新加坡照片:与其他照片一样使用小号字体,无论是在问题部分还是结尾部分。”
  • 在所有适用之处应用它。 如果一个元素错了,那么影片中其他位置的同类元素也同样错了。
  • 尊重个人品味。 “慢”、“无聊”、“看起来很廉价”、“太粗了”:修改它;不要辩解。如果你在事实问题上不同意(比如会遮挡面孔、某个说法不属实),就说一次,并说明理由。
  • 常见的反馈及其含义:
用户说执行操作
慢、困、无聊缩短镜头、加快语速、删减台词、使用更有活力的音乐;不要增加特效
不像真的、看起来像AI作品使用真实人物的真实素材;减少虚拟图形
看起来像是拼凑的库存视频对所有内容应用统一调色;使用重复出现的人物;使用一致的卡片
我无法与之产生共鸣明确名字、职位、具体需求;用他们自己的话描述问题
声音平淡、单调按情绪配乐;在音量提升前保持安静
让它更吸引人重写开篇钩子和总结句;增加呼应
这个和其他的不一样使其与其他版本完全匹配
在这些词上多加注意每行一个强调标记,先展示静态帧
  • 多条消息同时到来: 分别处理每一条;用一句话说明如何处理。后一条消息覆盖前一条。
  • 记录决策 在 REVIEW.md 和记忆中:他们选择了什么,拒绝了什么,用他们自己的话记录。

5. 最终渲染

当样片获得批准或剩余修改很少时:

  1. 检查可用磁盘空间。一个4K渲染,每100秒视频大约需要11 GB的临时空间。
  2. npx hyperframes render --quality delivery --resolution landscape-4k -o renders/<名称>-4k.mp4,在后台执行。如果用户需要速度或提出要求,添加 --gpu;告知其代价(大约一半的码率)。
  3. 如果用户询问需要多长时间,读取渲染进度并以数字回答。

版本名称要简洁明了(-v2,-v3)。当一个版本被拒绝时,删除它,以免有人误打开。

6. 验证成品文件

对即将交付的文件执行此操作,而不是对项目执行。

  • ffprobe:分辨率、帧率、时长、文件大小。
  • 整个文件的截图索引:确保每个段落都存在,没有空白或冻结的片段,最后一帧正确。
  • 对文字和人脸进行全尺寸裁切:确保文字清晰,素材不出现块状模糊。
  • 响度:约为 −16 LUFS 综合响度,真峰值在 −1 dBFS 或以下。
  • 从后期帧解码二维码(scripts/scan.py):确切的链接,分别在完整尺寸和半尺寸下验证。
  • 结尾卡片上的联系信息在请求时应能回复。

7. 项目记录

在报告前,更新这四个文件。templates/ 目录中有每个文件的骨架模板。

  • SCRIPT.md:脚本表(时间、画面、声音)、人员、每句台词的来源、数字。
  • SPEC.md:目标、输出、时间线和声音计划、视觉风格、字体、动画、带帧号的镜头列表、QA清单。
  • CREDITS.md:每个来源及其许可证。
  • REVIEW.md:已做的决策;已测量、已查看、未检查的事项;开放的决策;最弱的镜头;有意保留的警告;如何修改影片(哪个文件,哪个命令)。

8. 交付消息

简短,按以下顺序:

  1. 文件:路径、分辨率、时长、大小。
  2. 自上一版本以来的变更,以简短列表形式呈现。
  3. 你检查了什么以及如何检查的;你没有检查什么(例如,你从未听过的部分)。
  4. 需要用户决策的事项,按重要性排序:产品中未实时的部分、屏幕上公司可能不希望展示的内容、需要确认的许可证、需要听辨的发音。

不要对自己的工作进行任何形容词评价。如果有任何失败或缺失的内容,首先说明这一点。

9. 日常维护

  • 保留影片剪辑所使用的源下载文件和清单;当空间不足或用户要求时,删除未使用的候选素材、旧的样片和缓存。在删除前检查即将删除的内容;只删除你自己创建的内容。
  • 除非用户要求,否则切勿提交或推送他们的仓库。
  • 将生成脚本和辅助脚本保存在项目中,而不是保存在重启后会清空的临时文件夹中。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能