Communitygithub.com

CambridgeMonorail/WallRun

建構與編輯 WallRun 的 Remotion 示範影片,並置於 Nx 單一儲存庫的 demos 目錄中。

WallRun 是什麼?

此技能用於協助開發者在 Nx 單一儲存庫 (monorepo) 環境中,建立與維護 WallRun 專案的 Remotion 示範影片。影片存放於 `demos/wallrun-video` 目錄,目標觀眾為前端開發者,因此內容應採用編輯風格、簡潔現代且動畫收斂,避免行銷影片的誇張效果。技能明確定義了專案結構(components、scenes、data)、場景設計規則(單一概念、4-8 秒、大字體)、動畫指南(淡入、滑入、漸露)以及編碼規範(React functional components、TypeScript、named exports),確保影片易於編輯且程式碼可重用。支援 Nx 指令如 `preview`、`render` 和 `type-check`,方便快速預覽與產出影片。

相容平台~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 編譯器

完成定義

一個場景在以下情況視為完成:

  • 訊息能立即被理解
  • 字體在影片比例下可讀
  • 動畫受到節制
  • 時間設定易於編輯
  • 程式碼結構清晰

相關技能