zenstory-ai/video-recap-skills / skills/video-recap
video-recap
Verified把一段或多集视频做成带画框字幕的中文解说成片或纯原声高光短片。用户提供 .mp4 / .mov / .mkv / .webm,要求做影视解说、短剧二创、加旁白配音、跨集混剪或导出剪映草稿时使用;串联完成看片识台词、定主线与留原声、按台词停顿切镜头、写词检查、TTS 配音与混音加字幕。触发词:视频解说、影视解说、视频旁白、生成解说、视频 recap、video recap、voiceover、narration、recap。
scripts/recap_source.py
View on GitHub"""Validate recap audio ownership and routing."""
from pathlib import Path
AUDIO_MODES = ("narration", "source-mix")
_TTS_OPTIONS = frozenset({
"--tts-provider",
"--mimo-tts-voice",
"--voice-ref",
"--allow-partial-tts",
})
def uses_narration(args):
return args.audio_mode == "narration"
def audio_binding(args):
return {
"mode": args.audio_mode,
# Constant: resume compares this record against the manifest of older runs.
"selected_stream_index": 0,
}
def reject_unbound_narration_workdir(work_dir, args):
"""Do not reinterpret an unbound narrated work directory as source-owned audio."""
work_dir = Path(work_dir)
if (
not uses_narration(args)
and not (work_dir / "recap_run_manifest.json").exists()
and (work_dir / "narration.json").exists()
):
raise SystemExit(
"当前 work_dir 含 narration.json 但缺少可验证的音频运行策略;"
"非解说模式请使用新的 --work-dir"
)
def validate_audio_routing(parser, args):
"""Reject combinations the current pipeline cannot execute truthfully."""
mode = args.audio_mode
# index-tts + MiMo voice/--voice-ref is rejected once, in recap_runner.main, after the
# ambient VOICE_REF/MIMO_TTS_VOICE have been folded in.
if mode == "narration":
return
conflicts = sorted(set(args._explicit_options).intersection(_TTS_OPTIONS))
if conflicts:
detail = ", ".join(conflicts)
parser.error(f"--audio-mode {mode} 不能使用配音/解说参数 (cannot use TTS): {detail}")
# Environment defaults are irrelevant once source audio owns the run. Normalizing
# prevents an invalid ambient provider from leaking into later state or continuation.
args.tts_provider = "auto"
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: 196k | 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: 196k | 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: 196k | Updated | Claude CodeCodex | Verified | Install |