Communitygithub.com

Whats New 剪辑

每个版本发布时,使用产品真实界面制作简短的“新功能”视频:先确定文案,在真实构建版本上拍摄,并在任何人看到之前审核。

Whats New 剪辑 是什么?

Whats New 剪辑是一种自动化技能,旨在为每个软件版本快速生成一个简短、聚焦于用户可感知变化的视频。其核心工作流将文案优先:首先从发布说明中识别用户能注意到的变化,与审批者逐条确认文案(每个变化对应大约6个单词的标题),然后才在真实的发布构建版本上从预设的可重复状态录制屏幕。录制完成后,通过单个命令渲染输出指定尺寸的视频(如9x16或16:9),并使用 `clip.py` 工具自动生成关键帧缩略图供审核。该技能要求 `ffmpeg` 和 `ffprobe` 环境,同时依赖 `Pillow` 库。它支持在 Claude Code、Cursor 等 AI 代理环境中运行,并通过清晰的“完成条件”(Done when)确保每一步质量。最终输出包括规范文件 (JSON)、原始影片和渲染剪辑,且规范文件会保留在仓库中供下个版本复用。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/GhostRoboticsLab/skills/tree/HEAD/skills/product/whats-new-clip

在你喜欢的 AI 中提问

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

文档

What's New 剪辑

What's New 剪辑 在用户滚动浏览的时间内告知人们一个版本的变化:一张开场卡片,每个版本都提出同样的问题并显示版本号;每个变化对应一个场景,在真实发布构建版本上拍摄并配有字幕;一张结尾卡片说明如何获取。文案先行,并且是审批者自己的话。您从预设的、可重复的状态开始拍摄,使用一个命令渲染,并在任何人看到之前查看渲染的静态图像。规范文件保留在仓库中,因此下一个版本可以从这个版本开始,而不是从空白编辑会话开始。

项目事实存放在用户仓库中的 docs/agents/whats-new-clip.md:发布说明的位置、如何构建和预置发布构建版本、如何捕获此界面、外观、格式、剪辑的存放位置以及审批者。如果该文件缺失,请先遵循 SETUP.md。

工具是 scripts/clip.py。运行方式为 uv run <此技能的文件夹>/scripts/clip.py <命令>;任何命令的 --help 会列出其标志。它需要 PATH 环境变量中包含 ffmpeg 和 ffprobe;uv 会引入 Pillow。如果没有 uv,请在仓库外创建一个虚拟环境 (python3 -m venv <dir> && <dir>/bin/pip install pillow) 并使用 <dir>/bin/python 运行该工具。规范的格式以及 check 应用的每个规则都在 SPEC.md 中。

1. 找出人们会注意到的内容

按照项目文件指定的位置阅读版本的发布说明。列出用户会看到、听到或感受到的每个变化,每个变化都对应其说明中的一行。忽略没有人注意到的修复和幕后工作。

如果列表中没有用户会注意到的内容,则向审批者询问此版本是否应该制作剪辑,除非他们回答“是”,否则停止。

完成条件: 列表中的每一项都指向发布说明中的一行,或者审批者已表示此版本没有剪辑。

2. 确定文案

为每个变化提出一个字幕,按展示顺序排列,最重要的放在前面。一个变化对应一个场景。字幕是用简单语言表达的用户收益,简短到足以在其场景播放时阅读两遍(大约 6 个单词)。如果审批者已经对某个变化给出了措辞(在说明中、消息中、应用内的 What's New 中),则逐字使用:保留他们的拼写、语法和大小写。

一次性向审批者提出整个列表以及您对每一行的建议,以便他们可以用一个词回答。在文案确定之前不要拍摄任何内容:重新措辞的字幕通常需要不同的镜头。

当审批者重新措辞产品中也显示的字幕(应用内的 What's New 页面、商店发布说明)时,询问该文本是否也会更改,以便版本发布时说同一套话。

完成条件: 审批者已同意每个字幕,并且您按照约定的原文保存了每一个。

3. 编写规范文件

如果设置已经为这个版本编写了规范文件,则填写该文件。否则从上个版本的规范文件开始,以便外观、开场白和结尾卡片得以延续:

clip.py init <version> --out <spec 文件夹> --from <spec 文件夹>/<上一个版本>.json

对于第一个剪辑,使用 --product "<名称>" 而不是 --from。填写每个场景的 caption(从步骤 2 逐字复制)、words_by(谁提供了文案),以及计划好的 in 和 out,时间要足够长以阅读其字幕。没有可观看内容的变化,应为其字幕允许的最短场景。然后运行 clip.py check <spec> --words。

完成条件: check --words 打印 check: ok。

4. 拍摄每个场景

按照 FILMING.md 中的规则,使用项目文件的构建、预置和捕获命令拍摄每个场景。仅显示此版本包含的内容:不显示开关关闭后的内容,不显示下一个版本的内容。

如果无法通过产品自己的 UI 输入实际到达某个变化,则停止并告知用户:这是一个错误,绕过它拍摄的剪辑会承诺用户无法做到的事情。

项目捕获无法拍摄的变化(如摄像头视图、第二台设备)应使用保存的影片显示:请参阅 FILMING.md 中的“捕获无法拍摄的内容”。

将影片放入此版本的剪辑文件夹中,位于仓库之外。根据记录每个步骤运行的时间,设置每个场景的 source、in 和 out,在信任标记之前先查看:

clip.py peek <film> --from <秒数> --to <秒数> --out <一个干净的临时文件夹> --sheet <临时文件夹>/peek.png

它会显示 render 将读取的影片在两个秒数之间的内容。切勿自行使用 seek 来确定该静态图像:屏幕录制仅在画面变化的地方保留一帧,因此 seek 会跳到下一个变化,这可能是在几秒之后。

然后运行 clip.py check <spec> --media <影片文件夹>。

完成条件: 当 --media 指向影片文件夹时,check 打印 check: ok。

5. 渲染

clip.py render <spec> --media <影片文件夹> --out <剪辑文件夹>/<产品名称,短横线命名>-<版本>-9x16.mp4

使用 --size 渲染项目文件中命名的每种其他格式,例如 --size 1920x1080。当 render 表示屏幕在该尺寸下太小而无法阅读(例如宽屏画面中的手机屏幕)时,该格式需要自己的规范:请参阅 SPEC.md 中的“其他格式”。声音是可选的,且绝不能承载信息:大多数人静音观看,因此仅凭字幕必须讲述故事。

完成条件: render 为项目文件命名的每种格式打印 Wrote ...。

6. 审核者检查

将静态图像提取到一个新文件夹中:clip.py stills <clip> --spec <spec> --every 1 --safe --out <临时文件夹> --sheet <临时文件夹>/sheet.png。它会从每个卡片和场景的中间位置、每秒一张、以及包含所有图像的拼贴图中输出一张静态图像,并且对 Feed 覆盖范围的边缘进行着色。对照 REVIEW.md 检查每一张图像,针对每种格式。

如果您的工具链可以启动子代理,请将此检查交给一个在新上下文中启动的子代理,使其仅持有 REVIEW.md、规范文件、静态图像和拼贴图:它看到的是屏幕上的内容,而不是您意图拍摄的内容。

按照 REVIEW.md 表格中的说明修复每个发现的问题,然后重新渲染并再次提取静态图像。切勿在交接中为错误的画面辩解。

完成条件: 每张静态图像都通过了 REVIEW.md 中的每一项,并且没有待处理的修复。

7. 交接

按照项目文件中的方式,向审批者发送 REVIEW.md 的“交接”部分列出的内容,并请求确认或指出需要更改的地方。在审批者说“可以”之前,剪辑不会发布,也不会附加到版本中。发布由项目文件指定的人负责。

如果收到“不可以”,则将他们的更改带回到步骤 2(文案)或步骤 4(画面),并且仅重新拍摄更改的场景。如果“不可以”没有附带原因:在再次剪辑相同的镜头之前,先询问他们不喜欢什么。

完成条件: 审批者已说“可以”,或者他们的更改已回到步骤 2 或 4。

8. 为下一个版本保留

规范文件与版本的其他更改一起保留在仓库中。将影片与已批准的剪辑并排放置在剪辑文件夹中。将此剪辑学到的每条经验作为一行添加到项目文件中的“经验教训”下。

完成条件: 规范文件在仓库中,影片与已批准的剪辑并排放置,并且每条新经验都是 docs/agents/whats-new-clip.md 中的一行。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能