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外部依赖
| 类型 | 依赖 |
|---|---|
| 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风险提醒 风险提醒：蓝色 · 知晓即可
风险提醒：蓝色 · 知晓即可
- 探测与抽帧缺少具体命令，只加载本件无法闭环 — SKILL.md 只有探测这些属性与抽证明帧的要求，命令分散在同族 skill 与仓库脚本里；单独使用时需要使用者自行补齐 ffprobe/ffmpeg 调用。
- 录屏内容可能携带隐私与第三方信息 — 录屏画面常含通知弹窗、账号名、客户数据、第三方 UI；SKILL.md 把通知弹窗列为可清理项，但没有隐私审查、脱敏或授权确认的要求——商用前需自行判断。
- 动态裁切的可执行性依赖人工映射 — 规则要求每个裁切矩形都必须映射，但没有工具生成或校验裁切关键帧；实际操作中容易退化为固定裁切而失去缩放跟随，导致后续缩放把 UI 切出画面。
- 「不裁」的代价在成片里才显现 — 默认保 UI 时画布与浏览器框会占掉画面比例，可能让演示段落显得不精致或与 motion-design-systems 的卡片与尺度纪律冲突；文档没有把这一取舍量化。
- 产品真实性相关的编辑无复核机制 — 虽然要求用户批准用重制 UI 替换真实录屏，但没有要求成片标注或留痕；若被替换的 UI 与实际产品行为不一致，观众无从分辨（合规风险落在使用者身上）。
风险提醒：蓝色，知晓即可。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结论
适合：适合：用户提供了原始屏幕录制（SaaS 演示、App 走查、浏览器录屏、产品 walkthrough），需要把真实产品画面接进设计过的视频里——决定裁不裁、怎么进怎么出、产品状态如何对上旁白、字幕是否遮挡 UI、以及如何用证明帧验收的场合。
不适合：不适合：① 完全没有产品录屏的场合（走 hyperframes-scene-builder / motion-design-systems）；② 需要替用户录制或获取产品素材（本件只处理已有录屏，不含采集）；③ 需要深度后期合成（多轨、抠像、跟踪）的项目——本件只覆盖裁切、转场、时序、可读性；④ 需要素材授权与隐私合规审查的项目（文档不覆盖）。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-28
方式 A · 人下载镜像包下载 product-demo-integration.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agentda34d1aa8e5b647e…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库saranambiar / saranambiar/hyperframes-video-agent-skills
Stars48
最近推送2026-06-14
本 skill commit
f6b043d9fd许可Apache-2.0（仓库根 LICENSE 为 Apache License Version 2.0；GitHub API license.spdx_id = Apache-2.0）
本站信息
收录日期2026-09-06
分类内容创作
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。