跳到主要内容
中文
← 技能
技能 · 代码仓库

先看三套方案,再选一套做成视频 xilo-opus-video

先比较三套视频方案和预览,再选定方向制作成片。xilo-opus-video 让 Claude Opus 5.5 编写动画代码,渲染成 MP4,并保留可修改的工程和可复用的制作方案。

  • code-animation
  • video
  • claude-opus-5-5
  • agent-skill

可用于 Claude Code

前置要求

  • Python >=3.9
  • NumPy
  • Playwright (Python)
  • FFmpeg / ffprobe
  • Chrome / Chromium

概览

你会得到什么

  • 三套不同的视频方案,每套附一张关键帧或一段动态预览。
  • 记录已确认创作方向和镜头安排的 brief.md,方便复用。
  • 可修改的动画工程、音频素材、检查用静帧和 MP4 成片。

适用场景

  • 在正式渲染前比较不同画风和叙事方式。
  • 用代码制作产品视频、知识讲解、界面动效和风格化动画。
  • 参考现有视频的结构与节奏,换成自己的内容。

不适用

  • 直接调用视频模型生成写实影像。
  • 在剪映、Premiere 或 After Effects 中剪辑现有素材。
  • 给已有视频添加字幕。

教程

先看三套方案,再决定怎么拍

想做一条产品视频,却还说不清应该用什么画风?xilo-opus-video 会先提出三个不同方向,每套附关键帧或几秒动态预览。你看过后选一套,或提出组合、修改意见,再让 AI 制作整片。

上方是 @Cryptoxorz 用它制作的八款视频技能介绍片,仓库作者是 Kianzzz(周行)。介绍第一个技能时,片中展示了三种方案,可以比较同一主题的不同呈现方式。整段视频是成品示例,不是三套预览的直接导出。

这个技能的重点是在制作整片前确定方向。Claude Opus 5.5 负责规划、编写和修改动画代码,浏览器与 FFmpeg 负责渲染成片;它不是直接输出视频画面的生成模型。下面以一条产品短片为例,练习说明需求、选择方案,再换上自己的内容。

安装技能,检查渲染工具

作者提供的安装命令在终端执行:

npx skills add Kianzzz/xilo-opus-video

按安装器提示选择 Claude Code 的安装位置。渲染还需要 Python 3.9+、NumPy、Python 版 Playwright、FFmpeg 和可用的 Chromium 或 Chrome;安装器自身的 Node.js 要求与技能的 Python 要求是两回事。

如果想手动安装,也可以直接复制技能目录:

git clone https://github.com/Kianzzz/xilo-opus-video.git
mkdir -p ~/.claude/skills
cp -r xilo-opus-video/skills/xilo-opus-video ~/.claude/skills/
# 检查渲染所需的本机工具
python3 ~/.claude/skills/xilo-opus-video/scripts/check_env.py

两种安装方式任选一种。首次使用时,技能也会运行环境检查;缺什么先按提示补齐。Python 依赖是 numpy 和 playwright,浏览器安装使用 python3 -m playwright install chromium。若系统限制全局安装 Python 包,可使用虚拟环境,并确保启动 Claude Code 的终端已激活该环境。具体动画框架可能另有依赖,先看方案再决定是否安装。

这些命令已按仓库说明和源码核对,本次收录没有实际安装上游依赖或运行视频渲染。

说清目标,让三套方案各有特点

不要只说“做得高级一点”。先告诉 AI 观众是谁、看完要记住什么,以及哪些素材是现成的。这里假设要介绍一个预约工具,只讲“选择时间→填写信息→收到确认”这条流程。

把下面的需求发给 Claude Code。以下对话示例由本站编写,尚未实际生成视频验证,并非作者原始提示词。

使用 xilo-opus-video 做一条 15 秒产品短片。
产品是预约工具,观众是第一次使用它的顾客。
要讲清楚:选择时间、填写信息、收到确认。
我会提供产品 Logo、截图和确认过的文案;缺少素材时先列出来。
16:9,不配音,用代码合成配乐。
请给三套明显不同的方案,分别说明镜头安排、画风、技术路线、声音和预计渲染耗时。
每套先做一张关键帧;需要看运动才能判断的方案,改做 2–4 秒预览。
暂不做整片,不要添加资料里没有的功能或效果承诺。

比较时不要只挑“最漂亮”的图。界面动效能否看清操作顺序?风格化方案是否还认得出产品?长镜头方案能否在短时间里讲完信息?好的选择应让画面帮助观众理解产品,而不只是换颜色。

要比较的内容看预览时问自己
信息主次不读旁边的说明,能否认出这一镜要讲什么?
风格与产品画风是否适合观众,产品是否仍是主角?
运动方式如果方案主要靠转场或镜头运动来表现,是否已有动态预览?
制作成本方案的耗时是否根据预览估算,缺少的素材是否列明?

关键帧能判断构图,不能判断整片节奏。若两套方案的主要差别是运动方式,先看短预览再选择。

选定方向,把决定写进 brief.md

例如你喜欢方案 B 的风格,但想保留方案 A 的流程表达,可以这样说:

选方案 B 的视觉风格,使用方案 A 的三步流程安排。
先给我看合并后的镜头安排,确认后写入 brief.md。
把产品名称、截图来源、各镜头时长、配乐方式和输出规格写清楚。
沿用已确认的 Logo 和文案,不增加新功能描述。

确认后的 brief.md 是后续制作的依据,也可以作为下一期的起点。默认工程放在当前工作目录的 opus-video/<项目名>/:原始素材在 source/,方案预览在 previews/,画面代码通常是 index.html;采用特定框架时则保存对应工程。

先看 brief.md 有没有把你的选择写准。如果这时还没确定片子到底讲什么,先改方案;不要让 AI 一边渲染整片,一边猜你的方向。

先检查镜头,再看整片

继续要求 AI 按已确认的方案制作,每个镜头先给静帧检查。重点看主体大小、文字是否溢出、信息是否停留足够久。各个镜头完成后,先看低分辨率预览,确认节奏和转场,再出正式版。

按 brief.md 制作首版。逐镜头检查开头、中间和结尾的静帧,先修复遮挡与文字越界。
先给我看整片预览,确认三个步骤能看清、配乐与动作同步,再渲染正式版。
交付 MP4、brief.md、可修改的工程及检查记录,并说明已知不足。

它的网页动画通过 window.render(t) 指定某一时刻的画面,渲染脚本逐帧截图,再合成视频。这样可以单独检查或重做某个时间段。默认流程不要求你手写这个接口,让 AI 按技能规范生成即可。

正式输出一般在 opus-video/<项目名>/out/,声音文件在 audio/,检查用图片和记录在 qa/。最终文件名以这次工程实际交付为准;技能文档中既有 video.mp4 也有 final.mp4 的示例,不要只按一个固定文件名寻找成片。

播放时检查两件静帧无法回答的事:动作与声音是否同步,文字是否刚出现就被切走。配音需要额外的语音工具和相应配置;本例选择不配音,避免一开始就增加制作环节。

改一处,保留已经满意的部分

首版中如果产品截图太小,可以明确要求局部调整:

只修改展示预约页面的镜头:放大截图,让可选时段在手机尺寸预览中也看得清。
保留已确认的文案、镜头顺序、配色和总时长。
先给我这一镜的新静帧,再渲染对应片段;确认后重新输出整片。
同步更新 brief.md 和检查记录。

这是构图变化,不需要重新设计全部方案。若你把目标从“介绍操作流程”改成“宣传新功能”,观众要记住的信息也变了,应回到方案和分镜阶段,而不是只替换几个大字。小改动先控制范围,目标变化再重新规划。

换成你自己的产品或内容

先填完这份需求,再让 AI 提出三套方案:

使用 xilo-opus-video 制作视频。
观众:[谁会看,已经知道什么]
观看目的:[看完要记住或会做的一件事]
内容与事实:[文章、产品资料或确认过的文案]
现有素材:[Logo、截图、音乐、参考视频及路径]
参考重点:[想借鉴的结构、节奏或画面手法]
规格:[时长、画幅、是否配音、配乐方式]
必须保留:[品牌色、关键措辞、素材限制]
先给三套不同方案及预览,选定后再写 brief.md、制作和渲染。

参考视频可以帮助说明节奏和风格,但产品信息仍应来自你提供的资料。换主题时保留有用的镜头结构,重新核对文案、素材、时长和声音;不要只替换标题,就沿用旧片里不属于新产品的功能。

更多细节见作者的方案格式、制作规范与技能说明。仓库为 MIT 许可,第三方音乐、Logo 和参考素材的使用权需分别确认。