Communitygithub.com

Enricrypto/cypher-claude-skills

使用 Remotion 制作简短精炼的 iOS 应用引导视频,通过动画展示隔离的 UI 组件(非完整屏幕),呈现功能在操作中的状态,并配以优雅的 UI 过渡效果。当用户要求创建、制作或生成引导视频、应用预览、功能演示片段、App Store 预览或任何使用提供的截图展示移动应用功能的短视频时使用。

cypher-claude-skills 是什么?

该技能指导 AI 代理使用 Remotion 创建简短、有冲击力的 iOS 应用引导视频。其核心原则是“展示功能在做什么,而不是整个应用长什么样”——每个节拍聚焦于一个隔离、裁剪或遮罩的 UI 组件(按钮、卡片、行、表单等),并为其在交互过程中的状态变化制作动画,然后让位于干净的有色背景。视频长度通常控制在 30 秒以内,每个屏幕节拍时长 3-8 秒。 工作流程从严格的素材收集环节开始:代理必须要求用户为每个屏幕提供 2-4 张静态截图(展示休息状态、交互中状态、结果状态等),并明确功能的描述和排列顺序。在开始渲染之前,它不会自行编造 UI。 动画风格强调“类 UI ”的过渡,如弹簧、滑动、缩放、交叉淡入淡出、遮罩揭示以及共享元素切换。光标指引每次点击,并遵循严格的运动规则:从焦点区域中心淡入,然后沿一条直线移动到目标位置。标题始终固定在帧顶部同一位置,通过从下方升起并淡入的方式出现,且相邻节拍中相同的标题文本不会重复动画。 该技能与 `remotion-best-practices` 技能集成,后者是编写所有 Remotion 代码的最终权威。它要求使用 `<Sequence>` 串联节拍、使用 `spring()` 进行缓动,并采用特定的项目结构(素材存放在 `public/` 目录,动画组件存放在 `src/scenes/` 目录)。代理必须不断迭代:将首次渲染视为草稿,接着询问用户哪些节拍需要调整速度或重新编排。

兼容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Enricrypto/cypher-claude-skills/tree/HEAD/skills/create-onboarding-video

在你喜欢的 AI 中提问

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

文档

创建引导视频

使用 Remotion 制作一个简短、有冲击力的 iOS 引导视频,展示一个功能的工作过程。输出应像 App Store 预览一样,聚焦于证明该功能有效的时刻——不是教程,不是屏幕录制,也不是营销短片。

你需要制作的内容

  • **时长:**短。每个引导屏幕 3–8 秒,拼接在一起。整个视频很少超过约 30 秒。
  • 风格:UI 优先,从不展示整个屏幕。每个节拍展示功能在操作中的一个片段——一个被点击的按钮、一个翻转的开关、一个重新排序的行、一个滑出的面板、一个填充的图表——通过优雅的 UI 过渡(弹簧、滑动、缩放、交叉淡入淡出、遮罩揭示、共享元素交换)进行动画。
  • “片段”的含义:从提供的静态截图中裁剪、遮罩或提取出相关的组件——卡片、输入框、标签栏、从空状态变为填充状态。UI 的其他部分被省略、模糊化或通过有色背景暗示。我们展示的是功能的作用,而不是整个应用的外观。
  • **基调:**切中要点。每个节拍传达该功能做的一件事情。
  • **输出:**一个渲染为 MP4(并可选择为 App Store 预览渲染为竖屏变体)的 Remotion 项目。

工作流程

遵循以下循环。不要跳过素材收集——猜测流程会导致视频千篇一律。

1. 素材收集——要求提供截图和意图

对于用户希望展示的每个引导屏幕,收集以下信息:

  1. 静态截图——要求每个屏幕提供 2–4 张静态图,以便展示交互状态:
    • 休息状态
    • 交互中状态(按钮按下、输入框聚焦、面板半开等)
    • 结果状态(数据加载完成、成功、下一个屏幕)
    • 任何值得展示的变体(空 vs. 填充、亮色 vs. 暗色等)
  2. 功能说明——一两句话说明该屏幕为用户做了什么以及它的亮点。这将决定放大到哪个细节。
  3. 顺序——引导流程中屏幕的排列顺序。
  4. **可选:**品牌色/强调色、非常规字体、目标宽高比(iOS 默认为 1080×1920 竖屏)、结束卡片文字/行动号召。

当用户表述模糊时,使用 AskUserQuestion。在获得所有屏幕的截图和意图之前,不要开始渲染。

2. 规划镜头

对于每个屏幕,确定证明该功能有效的单个 UI 片段——被点击的按钮、正在填充的进度环、被滑动的行、自动补全的输入框——以及它如何过渡到下一个节拍。切勿对整个屏幕进行动画处理。 在编写组件之前,先勾勒出时间线(焦点元素 → 运动 → 结果 → 下一个焦点元素)。优先选择:

  • 从静态图中隔离/裁剪/遮罩出相关组件,并将其放置在有色背景上
  • 展示交互本身(点击涟漪、拖动、聚焦、状态变化),而不仅仅是静态布局
  • 节拍之间的共享元素过渡(节拍 1 的按钮变成节拍 2 的标题)
  • 分层元素上的微妙视差/深度感
  • 基于弹簧的运动,而非线性缓动

3. 使用 Remotion 构建

在编写 Remotion 代码之前,务必调用 remotion-best-practices 技能。 在向该技能发送提示时,请包含以下指导:

构建一个简短的 iOS 应用引导视频。切勿渲染整个屏幕——每个节拍必须展示功能在操作中的一个片段:一个隔离/裁剪/遮罩的 UI 组件(按钮、卡片、行、面板、输入框、图表等),通过交互动作进行动画,以展示该功能的作用。将其放置在干净的有色背景上;应用的其他外观被省略或暗示。使用优雅的 UI 过渡——弹簧、遮罩揭示、共享元素变体、交叉淡入淡出、视差——在节拍之间进行切换。优先使用 spring() 而非线性插值,使用 <Sequence> 串联节拍,并保持每个节拍简短(30fps 下 90–240 帧)。静态图存放在 public/ 中,通过 staticFile() 加载;使用 CSS clip-path / overflow: hidden / 绝对定位进行裁剪,以提取焦点元素。

项目约定:

  • 源静态图存放在 public/<screen-name>/<state>.png。
  • 每个引导流程一个 <Composition>;每个屏幕节拍在其内部一个 <Sequence>。
  • 组件在 src/scenes/ 中,共享过渡在 src/transitions/ 中。
  • 默认 30fps,1080×1920 竖屏;将宽度/高度作为 props 暴露,以便相同的场景在需要时渲染为横屏。

4. 迭代

渲染一个预览,向用户展示,并询问哪些节拍需要更慢、更快或重新编排。将首次渲染视为草稿。

操作规则

  • 需要静态图。 如果用户没有提供截图,请停下来并要求提供。不要根据描述发明 UI。
  • UI 的片段,而不是整个 UI。 如果你发现自己正在渲染全屏模拟器,请停下来并裁剪到承载该节拍的组件。观众应该看到功能在操作中,而不是在浏览应用。
  • 每个视频一个功能。 如果用户描述了 5 个不相关的功能,建议将其拆分为 5 个视频。
  • 展示,而不是叙述。 没有画外音,没有解释功能的大文字叠加——让 UI 运动来承载。每个节拍一个简短的标题是可以的。
  • 标题在整个节拍期间可见。 每个节拍的支持性标题在节拍开始后约 10–14 帧内淡入,并在整个序列中保持显示在屏幕上。不要将标题的进入延迟到节拍中间,也不要在节拍结束前将其淡出——观众应该在焦点 UI 显示在屏幕上的整个过程中都能阅读该行文字。让场景级别的节拍间交叉淡入淡出处理标题的切换。
  • 标题从下方升起进入。 它们从静止位置下方约 60px 处开始,透明度为 0,然后一起滑上来并淡入(使用强 UI 缓出,例如 Easing.bezier(0.16, 1, 0.3, 1))。切勿让标题原地出现或从上方掉入——向上运动是视觉标识的一部分。
  • 标题始终位于顶部相同位置。 将每个标题锚定到一个固定的帧顶部位置(例如,距顶部约 100px,水平居中),并在所有节拍中重复使用该位置。绝不将标题放在焦点 UI 下方,绝不让其在节拍之间移动。保留一个一致的顶部“标题条”区域(约 200–240px),并将焦点切片放置在其下方。构建一个单一的 TopCaption 包装组件并在所有地方使用——不要为每个场景内联定位标题。
  • 标题要大。 1080 宽度画布上标题的默认字号约为 54px,字重 700,并设置 maxWidth 以便长行换行而不会超出帧。它们是标题大小的标注,而不是字幕大小的标签。
  • 连接节拍之间的相同标题保持原位。 当两个连续的节拍在概念上属于同一个时刻的一部分,并且共享完全相同的标题文本时(例如,一个节拍显示点击某天,下一个节拍显示表单打开——适用于两者的标题相同),标题不得在切换处重新动画。它在第一个节拍上升并淡入一次,然后在每个后续节拍中使用 staticEntry 渲染(或等效方式:瞬间完全不透明,静止位置,无滑动)。在场景交叉淡入淡出期间,两个标题的合成方式完全相同,以便观众感知到一个跨过切换点持续存在的标题,而不是一个闪烁。仅当文本完全相同时才使用此规则——如果标题在节拍之间发生了任何变化,则让新的标题正常升起并淡入,以便变化可被感知。
  • 光标引导每次点击。 如果一个节拍展示了一次点击、单击或选择,则必须出现一个可见的光标(Pointer),沿路径移动,并在点击涟漪触发之前到达目标位置。没有瞬移,没有跳切点击。光标的运动正是告诉观众动作即将发生的位置的方式——仅有点击涟漪是不够的。纯粹说明性的节拍(通过光晕环突出显示功能,为静态状态添加动画,显示结果落地)不需要光标;让光晕/运动来引导视线。针对每个节拍决定:交互式 → 光标引导;说明性 → 无光标。 对于光标组件本身以及可复制粘贴的使用模式,仅在即将编写或修改包含点击操作的节拍时加载 resources/cursor-component.md。
  • 光标在中心淡入,然后沿一条直线移动到目标位置。 节拍中的第一次交互始终是:
    1. 在焦点区域的可视中心(切片中心/容器中心——无论观众视线在节拍中停在哪里)淡入。指针在原地出现;它不是从帧外进入的。
    2. 从该中心到交互点的单一直线移动。 方向不限——垂直、水平、对角线都可以,只要它是一条直线段。x 和 y 可以同时变化(这是唯一允许对角线的地方)。使用单个减速缓动(例如 Easing.bezier(0.16, 1, 0.3, 1)),使光标感觉像被引导,而不是被抛出去。
  • 同一 UI 上的多次点击:指针保持可见并在各点之间滑动。 当一个节拍在同一 UI 上有两次或更多交互时(例如,点击一个分段,然后点击同一表单上的“创建”按钮),不要在点击之间重置指针。指针在中心淡入一次,滑动到第一个目标,点击,然后直接从该目标滑向下一个目标(一条连续的直线段),点击,依此类推。仅在最后一次交互之后才淡出。切勿在相同 UI 上的点击之间在中心淡出并再次淡入——这会破坏由一个用户驱动操作的连贯感。连续交互之间的每个线段本身都是一条单一直线(任何方向允许,与进入时的对角线规则相同)。
  • 不同的 UI / 新屏幕:重置。 如果下一次交互落在不同的 UI 上(一个新屏幕、一个不同的表单、一个完全不同的节拍),指针确实会淡出,并且下一次交互以中心新的淡入开始。重置告诉观众“我们现在到了一个不同的地方”。
  • 禁止:从帧外边缘进入,单次移动中的多段路径,曲线,之字形,弯曲轨迹的中间关键帧,在同一 UI 上的点击之间淡出指针 + 再次淡入。运动应该像用户的手指出现在视线已经停留的地方,然后依次滑向每个操作——而不是像一只手从屏幕外进入,也不像光标在相同表单的每次点击之间闪烁消失。
  • 匹配应用的设计语言。 使用提供的静态图中的颜色、圆角和字体;不要重新设计它们。
  • 委托给 remotion-best-practices。它是如何编写 Remotion 代码的真理来源——在你即将编写或修改一个合成、场景或过渡时随时调用它。

有疑问时

提问。一个 10 秒的澄清问题能节省一个 2 分钟的渲染,避免错过要点。

Individual skills in this repo

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

相关技能