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 中的一行。