1实现原理 · 为什么它能做到

默认取向是「保 UI 优先于去画布」：只有关键 UI 在缩放与滚动全程可见、且证明帧确认最紧裁切仍成立时才裁。

skills/product-demo-integration/SKILL.md

Default to preserving UI over removing background canvas.

这里在做什么：把裁切从「美化默认动作」降级为「有条件的风险动作」，并用证明帧作为解锁条件——全族反复出现的「先证明再动手」模式。

先建 moment map（录屏时间戳 / 可见内容 / 对应旁白短语 / 目标全局时间 / 光标是否重要 / 滚动位置是否重要 / 字幕是否重叠 / 裁切是否安全），再决定 trim 与重定时。

skills/product-demo-integration/SKILL.md

Create a moment map before editing:

这里在做什么：把「哪一帧对应哪句台词」提前落表，避免剪辑时反复回看录屏找时刻。

进入转场规则：从前一场景末帧起、用相机擦或推而非硬切（若用户要求连续）、落在录屏当前首帧；录屏开头死时间只在不断同步时才裁。

skills/product-demo-integration/SKILL.md

- Land on the current first frame of the product recording.

这里在做什么：把「首帧对接」当成硬要求，与 scene-continuity-and-transitions 的首帧匹配纪律同源。

同步判据四条：产品状态必须在台词时刻可见（必要时提前启动转场）、理解重要则让末帧保持、宁可放慢产品时刻之前的片段也不要把滚动加速到不自然、绝不在词中间切。

skills/product-demo-integration/SKILL.md

- Do not cut mid-word in narration to reach a product state.

这里在做什么：把「同步」定义为「产品状态落在台词上」而非「时长对齐」——因此更倾向改变前段速度而不是硬剪。

录屏清理有清单但要克制：光标、浏览器 UI、通知弹窗、死时间、加载白屏、桌面边缘、滚动速度、缩放焦点——只在无损产品清晰度时才处理。

skills/product-demo-integration/SKILL.md

- Notification popups.

这里在做什么：列全可清理项（含隐私敏感的通知弹窗），同时用 Only remove or hide these if it does not harm product clarity. 限制过度加工。

裁切决策矩阵分三档：不裁（用户接受画布、缩放跨屏、正文会被切、产品状态比精致更重要）、轻裁（画布干扰但 UI 居中、字幕需空间、浏览器 chrome 或死边距可安全去除）、动态裁切（每个裁切矩形都已映射、运动显得有意、所有关键产品状态都有证明帧）。

skills/product-demo-integration/SKILL.md

Choose dynamic crop only when:

这里在做什么：把「裁多少」变成条件判定而非审美偏好，且动态裁切的解锁条件最严。

用户批准点前置：裁掉可见画布、去光标、大幅加速、模糊或遮罩产品细节、用重制的假 UI 替换真实录屏——这些必须先问。

skills/product-demo-integration/SKILL.md

Ask before: - Cropping out visible canvas.

这里在做什么：把「可能改变信息真实性」的编辑列为需批准项；用重制 UI 替换真实录屏尤其敏感（可能被误读为产品实际能力）。

2核心能力

01录屏 intake 探测：时长、分辨率、帧率、音频；并识别是否含画布、浏览器框、光标、缩放、滚动或死时间

02三级裁切决策（no crop / light crop / dynamic crop）与裁切安全程序：在录制起点、每个放大时刻、每次滚动落点、必需产品状态、末帧各抽一帧，用候选裁切逐帧测试，任何关键文字或光标上下文或 UI 控件被切就否决，宁可略宽

03进出产品片段的转场规则与证明帧（转场边界抽帧；录屏末尾避免意外空白帧；末个产品状态要留够注册时间）

04产品时刻映射与旁白同步（必要时提前转场、末帧保持、放慢前段而非加速滚动、不在词中切）

05字幕安全专节：烧字幕时检查底部导航栏、产品表格、模态按钮、时间线控件；必要时改字幕边距或换证明帧

06QA 清单与 handoff 字段（首个产品帧、每个缩放峰值、每个必需产品状态、进出转场、字幕不遮 UI；报告用的源录屏、裁切策略、裁剪点、重定比、关键证明帧、仍不完美的 UI）

3外部依赖

Kind	Dependency / Endpoint
cli	媒体探测与切分（时长/分辨率/帧率/音轨；trim 与重定时）——SKILL.md 只写探测要求，具体命令由同族 ffmpeg/ffprobe 链路承担
cli	ffmpeg（间接：抽帧与接触表的实现工具，见仓库根 scripts/extract_proof_frames.py）
package	素材输入：用户提供的原始屏幕录制（SaaS demo / app 录屏 / 浏览器录制），本地文件，无外部服务
package	参考文件 skills/product-demo-integration/references/crop-and-zoom.md（裁切安全程序与常见错误清单）

4管控建议与判定依据

建议配套管控措施

面向 Agent

分级或逐次授权，建议在沙箱运行

面向管理者

审批流程、可回滚、全程审计

判定依据（文件路径与关键语句摘要）

scripts/: 执行本地脚本或命令: （本 skill 目录内无脚本）按文档由宿主对录屏做探测、抽帧、裁切与重定时（ffmpeg/ffprobe 链路），并渲染产品片段
本地工作目录: 文件读写与工件输出: 裁切与重定时后的产品片段与渲染输出（renders/ 下）

审计说明： 。skill 目录仅 SKILL.md + references/crop-and-zoom.md（纯指令，无脚本）；行为面是本地读写（对录屏抽帧、裁切、重定时、渲染并出证明帧）与本地媒体工具，符合蓝档。**没有把素材送外部服务**：全量扫描本 skill 目录内无 http(s):// 端点、无 fetch/requests、无 token/env 读取；录屏由用户提供、加工全在本地完成。文档对「模糊或遮罩产品细节」「用重制 UI 替换真实录屏」等可能误导观众的编辑设置了用户批准门禁。九件同族 skill 判级口径一致：目录内只有 SKILL.md（+ references），行为面是本地读写与本地 CLI，无端点、无凭证、无素材外发。

5第二遍独立确认

[ok] 「无网络无凭证」是否成立 — 目录扫描无 URL、无 fetch、无 token/env/cookie；产品录屏作为本地素材处理，无上传、无生成服务，故不构成橙档。
[ok] 三处裁切判据是否自相矛盾 — SKILL.md 的 Use crop only when（三个必要条件）、Crop Decision Matrix（三档适用条件）、references 的四步程序（逐帧测试与否决规则）方向一致：默认不裁、裁切需证据、动态裁切最严。未发现冲突。
[discrepancy] 探测要求是否有可执行命令 — 本 skill 与族内多件一样只写探测要求，未点名 ffprobe 或仓库脚本；实际命令在 audio-sync-assembly（ffprobe 与探测脚本）与 render-qa-and-surgical-changes（scripts/probe_media.py）里。只加载本件时探测动作需自行补齐。
[ok] 用户批准点是否覆盖 references 建议的所有激进编辑 — SKILL.md 的 Ask before 列表含裁掉可见画布、去光标、大幅加速、模糊或遮罩产品细节、用重制 UI 替换真实录屏；覆盖了 crop-and-zoom.md 建议的动态裁切与「更优替代方案」中涉及真实性的项，未见遗漏的高风险编辑。
[ok] 转场规则是否与 scene-continuity-and-transitions 一致（避免两件给出不同做法） — 本件要求从前一场景末帧起、用相机擦或推而非硬切、落在当前首帧、边界抽证明帧；scene-continuity-and-transitions 的首帧匹配与边界证明程序方向相同（后者另给 0.05s 前后与转场中间的抽帧程序），互为细化而非冲突。
[ok] 是否有未声明的素材外发（例如云端转写或云渲染） — 全目录无端点、无服务名；清理与裁切均在本地完成。唯一外生动作是宿主抽帧后的读图（若使用视觉模型），不属本 skill 声明的调用。

6结论

把裁切定义为「需证据才解锁的风险动作」，并用证明帧作为解锁条件，直接对应最常见的事故（裁掉缩放后的关键 UI）

moment map 把「哪一帧对应哪句台词」提前落表，让 trim 与重定时有依据而非反复回看

同步哲学明确：宁可放慢前段，也不把产品滚动加速到不自然，且不在词中切

字幕与产品 UI 的冲突被单列（底部导航、表格、模态按钮、时间线控件），是产品演示片特有且高频的问题

把可能误导观众的编辑（去光标、模糊细节、用重制 UI 替换真实录屏）交给用户批准，而不是 agent 自行决定

适合： 适合：用户提供了原始屏幕录制（SaaS 演示、App 走查、浏览器录屏、产品 walkthrough），需要把真实产品画面接进设计过的视频里——决定裁不裁、怎么进怎么出、产品状态如何对上旁白、字幕是否遮挡 UI、以及如何用证明帧验收的场合。

不适合： 不适合：① 完全没有产品录屏的场合（走 hyperframes-scene-builder / motion-design-systems）；② 需要替用户录制或获取产品素材（本件只处理已有录屏，不含采集）；③ 需要深度后期合成（多轨、抠像、跟踪）的项目——本件只覆盖裁切、转场、时序、可读性；④ 需要素材授权与隐私合规审查的项目（文档不覆盖）。

Install Agent-Ready

① Verified Mirror 2026-09-28

Option A · Direct DownloadDownload product-demo-integration.tar.gz

sha256: da34d1aa8e5b647e…

Option B · Copy Guide for Agent

install.json

agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。

② Upstream GitHub

GitHub Repo ↗

Pinned to commit f6b043d9fd.