SuperAPI AI 工具集

demo-reel

设计与创作

查看项目

更新于 10-25 18:32

技能介绍

用途

这个技能的核心思路是把“拍演示片”当作对产品的验收测试:镜头逐条展示客户在真实产品上会看到什么,端到端拍完等于做了一次模拟无法通过的验收。每个拍失败的镜头都被视为一个待追查的缺陷,而不是重试即可忽略的噪声;最终成片既是证据也是宣传素材。

主要能力

  • 提供镜头清单格式:每个镜头写明主张、通过条件、如何测量、画面上每个事实及其来源。
  • 提供失败台账与修复通道(fix lane)机制:一个失败镜头对应台账一行、一个负责人,修复须附可复现的证据,并由独立方核查。
  • 提供确定性拍摄脚本:capture-web.mjs 支持浏览器 4K 录制、静帧截取、透明帧序列与定时器动画;agent-take.sh 用于沙箱化的智能体出镜拍摄,含登录、夹具验证与试运行。
  • 提供审查与校验脚本:contact-sheet.sh 生成切点、字幕、缩放位置的联系表,verify-mp4.sh 校验分辨率、帧率、时长与最大冻结时长。
  • 提供参考文档,覆盖方法、演示数据、拍摄、智能体出镜、剪辑渲染、校验、常见陷阱与真实案例。

使用方式

若通过 URL 被指向此技能,可按下列命令临时获取(脚本自行解析路径):

DR="$(mktemp -d)/hyperskills"
git clone --depth 1 --branch main https://github.com/hyperb1iss/hyperskills "$DR"
DR="$DR/skills/demo-reel"
bash "$DR/scripts/doctor.sh"        # every failure prints its fix
bash "$DR/scripts/selftest.sh"      # offline proof the toolkit works here

安装方式:npx skills add hyperb1iss/hyperskills --skill demo-reel,或使用 hyperskills Claude Code 插件。拍摄产物与渲染结果应保存在用户项目中,不要放在克隆目录或内存盘 /tmp。

流程分 11 个阶段,每阶段有退出检查,失败则回到更早阶段:预检、分镜、演示世界、镜头脚本、拍摄、台账与修复通道、剪辑、静帧检查、渲染、校验、交付。脚本统一使用稳定退出码:0 正常、1 检查失败、2 用法错误、3 缺少依赖、4 输入错误或步骤失败(capture-web.mjs 另加 5 表示编码器失败)。

适用场景

制作演示视频、产品视频、宣传片、应用录屏;同时希望借拍摄过程发现产品问题、并把成片作为验收证据的团队。

限制

  • 系统依赖仅为 ffmpeg(含 ffprobe);浏览器拍摄需 Node 18+ 与 Playwright Chromium。
  • 不要求 ffmpeg drawtext,也不要求 Remotion。
  • 不是视频剪辑教程:简单裁剪、格式转换或已有片段的 GIF 用普通 ffmpeg 即可,无需镜头清单。
  • 不允许伪造产品行为:合成标题、音乐、真实数据渲染可以,摆拍的产品行为不行。
  • 不替代产品测试套件:修复仍须附带测试。
  • 不绕过用户授权:发布、合并修复或发布成片须遵循用户正常审批。
  • 资料未提供收费、价格与效果量化信息。