归藏 product video skill：复用真实产品组件和设计语言，用代码制作软件更新宣传片。包含分镜文案、原创配乐、动作音效与视频渲染，支持 Claude Code 和 Codex。

归藏 product video skill – AI 辅助宣传视频制作

它是什么 – 一个用于 Claude Code 或 Codex 等 AI 编程辅助工具的“技能”（插件），能将软件仓库（或其近期更新日志）转化为短篇宣传视频。AI 会在结构化工作流程的引导下：提取最有趣的变更、重复使用产品自身的 UI 组件、撰写文案、创作或合成音乐、添加音效、使用 GSAP/Three.js 制作动画，最后导出 MP4 以及一个完全可编辑的视频项目。

谁会使用它？

使用者	帮助原因
产品开发者，刚发布新版本，需要为社交媒体、电子报或落地页制作快速且符合品牌形象的演示视频。
营销团队，希望制作看起来与产品完全一致的视频，而无需聘请设计师或视频剪辑工作室。
AI 编程工具使用者 (Claude Code, Codex, Vercel Skills)，希望为其辅助工具扩展具体且能产生价值的实用功能。

核心功能（如 README 所述）

更新日志挖掘 – 扫描近期提交/发布说明，挑选出用户导向的改进项目，并将其改写为通俗易懂的卖点。
组件重复使用 – 挂载目标仓库中的真实 UI 组件，保留颜色、字体、圆角、布局等，使视频感觉原生。
风格模式 – 三种预设：
- repo – 完全继承产品的视觉语言。
- default – 使用内置的 CodePilot“暖白/炭灰”风格。
- hybrid – 将真实 UI 与自定义外框混合。
分镜生成 – AI 建议一系列镜头（标题、功能特写、完整工作区、细节剪辑）并询问是否有遗漏的细节。
动画引擎 – GSAP 驱动时间轴；Three.js / canvas 提供背景效果；Playwright 渲染静态帧与最终视频。
音频管线 –
- 生成短音乐轨（来自用户提供的文件、本地音乐生成模型，或仓库中内置的代码合成示例）。
- 添加每个动作的音效（点击、警示、“叮”声提示），并在需要时自动降低音乐音量。
导出 – 产生：
- 可供上传的 MP4。
- 完整的视频项目文件夹（可编辑来源、时间轴、素材）。
- 用于缩略图或封面图的关键静态帧。
- 组件来源、音频授权及任何后备渲染元素的清单。

如何运行

通过 Skills CLI 安装（推荐的一行指令）：

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

或手动克隆到 Codex (~/.agents/skills) 或 Claude Code (~/.claude/skills) 的对应目录中。
首次运行会检查：
- Node ≥ 22 + npm
- Python ≥ 3.9
- FFmpeg/ffprobe
- Playwright Chromium (若缺失则自动安装)
安装后，您可以从 AI 辅助工具调用此技能，例如：

“用 guizang-product-video-skill，把这个项目最近三周的主要更新做成一支宣传片，横版 45-60 秒，中文。”
辅助工具会引导您完成所需的参数（目标版本范围、受众、平台、长宽比、语言、风格），然后继续执行自动化管线。

仓库内容

LICENSE                – AGPL-3.0 (主要代码与文档)
COMMERCIAL_LICENSING.md – 选用的商业授权联系方式
SKILL.md               – AI 工具的技能正式定义
agents/                – Codex 显示的元数据
references/            – 设计词汇、分镜模板、音频授权
scripts/               – 环境检查、音频合成、混音、验证
assets/
  starter/             – 最小化的 React + esbuild + Playwright 项目（“引擎”）
  fx-lab/              – 可重复使用的视觉效果示例（粒子、流动等）
  fallback/            – 预设的 CodePilot UI 组件 (BSL 授权)
  audio/               – 两个音乐示例轨道 + 11 个合成音效
  readme/              – 此 README 中使用的图片
tests/                 – 管线的单元与集成测试

仓库还为核心工作流程提供了 GNU AGPL-3.0 授权，并为预设的 CodePilot UI 组件提供了单独的商业源码授权 (BSL)。

限制与实务说明

此技能并非一键式视频生成器 – AI 仍需访问目标仓库、其依赖项以及可执行的构建，以便渲染真实组件。
它最适合 React 为基础的前端；其他框架可通过 integration.config.mjs 映射进行集成，但可能需要额外的胶水代码。
使用预设 CodePilot 风格的商业用途必须遵守其 BSL；您可以将其替换为自己的品牌以避免该限制。
若无本地音乐生成模型，音频生成将回退到一组预先构建的合成 WAV 文件。
输出的项目是完全可编辑的，因此您可以微调时间、替换素材，或在代码变更后重新渲染。

总结

guizang-product-video-skill 是一个真实的开源 AI 代理技能，可自动化端到端的短篇产品宣传视频制作。它结合了代码驱动的 UI 渲染、AI 撰写的文案以及程序化音频合成，旨在从 Claude Code 或 Codex 等 AI 编程辅助工具中使用。如果您需要为最近的软件发布制作快速且符合品牌形象的演示视频，此技能为您提供了一个可重现、可编辑的管线，而非静态模板。

仓库最后更新于 2026 年，采用 AGPL-3.0 授权，并提供商业授权选项。

op7418/guizang-product-video-skill