Communitygithub.com

idilsaglam/应用预览视频

将提供的移动应用录屏转化为可编辑的 Remotion 发布视频,或经过技术检查的 App Store 预览草稿。适用于素材检查、故事板、字幕剪辑、本地渲染和导出检验;不适用于凭空生成应用界面或提交商店素材。

应用预览视频 是什么?

该技能是一个集成的 Remotion 模板和可安装工具,专为处理移动应用录屏并生成两种主要输出而设计:面向营销的“发布”视频和带技术合规检查的“App Store”预览视频。工作流程以严格的真实性和出证能力为核心——从接受录屏文件夹开始,强制检查素材(如敏感数据、模拟 UI 和时序正确性),然后从提供的品牌素材中发现真实的应用设计语言(如 Logo、颜色、字体),同时避免任何发明或虚构。如果缺乏品牌素材,工具会暂停渲染并请求用户提供文件。在渲染前,它会创建一份详细的场景计划,使用真实的时间裁剪点、可读的说明文字和出证描述,然后通过 Remotion 管道输出 MP4 文件、海报帧、哈希值和一份包含技术检查和来源出证信息的完整报告。最后,它会提示用户以手机尺寸评审完成后的视频,并在不覆盖首次输出的前提下允许修订。该技能支持 VSCode 和 Claude Code 等与 AI 代理兼容的环境,并严格遵循 Apple 的广告素材指南,确保不会创建可提交的资产,而是生成一份包含限制说明的编辑项目。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/idilsaglam/app-preview-video/tree/HEAD

在你喜欢的 AI 中提问

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

文档

应用预览视频 是做什么的?

该文件夹既是一个可安装的技能,也是一个可运行的 Remotion 模板。请阅读 README.md 了解经过测试的搭建方法和命令。创建计划时请阅读 场景计划接口,App Store 模式请阅读 Apple 要求。如需新录制,请参考 录制指南。

素材接收与出证

接受录屏文件夹、模式(launch 或 app-store)、应用名称、品牌素材、语言和创意简报。默认使用英语、竖屏,发布模式时长为 30 秒,App Store 模式为 25 秒。默认遵循应用自身的设计;不要静默套用虚构示例的颜色、字体或视觉风格。切勿凭空编造当前应用的功能。

运行 npm run doctor,然后使用 npm run inspect -- --recordings DIR --out NEW_DIR 检查素材。阅读检查 JSON 和参考帧,并审查完整片段以确认操作、敏感数据、测试 UI、加载情况和真实的时序。仅凭静态图片不足以验证内容。如果无法完整播放,请记录该限制并暂缓人工审核。

收集录制版本、设备、日期和模拟条件。将真实的应用素材保留在公共包之外。如果请求的某个时刻缺失,则索取缺失的录屏。不要用生成的 UI 替代,不要倒放时间以暗示不同的结果,也不要把模拟器录屏标注为实体设备录屏。

渲染前的品牌发现

首先检查提供的素材以及相关的应用项目、截图或录屏,以获取真实的 Logo/应用图标、颜色、字体、表面、圆角形状和动效风格。使用已经提供或可验证存在的素材;不要要求用户重新上传。如果有多个可能的 Logo 版本,请询问哪个是当前版本。如果没有 Logo 可用,询问其文件/路径,并在渲染前等待;在此期间可以继续检查录屏。用户可以明确选择纯文字/无 Logo 的处理方式。不要凭空编造或静默地省略 Logo。

如果可用,使用应用的设计令牌,并与当前录屏进行视觉比较。如果本地没有该字体,请解释所使用的替代字体,而不是声称完全匹配。将设计来源和决策记录在私有场景计划或附带报告中。在计划的 logo 字段中放置真实的 Logo;使用场景计划参考中的 design 令牌来设置颜色和可选的设计风格。将真实品牌素材保留在此可分发包之外。

在全量渲染前,展示一个有代表性的开场帧预览和说明文字样式。邀请用户进行修正;如果用户已经指定了设计并要求渲染,则不要引入额外的审批环节。当应用合适时,使用克制的 design.layout: "app" 发布处理方式,或根据提供的设计调整合成。不要用通用的暗色帧、全大写字标或装饰图形来替代应用的标识。

录制来源信息始终保存在 provenance 和 capture 中,并保留在报告中。对于发布视频,默认将 disclosure 留空,除非为了避免误导性声明而需要或请求使用屏幕上的披露信息。不要自动将模拟器/设备/位置元数据烧录到营销视频中。这不排除必要的登录/付费访问披露、虚构演示标签或 App Store 录制要求。切勿将模拟位置展示为实际完成的步行路线,也不要把模拟器录屏标注为设备录屏。

编辑与渲染

创建一份包含实际素材剪辑点、简洁可读的说明文字以及每个场景的出证描述的场景计划。使用一个连贯的旅程,在开头几秒内包含一个有意义的操作。保持可读性和输入比例。以 examples/launch.json 或 examples/app-store.json 作为结构起点,替换所有虚构的主张和来源引用。

发布模式允许一个帧、标题、行动号召按钮和品牌背景。App Store 模式展示应用并带有克制的说明文字和访问披露;不包含虚假的设备交互或虚构的 UI。捆绑的演示示例为明确的虚构内容,绝不是 Apple 的提交素材。此 v1 版本在调用真实应用编辑之前需要设备来源信息;纯技术检查绝不能确定内容合规性或可接受性。

运行 npm run render -- --recordings DIR --plan PLAN.json --out NEW_DIR。输出文件夹必须是新的以保留出证信息。该工具会规范化修剪后的媒体,通过 Remotion 渲染,编码为 MP4,创建海报帧,并写入来源信息、哈希值、时间码和技术检查结果。原始素材保持不变。音乐为可选、用户提供、已获授权,且长度至少与编辑视频相同。默认情况下,源音频为静音。

审查与交付

以手机尺寸审查整个完成后的 MP4 文件(包括音频和静音版本)。检查所有剪辑点、披露信息、说明文字、声称的操作和音频。如果发现问题,修订场景计划并渲染到另一个文件夹;保留首次渲染内容并描述实际修正内容。

单独报告:技术验证、人工播放/内容审查、来源来源信息和 Apple 接受度。绝不要仅凭几张截图就将 pending 状态改为 passed。提供 MP4 文件、海报帧、可编辑项目/场景计划、报告以及剩余的限制说明。不涉及上传、提交、云渲染、付费素材或发布操作。

相关技能