30秒开始做宣传片:guizang-product-video-skill 在 Claude Code 和 Codex 中安装的快速上手教程
30秒开始做宣传片:guizang-product-video-skill 在 Claude Code 和 Codex 中安装的快速上手教程
guizang-product-video-skill(归藏 product video skill) 是一个用代码制作软件版本更新宣传片的 Agent Skill:复用真实产品组件和设计语言,自动完成分镜文案、原创配乐、动作音效与视频渲染,同时支持 Claude Code 和 Codex。下面从安装到出片,带你 30 秒上手这支"AI 宣传片工具"。
它到底能帮你做什么?
| 你手里的东西 | 它会怎么处理 |
|---|---|
| 最近几周的提交、版本说明 | 找出值得讲的变化,整理成观众能懂的卖点 |
| 软件的组件和页面 | 直接接入原组件、原样式,用代码驱动动画 |
| 已有的设计语言 | 沿用产品的颜色、字体、圆角和交互风格 |
| 还很"技术"的更新描述 | 改写成白话句子:改了什么、用起来有什么不同 |
| 一支只有画面的片子 | 用代码写配乐、配独立动作音效,关键音效出现时音乐自动让位 |
一句话:把代码库交给 AI,告诉它这次更新了什么,它会帮你产出可发布的 MP4 宣传片,而不是套模板。
第一步:安装 guizang-product-video-skill(两种方法任选)
方法一:用 skills CLI 一条命令安装
在终端执行(把仓库地址替换为实际地址):
npx skills add <仓库地址> --skill guizang-product-video-skill
按提示选择你的 AI 工具和安装范围即可。
方法二:手动 git clone 到 skills 目录(推荐)
给 Codex 安装:
mkdir -p ~/.agents/skills
git clone https://gitcode.com/gh_mirrors/gu/guizang-product-video-skill.git \
~/.agents/skills/guizang-product-video-skill
给 Claude Code 安装:
mkdir -p ~/.claude/skills
git clone https://gitcode.com/gh_mirrors/gu/guizang-product-video-skill.git \
~/.claude/skills/guizang-product-video-skill
💡 安装后重新打开会话,让工具读取到新 skill。手动 clone 且没有本地修改时,可在安装目录运行
git pull --ff-only更新到最新版。
第二步:环境检查——首次使用自动完成
内置渲染管线使用 React、esbuild、Playwright 输出画面,再由 FFmpeg 编码。首次使用时,AI 会自动检查以下依赖,缺什么按官方方式补什么:
| 依赖 | 用途 |
|---|---|
| Node.js ≥ 22、npm | 构建组件、运行浏览器渲染工具 |
| Python ≥ 3.9 | 初始化工程、环境检查、配乐和混音脚本 |
| FFmpeg / ffprobe | 音频处理、视频编码和文件检查 |
| Playwright Chromium | 静帧与逐帧渲染(WebGL 走 SwiftShader) |
| React、GSAP、Three.js | 挂载真实组件、主时间轴动画、背景效果层 |
如果想手动复查环境,可运行:
python3 scripts/check_environment.py --project <video-dir> --engine browser
缺项的安装方法见 依赖安装指南。
第三步:提一句需求,开始做片
打开你的产品代码库,对 Claude Code 或 Codex 说:
用 guizang-product-video-skill,把这个项目最近三周的主要更新做成一支宣传片。横版,45–60 秒,中文。先看看代码库自己的组件和设计风格,给我看几张关键画面,再继续做动画和声音。
它会自动走完完整流程:
- 确认范围与风格——宣传哪个版本区间、发在哪个平台、什么风格
- 初始化工程并检查环境——运行 init_project.py 生成独立视频目录
- 调查产品、接通真实组件——挂载原业务组件,出第一张静帧
- 定方向——写出 DIRECTION.md 方向文件:三个候选方向、专属手法、逐秒镜头表
- 逐镜头搭建——GSAP 主时间轴 + Three.js 背景层 + 真实点击输入
- 配乐与音效——按镜头边界编曲,实测音效落点并对齐动作
- 审片导出——用 check_delivery.py 做交付检查
三种风格,第一次会让你选
| 模式 | 适合什么情况 |
|---|---|
沿用产品风格 repo(推荐) |
产品已有完整设计,希望宣传片一眼就像自己的软件 |
默认样式 default |
先用内置的 CodePilot 暖白/炭黑样式快速开始 |
混合 hybrid |
保留软件内部真实界面,外层文案和取景更适合传播 |
进阶用户可以手动初始化工程:
python3 scripts/init_project.py --output my-video --style repo --repo /path/to/your-product
你会先看到什么?一支 10 秒技术样片
初始化后不会直接出"正式片",而是先生成一支 10 秒、3 镜头的技术样片——它刻意没有风格,只验证"真实组件挂载 → 时间轴 → 任意时刻截图 → MP4"这条链路能走通(见 起步工程说明)。
确认链路没问题后,它才会按 DIRECTION.md 为你的产品重新设计画面、镜头和手法,不套同一套模板。
成片长什么样:真实组件 + 会响的声音
正式片会优先接入你软件里的原组件、原样式和真实交互,放大到视频尺度上镜:
声音同样是代码驱动:配乐用代码原创合成(或沿用你提供的曲子),点击、弹出、切换等动作配独立音效,关键反馈出现时音乐会短暂压低,让"叮咚"真正听得见:
最后会拿到什么?
- 🎬 一支可以发布的 MP4
- 🛠️ 一个可以继续修改、重新渲染的视频工程
- 🖼️ 几张关键画面,方便确认方向或后续做封面
- 📄 组件来源、素材来源、声音事件和检查记录,方便追溯
常见疑问
只能给 CodePilot 做视频吗? 不是。CodePilot 只是默认样式和流程案例,正常使用时优先接入你自己的产品组件。
是 AI 视频模型生成的吗? 不是。画面由代码、组件和时间轴渲染,配乐也由代码合成,所以文字、布局、时长、动画都可以继续改再重新导出。
给个仓库地址就能直接出片吗? 有时还需要下载仓库、补齐依赖、确认演示状态。它是一套让 AI 逐步完成作品的制作流程,不是一键转换器。
授权说明: 主仓库采用 GNU AGPL-3.0;默认样式中改编自 CodePilot 的组件保留 BSL 1.1 授权,商用前请阅读 来源说明。
下一步可以读什么
安装成功后,想深入某个环节,可以直接翻仓库文档:
- 完整工作流与硬约束:SKILL.md
- 方向文件怎么写:references/direction.md
- 视觉手法词汇表:references/visual-vocabulary.md
- 可改写的背景特效样例:assets/fx-lab/
- 内置音效与配乐合成示例:assets/audio/
把产品代码库、一句需求交给 Claude Code 或 Codex,你的下一支软件更新宣传片,30 秒后就能启动。




