video-review
成片自检闸门——ffprobe 校验 + 5 位抽帧黑帧扫 + 音频电平 + 时长/分辨率一致性，verdict pass/fail/warn。各视频生产技能合成后、交付前必跑。
ソース情報
- リポジトリ
- TeamWiseFlow/xiaobei
- ソースの最終更新活動
- 2026年7月26日 14:37
- 検出された SKILL.md の言語
- 中国語
- スター
- 8,574
- フォーク
- 1,455
インストール方法
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
ソースファイルを確認
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
ファイルエクスプローラー
3 ファイルSKILL.md を表示中
SKILL.md
ソースの指示 · 読み取り専用プレビュー- name
- video-review
- description
- 成片自检闸门——ffprobe 校验 + 5 位抽帧黑帧扫 + 音频电平 + 时长/分辨率一致性，verdict pass/fail/warn。各视频生产技能合成后、交付前必跑。
- metadata
- {"openclaw":{"emoji":"🔬","requires":{"bins":"[Truncated]"}}}
# video-review（成片自检公共技能）
## 用途
视频合成后的**强制自检闸门**——在向用户交付前跑一次，拦成片硬伤：
- ffprobe 全字段校验（codec / 分辨率 / fps / pix_fmt / 音频配置）
- 5 位抽帧黑帧扫（0% / 25% / 50% / 75% / 100%）—— ≥2 黑帧判 critical
- 音频电平分析（volumedetect）—— 静音 / 削波 / 无音轨
- 时长 vs 目标（`--target-duration`，默认 ±5% 容差）
- 分辨率 floor（9:16 竖屏最低 720x1280）+ 目标比对 + 段一致性
## 调用
```bash
video-review <final.mp4> # 直接审单个成片文件
video-review <project-dir> # 审 <dir>/video.mp4，并对 artifacts/ 做段一致性检查
video-review <project-dir> --target-duration 30 --target-resolution 720x1280
video-review <final.mp4> --output review.json
```
参数：
| 参数 | 默认 | 说明 |
|------|------|------|
| `target` | — | 成片文件路径；或项目目录（目录时审 `<dir>/video.mp4`，且若存在 `artifacts/` 一并做段一致性检查） |
| `--target-duration` | 无 | 目标时长（秒），从脚本片段规划累加得出 |
| `--target-resolution` | 无 | 目标分辨率，形如 `720x1280` |
| `--output` | `<project-dir>/review/verdict.json` | verdict JSON 落盘路径 |
## verdict 语义
| verdict | 退出码 | 含义 | 处置 |
|---------|--------|------|------|
| `pass` | 0 | 无 critical 无 warning | 可交付 |
| `fail` | 1 | 有 critical issue | **不准交**——按 `critical[]` 修复后重审，最多重修 2 轮，仍 fail 则向用户复述 critical 项请求决策 |
| `warn` | 2 | 有 non-critical issue | 向用户复述让其决定是否重修 |
| — | 3 | 脚本本身故障（ffprobe missing / path invalid） | 不算评审结论，修脚本 |
## verdict JSON schema
```json
{
"verdict": "pass" | "fail" | "warn",
"file": "<video.mp4 absolute path>",
"ffprobe": { "codec", "width", "height", "fps", "pix_fmt", "duration", "size_bytes", "audio": {...} },
"frames": [ { "position_pct", "path", "mean_luma", "is_black" } ],
"audio_level": { "mean_db", "max_db", "silent", "clipping", "absent" },
"checks": [
{ "name": "duration_match", "status": "pass", "detail": "actual 30.2s vs target 30s, gap 0.2s" },
{ "name": "resolution_floor", "status": "pass", "detail": "720x1280" },
{ "name": "resolution_uniform", "status": "fail", "detail": "成片 720x1280 vs 段01 1080x1920" }
],
"critical": [ "resolution_uniform: ..." ],
"warnings": [ "audio_level mean_db=-42.1 close to silent threshold" ]
}
```
## 抽帧产物
5 帧静图落 `<project-dir>/review/frames/frame_NNN.jpg`，verdict JSON 落 `<project-dir>/review/verdict.json`。**不进 `artifacts/`、不进 `previews/`**，与 keyframes/ 子目录同级，互不混淆。
## 段一致性检查
`probe_segments` 扫 `<project-dir>/artifacts/` 下各段 ffprobe，逐段比对分辨率与成片是否一致——拼了不同分辨率段是硬伤。`artifacts/_deprecated/` 子目录不参与（非递归 listdir）。
## 强制约定
- **禁止跳过本脚本交付**：各视频生产技能的合成环节产出 `video.mp4` 后，必须先跑本脚本，verdict=pass 才能进交付/封面环节
- **禁止肉眼看交代替本脚本**：本脚本是替代"裸拼完就交"脆弱闸门的强制自检
- **warn 处置**：声画同出模式下 `audio_absent` warning 要对照看——AI 生成模式该出声没出声是 critical（退回重生成或补 TTS）；Stock Footage + `--no-audio` 模式下 `audio_absent` 是预期，warn 可放行
GitHubで見る