guizang-product-video-skill：归藏产品视频制作技能

这是什么

「归藏产品视频制作技能」是一个面向 AI 编程工具（如 Claude Code 和 Codex）的 Agent Skill，它能把你的软件代码库变成一支产品宣传片或版本更新视频。你只需要告诉 AI 这次更新了什么，或者想介绍整个产品，它就会自动完成从卖点整理、文案撰写、组件接入、动画制作、配乐编曲、音效配音到最终视频渲染的全流程。

这个技能的核心思路是：看起来像你的产品，听得懂你在讲什么，看完不会觉得拖沓。它不会生成一段与产品无关的通用视频，而是直接复用你产品中的真实组件、设计语言和交互方式，让宣传片一眼看上去就是你的软件。

适合谁

这个技能特别适合以下人群：

独立开发者或小团队：每次发版都要做宣传片，但不想花太多时间在视频制作上。
产品经理或市场人员：需要快速产出产品介绍视频，用于社交媒体、官网或发布会的展示。
技术内容创作者：希望用代码驱动的方式制作高质量的产品演示视频，而不是依赖传统视频编辑软件。
对 AI 编程工具感兴趣的用户：已经使用 Claude Code 或 Codex，希望扩展它们的能力。

无论你是做桌面应用、Web 工具还是开发者工具，只要你的产品有代码库，这个技能就能派上用场。

能做什么

这个技能可以帮你完成以下任务：

版本更新宣传片：根据最近的提交记录或版本说明，提炼出卖点，制作一支 45-60 秒的横版视频。
产品介绍视频：从零开始介绍整个产品，适合新用户了解你的软件。
多风格适配：支持三种风格——沿用产品风格（推荐）、默认 CodePilot 样式、混合风格，你可以根据产品现状选择。
多语言支持：默认中文，也可以制作英文版，适合海外推广。
原创配乐与音效：用代码合成配乐，为操作添加独立音效，并在关键反馈时自动降低音乐音量。
可修改的视频工程：最终输出 MP4 视频，同时保留可继续修改的工程文件，方便后续调整。
封面图生成：可以生成 3:4、4:3、16:9 三种比例的封面图，风格与视频保持一致。

使用前准备

在使用这个技能之前，你需要准备以下环境：

Node.js ≥ 22 和 npm：用于构建组件和运行浏览器渲染工具。
Python ≥ 3.9：用于初始化工程、环境检查、配乐和混音脚本。
FFmpeg / ffprobe：用于音频处理、视频编码和文件检查。
Playwright Chromium：用于内置浏览器管线的静帧和逐帧渲染。
产品代码库：你需要有一个可访问的代码库，最好是 React 项目，这样接入组件会更方便。

首次使用时，技能会自动检查这些依赖，缺失的部分会提示你按官方方式安装。安装系统软件时，请遵循你的工具和系统权限设置。

安装方法

推荐使用 skills CLI 安装，在终端中运行以下命令：

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

按提示选择你的 AI 工具和安装范围。如果你使用 Codex 或 Claude Code，也可以手动安装：

Codex 手动安装：

mkdir -p ~/.agents/skills
git clone https://github.com/op7418/guizang-product-video-skill.git \
  ~/.agents/skills/guizang-product-video-skill

Claude Code 手动安装：

mkdir -p ~/.claude/skills
git clone https://github.com/op7418/guizang-product-video-skill.git \
  ~/.claude/skills/guizang-product-video-skill

安装完成后，重新打开会话，让工具读取新安装的 skill。如果需要更新，可以在安装目录中运行 git pull --ff-only（仅限手动 clone 且没有本地修改的情况）。

使用示例

安装完成后，打开你的产品代码库，对 AI 编程工具说：

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

或者直接发送仓库地址：

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

你也可以提出更具体的要求，例如：

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

技能会先确认风格，然后按照以下流程工作：

确定范围：产品、更新范围、受众、发布平台、画幅、语言和风格。
查找真实内容：查看版本与代码，核对功能状态，挂载真实组件。
确定方向：提出三个差异明显的方向，选定后开始制作。
逐镜头搭建：使用 GSAP 编排动画，Three.js 做背景层，真实组件用真实点击驱动。
配置声音：按分镜编曲，选择音色，对齐音效落点，混音。
审片并导出：查看联系表、转场和全尺寸帧，修改后导出 MP4。
可选：生成封面图。

风险与注意事项

许可证风险：本仓库采用 GNU AGPL-3.0 许可证，但其中改编自 CodePilot 的组件和样式继续适用 Business Source License 1.1，使用前请阅读 assets/fallback/SOURCE.md 和 LICENSE.CodePilot。默认样式不能随意商用，需要根据具体用途判断适用条件。
依赖环境：需要安装 Node.js、Python、FFmpeg 等依赖，首次使用可能会遇到环境配置问题，请按官方文档操作。
组件接入限制：并非所有组件都能直接接入，需要服务端、原生运行环境或复杂上下文的组件可能需要展示适配层，无法接入的界面会按源码忠实重建。
输出质量：自动检查能发现部分结构、文件和时间线问题，但文字是否好懂、画面是否舒服、声音是否合适，还需要人工观看和试听。
版权问题：接入的产品组件、Logo、字体、第三方音乐或音效，依各自适用许可使用。生成的视频不会仅因使用本工具就自动变为 AGPL 作品，若输出包含受保护的组件、素材或代码，其适用条款仍需保留和遵守。