Communitygithub.com

演示视频

规划和制作关于软件工作的简短、以证据为先的视频:单个变更的完成视频、Sprint 演示、“前情提要”回顾、研究成果、发布、操作指南和 Bug 复现。一份蓝图:简报、声明表、故事板、节奏、品牌和评审,适用于任何 HTML 转视频的渲染器。

演示视频 是什么?

该技能提供了一套详细的、以证据为先的视频制作蓝图,专为软件工程项目设计。它定义了八种视频模式(完成、Sprint 演示、前情提要、研究、发布、概念、操作指南、复现),每种模式都有特定的时长、结构和使用场景。该技能的核心原则是“证据优先于艺术”,要求所有视觉元素(真实 UI、真实输出)都必须在“声明表”中有据可查,并始终在屏幕上标注其证据等级(如本地构建、生产环境)。它指导用户完成从撰写简报和声明,到创建文字故事板、捕获素材、合成、渲染,最终交付并附带技术检查报告的完整工作流程。此技能不绑定特定的渲染器,但推荐了 HyperFrames、Remotion 等组合方案,并强调了清晰的权限控制:允许本地制作,但发布需要明确的授权。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jernejk/jkstack/tree/HEAD/blueprints/demo-video

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

演示视频 是做什么的?

此处的视频是证据为先,其次是电影。每一帧都展示真实的内容,加以标签说明,在手机上可读,并安排时间使结果先于细节呈现。

这是一份蓝图,而非已安装的技能。它描述了一种已经制作出真实电影的方法,但不捆绑任何渲染器、录制器或检查器。请使用你已有的工具;扩展 描述了值得构建的工具。将参考路径相对于此技能文件夹解析。

1. 选择模式,然后撰写简报

模式用途时长结构
完成一个已合并的变更或 Bug 修复15–30 秒介绍卡片 → 真实 UI 中的变更 → 带有 Issue 或 PR 的结束卡片
Sprint 演示面向干系人的 Sprint 评审2–4 分钟Sprint 目标 → 3–5 个已完成节点,最有价值的最先 → 未完成 → 下一步
前情提要进行中项目的一集1–3 分钟上次未解决的问题 → 各部分:问题 → 结果 → 变更内容 → 下一个问题
研究实验、技术预研或研究之夜1–2.5 分钟问题 → 一张图描述方法 → 带分母的结果 → 意外发现 → 决策
发布已发布的内容和下一步计划1–2.5 分钟使用“合并 → 发布 → 预发布 → 生产”状态的回顾结构
概念特性电影、原型或提案45–95 秒结果钩子 → 一个可行的示例 → 证明 → 诚实的限制 → 回报
操作指南如何完成一个任务30–90 秒完成的结果 → 真实 UI 中的步骤 → 再次展示完成的结果
复现Bug 报告10–30 秒环境 → 步骤 → 失败点,保持 → 文本中的预期结果

各模式详情:模式。回顾、周年纪念和告别是 扩展 中的历程扩展。

在任何捕获之前,在电影文件夹中编写 BRIEF.md:模式、受众、一个核心要点、观看宽度(默认:手机,横屏 844 像素,竖屏播放器 390 像素)、品牌配置、每个场景的证据等级、截止日期和输出。仅询问你无法从请求或源材料中推断的内容。

2. 不可协商项

  • 证据优先于艺术。 展示真实的 UI、真实的保存输出和真实的源页面。永远不要描绘未发生过的状态、编造数字或暗示速度、发布或生产使用情况。屏幕上的每个事实在构建场景之前,都必须在声明表中有一行记录(证据)。
  • 始终在屏幕上标注其内容。 摄像头外侧的一个轨道标明证据等级:本地构建、概念演示·示例数据、录制的答案·重放、预发布、生产。概念和原型绝不可冒充已发布的功能。
  • 结果优先。 核心要点和一个关键数字或可见结果应在场景开始的约 1.5 秒内呈现,并持续到切换。场景时长 ≥ 1 秒 + 字数 ÷ 3 + 1.5 秒持续(节奏)。
  • 在手机上可读。 主要文字在 1080p 下 ≥ 80 像素;观众需要阅读的任何内容 ≥ 36 像素。文字过多:删减文字或重新组织,切勿缩小。
  • 清晰的 UI。 以 2 倍密度捕获证据,并以 ≥ 1.0 倍缩放或局部放大显示。切勿放大密集的 1080p 屏幕并称之为特写。
  • 仅经批准的品牌。 个人或公司品牌来自品牌配置和该品牌经批准的资产(品牌)。切勿重绘、重新着色或近似处理 Logo。
  • 获得许可的音效。 音乐和效果需要经过验证的许可证及其要求的署名。
  • 完成意味着已验证。 分别报告技术检查、检查过的帧、以正常速度回放和收听。请求者的验收是其自身状态(评审)。

3. 工作循环

  1. 简报和声明。 BRIEF.md 和声明表。对于带有数字的电影,在完整渲染之前,需由独立的评审者(最好是不同的模型族或真人)检查最终的屏幕文本,包括截图内的文本。
  2. 文字故事板。 每个场景一行:时间窗口、核心文案、图片、证据标签、音效提示、如何过渡。选择电影使用的 3–5 种过渡类型及其触发条件。
  3. 捕获(捕获)。使用脚本化的浏览器流程获取交互式素材,使用伪造时钟帧捕获页面自身的动画,使用 2 倍元素截图获取静态图像。
  4. 合成(合成器)。简短模式适合规范驱动的合成器;较长模式适合在暂停的时间线上手动构建,场景排列在条形网格上。
  5. 渲染前检查。 快照每个场景的第一个可读时刻、中间点、最后的持续段以及每个切换的两侧。修复冲突、文字裁剪、空白帧以及陌生人无法阅读的任何问题。
  6. 渲染、混音、验证。 渲染、编码、混入音乐和效果,运行技术检查,然后自行阅读联系表、裁切条和手机视图(动态和音效)。
  7. 交付。 提供静音版、音乐版、Web 版以及海报,播放器旁附带音乐署名,以及一份 REVIEW.md:测量了什么、仅查看了什么,以及最薄弱的镜头。

4. 工具链

任何能确定性生成帧的渲染器都可以。HyperFrames(Apache-2.0)和通过管道传输到 FFmpeg 的帧捕获脚本可直接渲染 HTML 合成内容。Remotion(React;请先检查其公司许可条款)和 Motion Canvas(TypeScript 场景)有各自的场景模型;合成器 中的合成契约可转换为它们的形式。Playwright 等浏览器自动化工具可驱动捕获。FFmpeg 用于编码、混音和测量。固定渲染器版本,并在提供选项时关闭遥测。

5. 权限

制作电影授权本地捕获、合成和验证。它不授权上传、发送消息、发表 PR 或 Issue 评论、更改产品或发布。使用示例数据或经批准的虚构数据;未经批准,切勿显示客户、用户或员工姓名,也切勿放大到已登录的身份。

参考

需求阅读
模式配置和故事结构模式
声明、标签、状态状态、事实核查证据
阅读时间、文字大小、手机宽度节奏和手机
动态、过渡、音乐和效果动态和音效
个人和公司品牌配置品牌
捕获技巧和陷阱捕获
完成视频规范和合成契约合成器
评审阶段和交付建议评审和交付
录制器、检查器、时间线回顾、历程电影扩展

相关技能