one-prompt-video-skills — 一句话成片：Claude Code 视频生产 Skill 套装

技能简介

one-prompt-video-skills 是把 Claude Code 变成"个人剪辑团队"的一套 Agent Skills，让 AI 自己写稿、用本人照片 + 本人声音生成口播数字人、生成 B-roll、做 HyperFrames 合成、分段渲染并抽帧自检，最终输出社媒可发的口播视频。整个流程只需对 Claude Code 说一句"帮我做一条口播视频"即可启动。仓库内包含三个独立但可串联的 Skill，覆盖写稿、口播+合成+出版、代码动画三大场景。

整套 Skill 完全开源，把"AI 视频生产"从依赖 SaaS 的云端工具，搬到本地 CLI + Claude Code 的工作流里：所有中间产物（脚本、分镜、抽帧 PNG）都可审计、可复用、可二次剪辑。

核心能力

• 一句话成片 Skill（one-prompt-video）：把"写稿 → 口播数字人 → B-roll → HyperFrames 合成 → 分段渲染 → 抽帧检查 → 按平台出版本"全流程串成一个 Claude Code 命令；附检查卡帧/停顿、哔声、分段渲染三个辅助脚本
• 写稿 Skill（huangbai-script）：从往期视频提炼的口播结构、固定句式、幽默节奏，输出"阶段｜口播｜画面"三列分镜表，让口播稿风格统一、不再逐条手写
• 代码动画 Skill（opus-code-animation）：时间轴、档案卡、流程图这类说明动画，用代码逐帧绘制并导出 MP4；适合课程、技术讲解、产品演示中需要"动起来"的示意
• 本人照片 + 本人声音数字人：通过即梦 CLI 把上传的人像照片与声音样本合成数字人口播，无需真人出镜
• HyperFrames 合成：用 npx hyperframes 把口播、B-roll、字幕、转场合成为成片，支持多分辨率、多时长输出
• 抽帧自检：在合成后用 ffmpeg 抽帧、whisper.cpp（whisper-cli）逐字核对台词、检查停顿与哔声，确保成片无错口、无空镜、无明显卡顿

安装配置

1. 克隆仓库：git clone https://github.com/huangbai-AI/one-prompt-video-skills.git
2. 复制到 Skills 目录：把 one-prompt-video/、huangbai-script/、opus-code-animation/ 三个文件夹复制到 ~/.claude/skills/ 下，重启 Claude Code 即可识别
3. 安装系统依赖：
   • ffmpeg（视频处理）
   • Python 3 + numpy（抽帧检查、音频处理）
   • whisper.cpp 提供的 whisper-cli（逐字核对台词）
   • 即梦 CLI（生成口播数字人，会消耗即梦积分）
   • npx hyperframes（HyperFrames 合成与渲染，需 Node.js）

使用步骤

1. 一句话发起：在 Claude Code 里说"帮我做一条口播视频，主题是 XXX"，one-prompt-video Skill 自动接管，把任务拆成"写稿 → 口播 → B-roll → 合成 → 检查"
2. 写稿（huangbai-script）：Skill 输出"阶段｜口播｜画面"三列分镜表，按节奏与句式风格生成完整口播稿，确认后进入下一步
3. 口播数字人：用本人照片 + 本人声音样本调即梦 CLI，生成与本人音色/形象一致的口播数字人视频
4. 生成 B-roll：基于分镜表的"画面"列生成对应的 B-roll 镜头（可用 opus-code-animation 生成说明动画，或调外部模型生成素材）
5. HyperFrames 合成：用 npx hyperframes 把口播、B-roll、字幕、转场合成为完整视频，支持按平台选 16:9 / 9:16 / 1:1
6. 抽帧自检：用 ffmpeg 抽帧 + whisper-cli 逐字核对台词，检查停顿、哔声、错口，输出自检报告
7. 按平台出版本：自动产出 X、小红书、抖音、B站、YouTube 等多分辨率版本，直接上传

适用场景

• 个人 IP / 自媒体口播视频：用本人数字人形象批量生产短视频，无需每次出镜，保留本人音色与外形
• 技术博客/教程视频化：把一篇博客或一篇教程自动转成带分镜、口播、B-roll 的讲解视频
• 产品演示 / 客户案例：把产品文档/客户案例转成 60-120 秒的口播+B-roll 视频，发给客户或社媒
• 课程内容生产：MOOC、企业培训、内部知识库的"视频化"批量产出
• 播客/访谈二次剪辑：把长访谈转成片段化的短视频，挂载到推文/小红书引流

适用人群

• Claude Code / Codex / Cursor 等 AI 编程 Agent 的中重度用户，想把 Agent 工作流延伸到视频生产
• 不想真人出镜、但需要"个人 IP"形象的自媒体博主、知识类小红书博主、Twitter 创作者
• 课程作者、企业培训负责人、产品市场团队，需要批量把文字素材转成视频
• 独立开发者与小团队，希望用最低成本（本地 CLI + 积分）量产短视频

工作原理

三个 Skill 通过 SKILL.md 描述被 Claude Code 自动加载与调用。one-prompt-video 是"流程编排者"，把任务拆成"写稿 → 口播数字人 → B-roll → 合成 → 自检 → 出版"流水线；huangbai-script 负责结构化产出"阶段｜口播｜画面"三列分镜；opus-code-animation 用代码逐帧绘制说明动画并导出 MP4。数字人通过即梦 CLI 把本人照片 + 声音样本合成；HyperFrames 用 Node.js 把多路素材（口播、B-roll、字幕、转场）按时间轴合成；whisper-cli 在抽帧后逐字比对台词，把错口、停顿、哔声等质量问题暴露给 Agent 反馈循环。整个流程中 Claude Code 既写稿又调度外部 CLI，最终输出多平台、多分辨率的成片。

官方链接

• GitHub 仓库：
• 完整文字版教程：（飞书文档）
• 即梦 CLI：用于生成口播数字人（消耗积分）
• HyperFrames：通过 npx hyperframes 安装与使用
• whisper.cpp：whisper-cli 工具，用于台词逐字核对

代码以开源形式提供，使用前请确认即梦 CLI 的积分与服务条款；视频中的人物形象与声音样本请使用本人素材或已获授权的素材，规避肖像权风险。