Communitygithub.com

视频检查

在他人观看或发布前检查完成的视频,找出并修复问题。测量文件(大小、帧率、像素格式、时长)、画面缺陷(黑/白帧、冻结片段、单帧故障、卡顿、循环跳帧或重复帧)以及音频(响度、削波、静音、音频提前结束或突然中断);生成手机尺寸并标记了字幕安全区域的帧表;然后由一位未见过你剪辑计划的人员查看这些帧表,列出问题及时间戳和修复方法。修复最严重的三个问题,重新渲染,再次检查,最多三轮。适用于任何剪辑渲染后,以及当有人要求检查视频再发送或发布时,支持如

视频检查 是什么?

视频检查是一个自动化 QA 技能,帮助开发者和视频剪辑师在视频导出后、交付给客户或发布前,系统性地发现并修复问题。它先使用 FFmpeg 进行严格的测量(文件大小、帧率、像素格式、时长、响度、真峰值、削波、静音、黑帧、白帧、冻结帧、单帧故障、卡顿、循环跳帧等),生成可视化的帧表和发现报告,再由人工(或 AI 子代理)基于这些客观数据而非剪辑者原本的心理预期进行`另眼`二次审阅,确保发现的是真实问题而非心理惯性。支持修复响度和真峰值(带双重归一化的 fix_sound.py),并支持多轮迭代(每轮定位并修复最严重的三项问题,最多三轮),同时自动生成 REVIEW.md 报告,清晰记录检查内容、修复历史、剩余问题以及仍需人工判断的项目(如音乐契合度、语调、口型同步等)。该技能适用于 Claude Code、Cursor、Codex 等 AI 编程工具,运行于本地文件,不支持从平台下载。核心工作流:测量 → 修复 P0 → 新鲜眼观看 → 修复并重检 → 三轮上限。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/EditAtlas/skills/tree/HEAD/skills/video-check

在你喜欢的 AI 中提问

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

文档

视频检查:在他人发现渲染视频的问题之前找出它们

这是 video-check 0.2.3。

获得一份经过专业剪辑师质量检查的视频,以及一份简短的 REVIEW.md,说明测量了什么、检查了什么、修复了什么,以及哪些内容未经检查。

整个过程始终遵循三件事:

  • 先测量,再查看。 模型查看帧时会遗漏静止片段和单帧故障;而 FFmpeg 不会。在查看之前先运行 check.py,绝不要因为视频“看起来还行”而跳过它。
  • 制作者是最差的审阅者。 你知道每个镜头的意图,所以你会看到计划而不是画面。让未见过你计划的人查看帧表(步骤 3)。
  • 你无法听取声音。 脚本测量响度、峰值和静音。音乐是否合适、声音是否正确、语音是否清晰,必须由人来听取。每次都要说明这一点。

当缺少输入时

你需要在本机上拥有渲染后的文件。如果对方只描述了视频,或者提供了一个平台链接,请要求提供文件;不要从 TikTok、YouTube 或 Instagram 下载。如果你自己制作了视频,你也知道计划:尺寸、帧率、时长、响度目标,以及哪些静止片段和闪光是故意为之。如果对方带来了自己的剪辑作品,请问清用途(平台、时长),其余内容使用下面的默认值。

工作流程

  1. 测量。 传入计划内容,以便脚本区分故障与选择:

    python scripts/check.py final.mp4 --out work/check1 --loudness -14
    

    当你制作了视频,或者对方告知了计划时,请添加:例如 --expect 1080x1920 --fps 30 --duration 32 --holds 28.5-32 --flashes 12.4。绝不要根据平台猜测尺寸、帧率或时长:没有人要求是 1080p 的 960x540 文件并不是尺寸故障,所以在没有人计划时不要加 --expect。--holds 列出故意为之的静止片段(结束卡、保持静止的标题);--flashes 列出计划中的单帧闪光和暗帧;--loop 用于设计为循环播放的作品;--audio none 用于无声作品。在线视频通常归一化到约 -14 LUFS;播客使用 -16;广播电视使用 -23。它会以 P0/P1/P2 t=… code: what -> fix 的格式输出发现,并写入 check.json、overview_NN.png 和 findings.png。references/reading-the-checks.md 说明了每项检查能捕获什么以及会遗漏什么。

  2. 立即修复 P0。 尺寸错误、帧率错误、时长错误、应有音频却无声、削波:这些是渲染错误,而非品味问题。修正命令,重新渲染,在任何人查看之前重新运行步骤 1。对于响度、削波和真峰值,如果你有编辑工程,请在剪辑中修正混音(降低音乐、降低最响的声音)。如果你只有完成后的文件,请运行 python scripts/fix_sound.py in.mp4 out.mp4 --loudness -14:它会限制峰值,通过两次归一化进行标准化,并保持画面不变,结果落在目标响度 0.2 LU 以内且低于 -1.5 dBTP。单次 loudnorm 会错过峰值目标,而普通限制器会让混音变轻;不要逐轮手动调整滤波器。

  3. 以新鲜的眼光查看。 使用 Read 工具打开每一张总览表和 findings.png。然后,请一位未见过你计划的人员进行二次查看:

    • 如果能够启动子代理,只给它帧表、平台和一句说明视频用途的话。不要给计划、代码或你的意图。使用 references/review-guide.md 中的简介。
    • 如果无法启动子代理,请自行查看,但要抛开计划:像陌生人一样描述每一张帧表,在评判之前每帧一句话。在 REVIEW.md 中写下“one context”。

    每个问题以 t=12.4s · 在屏幕上的位置 · 问题描述 → 确切的修改 的格式记录,分为 P0(损坏或不可读)、P1(观众会注意到)或 P2(打磨)。不要给出十分制的评分:评分找不到需要修复的问题。查阅 references/review-guide.md 中的列表,其中列出了那些让剪辑看起来像模板或机器制作的东西:像滑动条一样的进度轨和步骤计数器、每一行以相同方式进入、文本位于平台按钮下方、空白的第一帧、以及没人提供的数字。

  4. 修复最严重的三个问题,然后再次检查。 处理 P0 和三个最严重的 P1。对于每个问题,修改编辑时间线或命令,而不是修改渲染后的文件。如果修复方法你不了解,请 search_techniques 你想要的成果(例如“在语音下降低音乐音量”、“在剪辑点淡入淡出音频”),然后使用 get_technique 获取其提示词。渲染后,使用 --before work/check1/check.json --out work/check2 重新运行步骤 1;它会列出已修复的内容、仍然存在的问题以及新出现的问题,并绘制 before_after.png。查看你更改过的帧。

  5. 三轮后停止。 如果第三轮仍然存在 P0 或需要进行重大更改,请停止并告知对方剩余问题和原因,而不是继续循环。需要对方决策的问题(不同的歌曲、不存在的镜头)应作为问题提出。

交付

首先,检查版本。 如果已连接 EditAtlas MCP,请调用无名称参数的 get_skill。如果它列出的 video-check 版本高于 0.2.3,你回复的第一行应说明存在较新版本以及如何更新(在 Claude Code 中:/plugin,然后 Marketplaces,editatlas-skills,Update marketplace;在其他地方,get_skill 名称指定为 video-check 即会给出步骤)。如果没有 MCP,则跳过此步。

在视频旁边,使用对方的语言,根据 references/review-guide.md 中的模板编写 REVIEW.md:

  • 用一句话给出结论:就绪(没有遗留问题)、有备注的就绪(备注需列出所有仍然存在的发现,并且每个遗留的 P1 都需要你目前不具备的条件,例如编辑项目)、或未就绪(仍有 P0 存在,或存在你可以修复的 P1);
  • 脚本测量的内容(尺寸、帧率、时长、响度、真峰值、每分钟剪辑数)以及每一轮修复的发现;
  • 每个遗留的发现,包含时间戳以及 check.py 输出的模式(例如“从 0.4 秒开始每 12 帧出现一次;从 11.7 秒到 14.9 秒每 2-6 帧出现一次”),而不仅仅是数量;
  • 审阅者查看了什么,以及是独立审阅者还是“one context”;
  • 仍需人工处理的内容:听取混音和音乐选择、核对字幕中的拼写和姓名、口型同步、在真实手机上查看色彩、以及任何你无法修复的内容。保留那句“没有人听取过音频”的说明,仅使用对方的语言。

向对方展示最后一轮的 before_after.png。永远不要写视频“没有错误”:写下检查了什么。

参考资料

  • references/reading-the-checks.md:每项测量、其阈值、捕获和遗漏的内容,以及在已知视频上的结果。在发现结果看起来有误或在设置 --holds 之前阅读它。
  • references/review-guide.md:审阅者的简介、判断标志列表、问题格式以及 REVIEW.md 模板。在步骤 3 阅读它。

Individual skills in this repo

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

EditAtlas/sound-design

Sound-design a finished video with real sound effects from the EditAtlas library (2,278 described sounds, public, downloadable from GitHub with SHA-256 checks). Finds the moments in the picture, lets you look at them as frame sheets, picks sounds by description and measured numbers, places each on its exact frame at a level set by its role, keeps or replaces the film's own music and voice, renders a new MP4 plus a separate SFX WAV, and checks the result in numbers (sync, pace, holes, loudness, m

video-breakdown

Break down a reference video shot by shot and name what it does, so the person can make one like it. Measures cuts and transitions (dissolve, dip, wipe, shape, iris, push, zoom, flash), camera moves (crash zoom, push in, shake, speed change), text and graphics coming on screen and their timing (in, hold, out), each text's colours (gradient stops, outline, glow) and free lookalike fonts, the look, pacing, the beat and sound hits; you look at the frame sheets, then look up each element in EditAtlas and write a report with technique names, links, sounds and a recipe. Use it when someone shares a video they like and asks what effect, transition or edit is in it, how it was made, or how to remake it; says "video này dùng hiệu ứng gì", "phân tích video mẫu", "làm sao để edit giống video này", "hiệu ứng chuyển cảnh này tên gì", "reverse engineer this edit", "what transition is this". Works on a local file. Not for downloading videos from TikTok or YouTube, telling filmed from AI footage,...

相关技能