Skip to content

zenstory-ai/video-recap-skills / skills/video-reference

video-reference

Verified

按需把一部优秀成片拆成可复用的制作参考:实测镜头节奏与音量起伏,标注段落与声音分工,把原片剧情事实与通用剪辑手法分开,导出不含原片人名和台词的 production_reference.json 供下次做片参考。独立于日常做片流程。触发词:拆片、拆解成片、制作参考、参考模板、production reference。

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())
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall