30秒开始做宣传片:guizang-product-video-skill 在 Claude Code 和 Codex 中安装的快速上手教程

原创2026-10-25 13:28:341,939 阅读

30秒开始做宣传片:guizang-product-video-skill 在 Claude Code 和 Codex 中安装的快速上手教程

guizang-product-video-skill(归藏 product video skill) 是一个用代码制作软件版本更新宣传片的 Agent Skill:复用真实产品组件和设计语言,自动完成分镜文案、原创配乐、动作音效与视频渲染,同时支持 Claude Code 和 Codex。下面从安装到出片,带你 30 秒上手这支"AI 宣传片工具"。

归藏 product video skill:软件更新后自动做宣传片的开场画面

它到底能帮你做什么?

你手里的东西 它会怎么处理
最近几周的提交、版本说明 找出值得讲的变化,整理成观众能懂的卖点
软件的组件和页面 直接接入原组件、原样式,用代码驱动动画
已有的设计语言 沿用产品的颜色、字体、圆角和交互风格
还很"技术"的更新描述 改写成白话句子:改了什么、用起来有什么不同
一支只有画面的片子 用代码写配乐、配独立动作音效,关键音效出现时音乐自动让位

一句话:把代码库交给 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 秒,中文。先看看代码库自己的组件和设计风格,给我看几张关键画面,再继续做动画和声音。

它会自动走完完整流程:

  1. 确认范围与风格——宣传哪个版本区间、发在哪个平台、什么风格
  2. 初始化工程并检查环境——运行 init_project.py 生成独立视频目录
  3. 调查产品、接通真实组件——挂载原业务组件,出第一张静帧
  4. 定方向——写出 DIRECTION.md 方向文件:三个候选方向、专属手法、逐秒镜头表
  5. 逐镜头搭建——GSAP 主时间轴 + Three.js 背景层 + 真实点击输入
  6. 配乐与音效——按镜头边界编曲,实测音效落点并对齐动作
  7. 审片导出——用 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"这条链路能走通(见 起步工程说明)。

技术样片标题镜头:What's new 这次更新带来了什么

技术样片组件镜头:把真实产品组件直接接进来演示

确认链路没问题后,它才会按 DIRECTION.md 为你的产品重新设计画面、镜头和手法,不套同一套模板。

成片长什么样:真实组件 + 会响的声音

正式片会优先接入你软件里的原组件、原样式和真实交互,放大到视频尺度上镜:

软件宣传片接入真实产品组件的镜头:Your UI In motion

声音同样是代码驱动:配乐用代码原创合成(或沿用你提供的曲子),点击、弹出、切换等动作配独立音效,关键反馈出现时音乐会短暂压低,让"叮咚"真正听得见:

软件宣传片声音设计:原创配乐与动作音效让位的时间轴

最后会拿到什么?

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

常见疑问

只能给 CodePilot 做视频吗? 不是。CodePilot 只是默认样式和流程案例,正常使用时优先接入你自己的产品组件。

是 AI 视频模型生成的吗? 不是。画面由代码、组件和时间轴渲染,配乐也由代码合成,所以文字、布局、时长、动画都可以继续改再重新导出。

给个仓库地址就能直接出片吗? 有时还需要下载仓库、补齐依赖、确认演示状态。它是一套让 AI 逐步完成作品的制作流程,不是一键转换器。

授权说明: 主仓库采用 GNU AGPL-3.0;默认样式中改编自 CodePilot 的组件保留 BSL 1.1 授权,商用前请阅读 来源说明。

下一步可以读什么

安装成功后,想深入某个环节,可以直接翻仓库文档:

把产品代码库、一句需求交给 Claude Code 或 Codex,你的下一支软件更新宣传片,30 秒后就能启动。

登录后查看全文
guizang-product-video-skill