1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | guizang-product-video-skill |
| 项目自述名称 | 归藏 product video skill |
| 作者/维护者 | op7418(归藏,产品设计师,GitHub 个人账号) |
| 来源链接 | https://github.com/op7418/guizang-product-video-skill |
| 许可证 | AGPL-3.0(skill 正文与脚本);默认暖白/炭黑视觉素材另适用 BUSL-1.1,详见仓库 README(来自 GitHub API + 仓库内 LICENSE 说明) |
| GitHub Stars | 534(GitHub API) |
| Forks | 48(GitHub API) |
| 最新版本 | 未发布正式 Release/Tag,随仓库主分支滚动更新(GitHub API) |
| 安装方式 | npx skills add https://github.com/op7418/guizang-product-video-skill --skill guizang-product-video-skill |
2. 功能介绍与亮点
把一个软件仓库最近的更新,做成一支用代码渲染的宣传片:从产品自身的组件、配色、圆角和交互语言里提炼视觉手法,而不是套固定模板;镜头接入真实业务组件(补 provider、用 fixture 接口、真实点击和输入放大到视频尺度),配乐与音效可选“用户提供 → 本机生成模型 → 代码合成”三种来源,优先不依赖外部付费服务。流程强制先出“方向文件”(DIRECTION.md:拆解参考、提炼产品气质、给出镜头表),再逐镜头搭建,交付前有分辨率联系表、转场条带等审片环节。核心卖点是“每支片子的视觉手法都能说出对应产品的哪一点”,用结构化流程约束 AI 不去生成千篇一律的通用宣传动画。
3. 适用场景
固定分类:内容创作与知识管理。
适合已有一定研发节奏、需要为版本更新或产品发布制作宣传片/功能演示视频的团队,尤其是没有专职视频制作人力、但希望宣传片“看起来像自己的产品”而非通用模板动画的独立开发者与小型产品团队。典型触发场景:发新版本前做一支 45–60 秒的更新预告片、给官网或发布帖配一支功能演示短片。
4. 跨 Agent 兼容性
- Claude Code:原生支持(仓库徽章与安装说明明确标注)。
- Codex:原生支持(仓库徽章明确标注 “Codex supported”)。
- OpenClaw:未验证——仓库未提及,安装方式为通用
npx skills add命令,理论上可尝试但无官方说明。 - Hermes Agent:未验证——SKILL.md 为标准 YAML front matter + 指令正文格式,Hermes 按目录扫描发现 SKILL.md 的机制理论上可识别,但未实测确认。
5. 推荐理由
它解决的是一个具体、高频的真实需求——版本更新宣传片——而不是泛化的“视频生成”;流程把“看起来像你的产品”作为硬约束,强制接入真实组件而非通用素材库,输出物包含可继续修改的工程文件而非一次性成片。方向文件、镜头表、审片检查等步骤把创作过程结构化,降低了“AI 生成千篇一律宣传片”的常见问题。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 534 stars(11 天内,作者为拥有约 5000 粉丝的资深设计师/GitHub 账号,2015 年注册);独立第三方博客 OrcaRouter 发表专文评测,另有外部贡献者提交真实文档改进 PR,被第三方视频技能聚合仓库收录 |
| 可用性 | 8 | 一条 npx skills add 命令安装;文档含分步说明、环境自检脚本、示例镜头表;仓库 4 天前仍有提交,维护活跃;优先使用本机免费方案,不强制付费依赖 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单:
| 序号 | 检查项 | 结果 |
|---|---|---|
| ① shell 命令及权限范围 | 本地运行 Python/Node 脚本渲染视频、调用 ffmpeg 混音,权限范围明确且可审计 | |
| ② 运行时联网外发 | 默认不依赖外部付费 API;音乐可选调用本机可用生成模型,外联目标透明 | |
| ③ API key/凭据 | 无强制凭据要求 | |
| ④ 可疑指令 | 未发现夹带私货或 prompt injection 迹象 | |
| ⑤ 作者信誉 | 个人开发者,长期活跃账号,fork 时间分布跨多日无刷星迹象 | |
| ⑥ License | AGPL-3.0,明确;默认视觉素材另适用 BUSL-1.1,README 已单独说明 | |
| ⑦ 最近维护 | 近一周内有提交,活跃 |
综合评分:7.67
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| video-shotcraft | 提供 152+ 组镜头语言模板卡与 Remotion 生产模板,面向“从零搭建”影片 | 偏“素材库+模板”路线,产品接入需要自行完成;本技能则强制从目标产品的真实组件和设计语言反推手法 |
| claude-remotion-skill | 十条“防止 AI 味”的通用运动图形硬性规则 + Remotion 工作流 | 面向通用运动图形/品牌动画,不特别针对“软件产品更新”场景,也不强制接入真实业务组件 |
| lemo-opuscar | 39 种预设影片风格 + 代码样片,偏重风格化短片创作 | 面向叙事/风格化短片而非产品宣传,走“选风格、套故事”路线,不涉及真实产品组件接入 |
8. 用户评价
- 第三方技术博客 OrcaRouter(作者 Elias Hawthorne,2026-09-24 发文)评价该技能“六阶段工作流异常清晰、比宣传摘要本身更有价值”,License 说明“异常细致”;同时指出“一键”宣传语有夸大成分,实际需要较多配置与人工决策,默认视觉素材的 BUSL-1.1 许可证并非完全开源自由。
- 外部贡献者 hwj123hwj 向仓库提交了一份真实 Pull Request,将“范围与平台确认”改为强制步骤,已被作者采纳,说明该项目有真实第三方使用与协作。
9. 安装使用方式
在目标产品代码仓库根目录下执行:
npx skills add https://github.com/op7418/guizang-product-video-skill --skill guizang-product-video-skill
安装完成后,对支持该 skill 的 AI 编程工具说明“用 guizang-product-video-skill 把最近的更新做成宣传片”,并给出画幅、时长、语言等基本要求;首次使用会自动检查 Node.js、Python、FFmpeg 等依赖,缺项按提示补装。无需重启终端或编辑器,随时可在对话中触发。
10. 注意事项
- 默认暖白/炭黑视觉样式(
assets/fallback/)适用 BUSL-1.1 许可证,与 skill 正文的 AGPL-3.0 条款不同,商用前建议核实两份许可证的具体限制。 - 完整走完一支片子涉及多轮人工确认(风格、方向、审片),并非严格意义的“一键生成”,首次使用建议预留时间熟悉流程。
- 尚未有 OpenClaw、Hermes Agent 平台下的官方验证,如需在这些平台使用建议先做小规模测试。