Communitygithub.com

CambridgeMonorail/WallRun

在 Nx 单体仓库的演示目录中构建和编辑 WallRun 的 Remotion 演示视频。

WallRun 是什么?

该技能专门用于在 Nx 单体仓库内构建和维护 WallRun 的 Remotion 演示视频。它提供了创建场景、管理合成结构、复用运动组件以及控制视频节奏的完整框架。该技能主要面向开发者,特别是那些熟悉 React、TypeScript 和组件架构的前端工程师,旨在帮助其快速生成高质量、开发者导向的解释性视频。通过遵循该技能设定的设计规则和编码规范,用户可以确保视频具有清晰的视觉层次、克制的动画效果和易于编辑的代码结构,从而提升开发文档的演示效果。该技能支持 Nx 工作流,并提供预览、渲染和类型检查等命令,便于与现有开发流程集成。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CambridgeMonorail/WallRun/tree/HEAD/skills/remotion-demo-video

在你喜欢的 AI 中提问

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

文档

Remotion 演示视频技能

本技能帮助构建和维护位于以下路径的 Remotion 视频演示:

demos/wallrun-video

它提供了以下方面的结构:

  • 场景创建
  • 合成结构
  • 可复用的运动组件
  • 视频节奏
  • 面向开发者的解释

在以下情况下应使用此技能:

  • Remotion 合成
  • 场景组件
  • 动画解释片段
  • 视频结构或序列
  • 演示所用的运动原语

项目上下文

此仓库是一个 Nx 单体仓库。

Remotion 视频位于:

demos/wallrun-video

该项目为 WallRun 渲染一个面向开发者的解释性视频。

受众是前端开发者,而非营销人员。

假设观众了解:

  • React
  • TypeScript
  • 组件架构
  • 布局系统
  • 开发者工具

避免解释基本的 JavaScript 概念。


设计意图

视频应感觉像开发者媒体,而不是产品广告。

好的风格:

  • 编辑风格
  • 极简
  • 现代
  • 自信
  • 克制的动画

不好的风格:

  • 通用 SaaS 推广
  • 电影预告片效果
  • 繁重的粒子动画
  • 密集的营销文案

优先考虑:

  • 易读性
  • 层次结构
  • 节奏
  • 清晰度

项目结构

所有代码应位于:

demos/wallrun-video/src

结构:

  • components/ — 可复用的展示原语
  • scenes/ — 视频的定时部分
  • data/ — 脚本、文案、时间常量
  • Root.tsx — 注册合成
  • index.ts — Remotion CLI 的入口文件

场景设计规则

每个场景应仅传达一个想法。

典型时长:4-8 秒

场景应:

  • 快速可读
  • 使用大型字体
  • 避免杂乱
  • 保持动画微妙

首选场景类型:

  • 标题卡片
  • 分阶段的仓库截图
  • 组件特写
  • 标注叠加层
  • 架构图
  • 统计面板

避免:

  • 微小 UI
  • 长段落
  • 过于复杂的过渡

动画指南

首选简单确定的动画。

示例:

  • 淡入
  • 上滑
  • 交错显示
  • 微妙缩放

避免:

  • 弹跳效果
  • 复杂的物理动画
  • 繁重的缓动曲线

目标是清晰,而非壮观。


编码约定

使用:

  • React 函数组件
  • TypeScript
  • 命名导出
  • 显式类型
  • 可复用的动画包装器

避免:

  • 重复的动画代码
  • 魔术数字
  • 硬编码的场景时间

在可行时提取时间常量。

示例:

const TITLE_FADE_IN = 20;
const CALLOUT_DELAY = 15;

创建新场景的默认工作流程

  1. 定义场景的信息
  2. 定义帧数的时长
  3. 规划布局
  4. 添加主要动画
  5. 仅在能提高清晰度时添加次要动画
  6. 检查易读性
  7. 确保代码可复用

Nx 目标

  • preview — nx preview wallrun-video 打开 Remotion Studio
  • render — nx render wallrun-video 将完整视频渲染到 dist/demos/wallrun-video/
  • type-check — nx type-check wallrun-video 运行 TypeScript 编译器

完成标准

一个场景完成的条件是:

  • 信息立即可懂
  • 字体在视频比例下可读
  • 动画克制
  • 时间易于编辑
  • 代码结构清晰

相关技能