归藏 product video skill

软件更新了，顺手把宣传片也做了。

把代码库交给 AI，告诉它这次更新了什么，或者想介绍整个产品，就可以开始做一支宣传片：整理卖点、写文案、接入原组件、做动画、写配乐、配音效，最后导出视频和可继续修改的工程。

我把自己做 CodePilot 宣传片时反复打磨的流程，整理成了这个 skill。重点是三件事：看起来像你的产品，听得懂你在讲什么，看完不会觉得拖沓。

30 秒开始

在终端安装：

npx skills add https://github.com/op7418/guizang-product-video-skill --skill guizang-product-video-skill

然后打开你的产品代码库，对支持 skill 的 AI 编程工具说：

用 guizang-product-video-skill，把这个项目最近三周的主要更新做成一支宣传片。横版，45–60 秒，中文。先看看代码库自己的组件和设计风格，给我看几张关键画面，再继续做动画和声音。

也可以直接把仓库地址发给它：

帮我安装这个 skill：https://github.com/op7418/guizang-product-video-skill ，然后用它给当前项目做一支版本更新宣传片。

首次使用会检查 Node.js、Python、FFmpeg 和渲染依赖，缺什么再按官方安装方式补什么。安装系统软件时，仍遵循你的工具和系统权限设置。

它能帮你做什么？

你手里的东西	它会怎么处理
最近几周的提交、版本说明	找出值得讲的变化，整理成几组观众能理解的卖点
软件的组件和页面	优先直接接入原组件、原样式和演示状态，再用代码驱动动画
已经有一套不错的设计	沿用产品的颜色、字体、圆角、层次和交互语言
暂时没有成熟的宣传视觉	用内置的 CodePilot 暖白／炭黑样式组织外层画面
几句很技术的更新描述	写成完整的白话句子，让人知道改了什么、用起来有什么不同
一支只有画面的片子	为本片用代码写配乐，给操作配独立音效，并在关键音效出现时压低音乐

画面由代码渲染，能继续修改。标题、功能特写、完整工作区和细节镜头交替出现，既有大字文案，也留出看清操作的时间。

三种风格，先选适合你的

第一次制作时，AI 会先确认风格。已经说过的选择会沿用，不需要每次重新回答。

模式	适合什么情况
沿用产品风格 repo · 推荐	产品已有完整设计，希望宣传片一眼就像自己的软件
默认样式 default	想先用 CodePilot 的暖白、炭黑、卡片层次和中英文排版开始制作
混合 hybrid	保留软件内部的真实界面，把外层文案、取景和节奏做得更适合传播

三种模式的功能镜头都会优先用原产品组件。默认样式主要负责外层排版和视觉包装；接入受平台或框架限制时，会说明原因和替代方式。

英文标题与中文说明分开指定字体。英文负责节奏和排版，中文把事情说清楚；也可以直接要求全中文或全英文。

怎么提需求，比较容易一次做好？

不需要写一份很长的 brief，把介绍什么、给谁看、发在哪里说清楚就够了。

做一支版本更新片

介绍 v2.1 到 v2.4 的主要更新，优先讲多模型切换、文件预览和浏览器操作。发 B 站，横版 50 秒左右。沿用我们的产品设计，文案口语化一点，不要把提交记录逐条念出来。

给海外用户看

做一支英文版 changelog promo，45 秒，主要面向第一次接触产品的人。先解释这几个更新能解决什么问题，再展示操作。保留产品原组件和字体。

先看方向再做成片

先整理卖点、分镜和四张真实渲染的关键画面。风格用默认 CodePilot 样式，中文配英文标题，等我确认后再做完整动画。

修改已经做好的片子

模型选择那一段太慢了，压缩到三秒。通知出现时加一个清楚的叮咚声，音乐让一下。最后去掉官网地址，浏览器里能看出链接的地方也遮掉。

不用一次把所有信息填完；已有上下文会继续使用，影响制作的缺项才会问你。

从代码库到成片

1. 先定范围。 确认产品、更新范围、受众、发布平台、画幅、语言和风格，有参考视频就一起给。
2. 找真实内容。 查版本与代码，核对功能状态，把真实组件挂载起来，按视频尺度放大上镜。
3. 先定方向。 拆解参考，提炼产品气质，提出三个差异明显的方向并选定；每个视觉手法都要说得出"因为产品有什么"；把字号、界面倍数、镜头表写成具体数字，再动手。
4. 逐镜头搭建。 GSAP 主时间轴编排动画，Three.js / canvas 做背景层，真实组件用真实点击和输入驱动；每个镜头搭完就出静帧对照。
5. 把声音配好。 按分镜编曲、按产品气质选音色，音效先用录音素材，实测落点后对齐动作，混音并处理音乐让位。
6. 审片，再导出。 看联系表、看每个转场、看信息密集的全尺寸帧，改完重新导出。
7. 需要的话做封面。 3:4、4:3、16:9 三种比例，画面语言沿用这支片子，只用片中真实渲染的画面。

每支片子的手法都从产品本身推导出来，不是套同一个模板：同样的流程，给笔记产品和给开发者工具做出来的片子应该完全不一样。

同一套流程，三支不一样的片子

下面三支片子用的是同一套流程，画面和声音却完全不同：每支片子都先回答"这个产品有什么"，再决定"所以画面怎么做"。

产品	从产品里找到的东西	所以这支片子这样做	声音
CodePilot（桌面 AI 编程客户端）	接入多家模型服务商；深色、有质感的桌面应用	暗色舞台和银白光弧；粒子汇成标志；服务商围绕产品旋转；看板飞越	120 BPM 电影感电子
Zed（多人协作代码编辑器）	编辑器本身就是主角；队友光标实时出现	浅色一镜到底，镜头一直在编辑器里走；标题是敲出来的代码注释；队友光标带路，最后画出标志	128 BPM 马林巴打击乐
T3 Code（开源的 coding agent 控制台）	定位是 "control plane"；自带 5 套主题；每个 harness 各有一条登录命令	全片是一块 3×3 控制台面板，镜头推进哪张卡片就进入哪一章；每章换一套产品内置主题色；开场五个终端敲五条登录命令，再被吸进面板	96 BPM lo-fi 电钢琴

同一个工作区连续做片时，也会避开上一支用过的开场、转场和背景手法。

默认起点是 45–60 秒、横版、中文。你可以调整时长和画幅；竖版需要重新安排取景和文字，通常不会直接裁掉左右两边。

音乐和音效怎么来？

音乐按顺序选：你给的曲子 → 本机真的能跑的音乐生成模型 → 代码原创合成。 代码合成时保留编曲源码，按本片的镜头边界排段落、按产品气质选音色。仓库里有两种气质的合成示例（轻快键盘、电影感电子），借的是手法，不是曲子。

音效先找合适的，再用内置素材补缺。 先搜索可用素材库并记录来源、许可和适合的动作；没有合适素材的类别，再使用随包提供的 11 个代码合成 WAV，或调整合成参数。

音乐和音效分开混。 点击、弹出、切换、完成提醒等动作有独立的音效事件。关键反馈出现时音乐会短暂降低，让叮咚、确认和转场真正听得见。

最后会拿到什么？

• 一支可以发布的 MP4。
• 一个可以继续修改、重新渲染的 视频工程。
• 几张关键画面，方便确认方向或后续做封面。
• 组件来源、素材来源、声音事件和检查记录，方便以后追溯与调整。

自动检查能发现部分结构、文件和时间线问题；文字是否好懂、画面是否舒服、声音是否合适，还需要实际观看和试听。工程会区分已经验证的内容和仍有条件限制的部分。

安装与更新