/video-review
一轮评审:收集整批反馈,按每个视频合并,同时修复所有有备注的视频,自行检查每个结果,交付下一版本,并报告。
为什么采用批量和并行处理:在这些技能来源的生产环境中,三条反馈在五分钟内先后到达,代理开始在自己的上下文中修复第一条。上下文被填满,评审者不得不停止它,并指出一次只处理一条反馈效率不高。将反馈合并到一个表格中并交给三个并行的子代理后,同样的三个修复在70分钟后被评审并交付。修复绝非仅仅是渲染:编辑、配音、渲染、质量检查和报告每个视频需要50到90分钟,因此串行修复会成倍增加时间。
0. 设置
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
PY="$PVS_HOME/bin/pvs-py"
找到产品(当前目录上最近的 product.yaml)并列出其视频以及当前版本和交付状态(在每个视频上运行 skills/video-build/scripts/stages.py)。
1. 获取整批反馈
如果参数是一个文件,则读取它;如果是文本,则直接使用。然后询问一次:“这是本轮所有视频的所有反馈吗?没有备注的视频保持原样。” 在修复任何内容之前等待回答。如果在合并过程中反馈继续到达,将它们添加到同一轮中;不要每收到一条消息就启动一次修复。
2. 将反馈合并为每个视频的表格
"$PY" "$PVS_HOME/skills/video-review/scripts/feedback_table.py" <产品目录> <反馈文件或 -> \
--out <产品目录>/reviews/round-<日期>.md
它将每条反馈按原样归类到它命名的视频(通过ID、标题或标题)下,将关于“所有视频”的反馈放在共享部分,并列出无法归类的反馈。然后,为每一行填写:含义(你的理解,包括哪些内容不得更改)、接受标准(你将如何检查:时间范围、片段、帧)和对所有视频都适用的规则?
在填写之前阅读 references/review-protocol.md:它涵盖了口述错误、实际上是规则的反馈以及与产品冲突的反馈。
对每条反馈要问三个问题:
- 它真的是规则吗?如果是,则本轮所有视频都适用,而不仅仅是评审者指出的那个。曾经有一位评审者对单个视频给出了覆盖规则,几小时后不得不再次要求将其应用于所有视频。
- 产品实际上是否已经实现该规则?在承诺修复之前检查代码。如果没有,则提出一个带有推荐选项的封闭性问题(例如“仅显示已存在的内容”)。
- 这是
COVERAGE.md中缺少的功能吗?如果是,则修复需要添加该行。
向用户展示合并后的表格,最多包含三个封闭式决策(附上默认值)。沉默表示接受默认值。没有备注的视频列为未修改。
3. 为每个有备注的视频开启下一版本
"$PY" "$PVS_HOME/skills/video-review/scripts/bump_version.py" <视频目录> --note "<引用>" ...
它备份 lines.tsv、timings.json 和 video/src 为 v,将 BRIEF 版本升级到 N+1,并打开一个包含这些引用的变更日志节。如果 v 从未被渲染(那将跳过一个版本),它会拒绝操作。v 的渲染产物保持不变:它是对比参考,并且评审者可能共享过的文件永远不会被覆盖。
4. 每个视频一个修复子代理,同时启动
为每个视频填写 references/fix-prompt.md(评审者的原话、你的理解和接受标准、你在代码中已发现的内容及其 file:line、共享规则),然后在同一轮中使用 Agent 工具后台启动每个修复器。在启动之前,自行进行简短的代码查找,以提供“我已找到的内容”;这可以为每个修复器节省相同的搜索,并捕获产品无法满足的反馈。
在它们运行时,不要自行修复任何内容,也不要发送消息轮询它们。监视文件(stages.py、修改时间、渲染日志)。如果修复器需要批准,向用户提出一个封闭性问题并转发答案。如果修复器停止,使用相同的提示加上它停止的位置启动一个新的:状态保留在文件中。
5. 自行检查每个结果
对于每个视频,无论修复器报告了什么:
- 与前一个版本进行一致性检查,排除故意更改的片段:
"$PY" "$PVS_HOME/skills/render-qa/scripts/parity.py" <旧的mp4> <新的mp4> --skip a:b ...。 已批准的片段发生更改属于回归:将其退回。 - 质量检查:
"$PY" "$PVS_HOME/skills/render-qa/scripts/qa.py" <视频目录> <新的mp4> --strip ...在每个更改的节拍处设置片段。加载render-qa以了解如何读取;自行查看工作表和片段。 - 从你的表格中检查每条反馈的接受标准。未满足的反馈需要退回给同一个修复器(发送消息:问题、时间范围、“不要更改其他任何内容”)。
- 填写
BRIEF.md中的变更日志节。
6. 交付并关闭本轮评审
"$PY" "$PVS_HOME/skills/render-qa/scripts/deliver.py" <视频目录> <新的mp4> --archive-previous
然后,一起关闭本轮评审:成为规则的反馈添加到 kit/RULES.md(附上日期和评审者的原话),以便下次构建继承它们;每个 BRIEF 变更日志应完整。不再更新的规则文件会变得错误,然后规则会在每个提示中被人为重复。如果评审者已在某处上传了之前的版本,说明哪些文件需要重新上传。
7. 报告
| 视频 | 从 | 到 | 应用的备注 | 查看位置 | 一致性 | 质量检查 | 交付版本 |
|---|
然后:未修改的视频、添加到 kit/RULES.md 的规则、任何未验证的内容,最多三个封闭式决策。使用用户的语言,简短,表格优先。
参考
references/review-protocol.md:在填写合并表格之前阅读。references/fix-prompt.md:在启动修复器之前阅读。