Communitygithub.com

Potatolclulu/broadcast-news-video

Create editable TV news videos with code graphics and optional voiceover. Use for broadcast news, ticker videos, or news-style explainers. Do not use for avatar generation or footage editing.

What is broadcast-news-video?

broadcast-news-video is a Claude Code agent skill that create editable TV news videos with code graphics and optional voiceover. Use for broadcast news, ticker videos, or news-style explainers. Do not use for avatar generation or footage editing.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Potatolclulu/broadcast-news-video-skill/tree/HEAD/skills/broadcast-news-video

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Broadcast News Video

把新闻文稿做成可编辑的电视新闻包装。默认纯代码画面:点阵地球片头、深蓝底、玫红强调、白色标题条、滚动信息和双语字幕。使用本 Skill 的脚本生成 HyperFrames 工程。

先确定内容

  • 复用用户已给出的题材、比例和音色方案。默认 1920×1080、30fps、配音保持音高加速 1.3 倍。
  • 对真实新闻核验原始来源,写明发布时间、事件时间与核验时间;区分媒体判断、官方确认、预计结果和制度说明。将链接保存在工程旁的 FACTS.md。
  • 画面引用实际数据时标明来源。示意点阵写“示意”,不要让示意数量看起来像真实结果。
  • 对照 制作规则 写短句口播和每场镜头。字幕不显示逗号、句号。
  • 未被要求时不用数字人或视频生成服务。不得默认调用积分型视频生成器。

建工程

在命令中把 SKILL_DIR 设为本文件所在目录,把 WORK_DIR 设为用户的独立输出目录。不要把生成物写入 Skill 目录。

python3 -m pip install -r "$SKILL_DIR/scripts/requirements.txt"
python3 "$SKILL_DIR/scripts/setup.py" --output "$WORK_DIR"

将 assets/example.json 复制为工程的 brief.json,按 配置约定 改为用户内容。示例明确标记为虚构演示。更换频道名、日期、标题、信息条及镜头数据,不保留示例的叙事。

无配音预览:

python3 "$SKILL_DIR/scripts/build.py" --brief "$WORK_DIR/brief.json" --output "$WORK_DIR"

build.py 根据 JSON 生成片头及 cards、dots、flow、quote 场景、单一字幕轨、SRT、时间轴和合成背景音乐。所有可见文字经过 HTML 转义,动效由暂停的 GSAP 时间轴驱动。

配音可选

优先使用用户已有、获准使用的逐场音频与字幕,不上传私人声音到公共仓库。音频放在输出目录的 voice/ 下。每场 voice 指定相对于 brief 的文件路径;captions 使用原始录音中的秒数,构建时统一除以 speed。

若用户要求 MiniMax 配音,使用外部环境变量 MINIMAX_API_KEY 和用户指定的 --voice-id。不得在 JSON、脚本、文档、命令行参数中放密钥,不打印密钥或保存原始 API 回执。此接口可能收费;仅在用户已授权配音时执行。

python3 "$SKILL_DIR/scripts/voice.py" --brief "$WORK_DIR/brief.json" --output "$WORK_DIR/voice" --dry-run
python3 "$SKILL_DIR/scripts/voice.py" --brief "$WORK_DIR/brief.json" --output "$WORK_DIR/voice" --voice-id "$MINIMAX_VOICE_ID" --execute
python3 "$SKILL_DIR/scripts/build.py" --brief "$WORK_DIR/voice/brief.voiced.json" --output "$WORK_DIR"

正常生成后保持音高变速;字幕同步变速,音乐仍以 1 倍播放。不要在渲染端再加速一次。付费请求失败或结果未知时停止,不自动重试。实际接口时间戳已返回时必须使用;不得把字符比例估算的时间伪称精确字幕。

检查和交付

需要 Node.js 22+、FFmpeg/FFprobe。已实测 HyperFrames 0.9.23。

npx --yes [email protected] check "$WORK_DIR" --json
npx --yes [email protected] snapshot "$WORK_DIR" --at 1.5,5,10
npx --yes [email protected] preview "$WORK_DIR" --background
npx --yes [email protected] render "$WORK_DIR" --quality delivery --output "$WORK_DIR/news.mp4"
  • 修复 lint/runtime/layout 错误;逐场查看中点截图,检查标题、来源、字幕、滚动条及点阵含义。
  • snapshot --at 的时间改为 timeline.json 中真实场景中点。
  • 若用户要求成片或已授权连续执行,检查通过后继续渲染;否则提供可编辑预览。
  • 用 FFprobe 核对 MP4 时长、分辨率、帧率与音轨;用 FFmpeg 检查解码错误。试听口播与混音,未试听就如实说明。
  • 交付 MP4、final.srt、截图和可编辑工程,保留事实说明与素材许可证。

公开分享

仅打包 Skill 及中性示例。排除个人音频、原视频、凭据、私有文稿、API 回执、绝对本机路径、品牌资产和私人音色 ID。先运行 scripts/audit.py 扫描待发布目录;再检查 Git 已跟踪文件和提交身份,不能只依赖 .gitignore。

本 Skill 原创内容使用 assets/LICENSE-MIT.txt;下载的 GSAP、字体与地图保留各自许可,见 第三方说明。

Related Skills