用途:ketchup-video 是 /ketchup 流程的视频版,用一段简短的无声幻灯片视频,代替 /ketchup 的文字摘要和视觉说明,向用户说明发生了什么,并在视频下方以文字列出仍在等待处理的调用。
范围与回复形式:该技能的时间窗口从用户写下 /ketchup-video 之前的最后一条消息开始,而不是更早的 /ketchup。回复由四部分组成:ketchup 的开场句、嵌入的视频、一行说明你自行还能完成的剩余工作、以及待办事项列表,也就是 action items。视频中列出某个调用的选项时,应按视频给出的名称称呼每个选项。如果渲染失败,用一行说明情况,并且只给出调用列表。
幻灯片内容:使用工作产生的截图、录屏、diff 和数据,不要使用聊天中的叙述性文字。绘制前,先写一句用户应当记住的结论,再为每张幻灯片写一行说明;删掉不会改变用户认知的幻灯片。最多 10 张,越少越好。这两条笔记不放进回复。每张幻灯片只表达一个观点,并基于同一张图逐页变化,而不是切换到无关画面;颜色或形状在每张幻灯片上含义一致。用图展示工作,例如系统如何运作、带各 PR 状态的 PR 栈、修复前后的对比、并排选项;用箭头、高亮和动效指向变化之处。幻灯片不能是项目符号列表、状态列表、表格或无连接的方框。
文字要求:文字保持最少,标签放在它所指的对象上,用普通人会说的平实词语,不使用“Tests: pass”这类标签。不要为图片配说明,也不要在幻灯片之间或视频下方文字中重复同一事实。展示用户每个要求的结果,以及它是已完成、仍在运行、失败还是未检查。不要把仍等待用户处理的事显示为已完成。如途中发现并修复了 bug,也要展示。若可见变化没有截图,在该幻灯片上说明,并指出屏幕上改了什么。只依据已有事实绘制,不要编造数字,也不要绘制未截取的画面。
渲染:渲染一段无声横屏视频(如 mp4),幻灯片之间有动效,每一帧都是幻灯片本身,铺满画面。帧由幻灯片生成,不要录屏。每张幻灯片停留时间要足够读完其文字,每新增三个词至少停留一秒,截图内的文字不计。嵌入视频前,查看渲染文件中每张幻灯片的一帧,并按该文件中的停留时长核对其新增词数;无法在规定时间内读完的幻灯片需修正、重新渲染并再次检查。
适用场景:适合需要快速追进度、且希望以可视化短视频了解工作结果与待处理调用的场合。限制:输出为无声横屏视频;内容只能来自已有截图、录屏、diff 和数据;不得编造数字或画面;渲染失败时仅给一行说明和调用列表。