zenstory-ai/video-recap-skills / skills/video-reference
video-reference
Verified按需把一部优秀成片拆成可复用的制作参考:实测镜头节奏与音量起伏,标注段落与声音分工,把原片剧情事实与通用剪辑手法分开,导出不含原片人名和台词的 production_reference.json 供下次做片参考。独立于日常做片流程。触发词:拆片、拆解成片、制作参考、参考模板、production reference。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.4 KB |
| references/reference-schema.md | markdown | 11.6 KB |
| scripts/lib.py | script | 4.0 KB |
| scripts/reference.py | script | 5.0 KB |
| scripts/reference_check.py | script | 30.0 KB |
| scripts/reference_frames.py | script | 5.6 KB |
| scripts/reference_measure.py | script | 12.0 KB |
| scripts/reference_profile.py | script | 11.2 KB |
scripts/reference.py
View on GitHub#!/usr/bin/env python3
"""On-demand production reference from a finished video: measure → (agent looks + labels) → check → export.
python3 scripts/reference.py measure <video> --work-dir U [--hard-score 10] [--soft-score 4]
python3 scripts/reference.py frames <video> --work-dir U (--review | --longest N | --span A,B [--step S])
python3 scripts/reference.py check --work-dir U [--json]
python3 scripts/reference.py export --work-dir U --out <dir>/production_reference.json
Exit codes: 0 ok, 1 errors found (nothing exported), 2 bad input or ffmpeg failure.
"""
import argparse
import json
import sys
from lib import read_json
from reference_check import run_check, run_export
from reference_frames import frames, legend
from reference_measure import DEFAULT_HARD_SCORE, DEFAULT_SOFT_SCORE, MEASUREMENTS_FILE, measure
__all__ = ["main"]
def _print_report(report, as_json):
if as_json:
print(json.dumps(report, ensure_ascii=False, indent=2))
return
if report.get("derived") is not None:
print("== derived(只在内存里;target 用 derived.* 路径引用)==")
print(json.dumps(report["derived"], ensure_ascii=False, indent=2))
for title, key, tag in (("errors", "errors", "ERROR"), ("warnings", "warnings", "WARN")):
print(f"== {title} ({len(report[key])}) ==")
for line in report[key]:
print(f"{tag} {line}")
if report.get("written"):
print(f"已导出 {report['written']}")
print("FAIL" if report["errors"] else "OK")
def main(argv=None):
parser = argparse.ArgumentParser(description="把成片拆成可复用的制作参考(按需,不在生产路径上)")
sub = parser.add_subparsers(dest="command", required=True)
p_measure = sub.add_parser("measure", help="一次 ffmpeg:镜头切点与响度,按文件身份缓存")
p_measure.add_argument("video")
p_measure.add_argument("--work-dir", required=True)
p_measure.add_argument("--hard-score", type=float, default=DEFAULT_HARD_SCORE,
help="scdet 分数达到它就算切点")
p_measure.add_argument("--soft-score", type=float, default=DEFAULT_SOFT_SCORE,
help="达到它且是 ±0.3s 内的孤立峰才算切点;被压下的进入待复核窗口")
p_frames = sub.add_parser("frames", help="拼帧图看画面:待复核窗口、最长镜头或任意时间段")
p_frames.add_argument("video")
p_frames.add_argument("--work-dir", required=True)
mode = p_frames.add_mutually_exclusive_group(required=True)
mode.add_argument("--review", action="store_true", help="逐帧看 measure 压下的疑似切点")
mode.add_argument("--longest", type=int, metavar="N", help="看最长的 N 个镜头里有没有漏掉的切点")
mode.add_argument("--span", metavar="A,B", help="A 到 B 秒的接触表(没有理解产物时用它看片)")
p_frames.add_argument("--step", type=float, default=2.0, help="--span 的取帧间隔秒数")
p_check = sub.add_parser("check", help="R1–R7 校验 reference_breakdown.json 并打印派生值")
p_check.add_argument("--work-dir", required=True)
p_check.add_argument("--json", action="store_true")
p_export = sub.add_parser("export", help="零 error 时写 production_reference.json(R8 复扫)")
p_export.add_argument("--work-dir", required=True)
p_export.add_argument("--out", required=True)
p_export.add_argument("--json", action="store_true")
args = parser.parse_args(argv)
try:
if args.command == "measure":
payload = measure(args.video, args.work_dir, hard=args.hard_score, soft=args.soft_score)
shots, loudness = payload["shots"], payload.get("loudness") or {}
print(f"镜头 {shots['count']} 个,中位 {shots['median_s']}s,{shots['cuts_per_min']} 切/分钟;"
f"整体响度 {loudness.get('integrated_lufs')} LUFS;待复核窗口 {len(shots['review_windows'])} 个")
return 0
if args.command == "frames":
span = None
if args.span:
start, _, end = args.span.partition(",")
span = (float(start), float(end))
if args.longest is not None and args.longest < 1:
raise ValueError("--longest 至少为 1")
mode = "review" if args.review else "span" if span else "longest"
pages = frames(args.video, args.work_dir, read_json(f"{args.work_dir}/{MEASUREMENTS_FILE}"),
mode=mode, longest=args.longest, span=span, step=args.step)
print(legend(pages) if pages else "没有要看的帧(没有待复核窗口)")
return 0
report = run_check(args.work_dir) if args.command == "check" else run_export(args.work_dir, args.out)
except (OSError, RuntimeError, ValueError) as exc:
print(f"[video-reference] {exc}", file=sys.stderr)
return 2
_print_report(report, args.json)
return 1 if report["errors"] else 0
if __name__ == "__main__":
raise SystemExit(main())
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |