Communitygithub.com

建立入門引導影片 (Enricrypto/cypher-claude-skills)

使用 Remotion 製作簡潔有力的 iOS App 入門引導影片,透過動畫呈現 UI 局部元件(非全螢幕)來展示功能運作。適合用於建立、生成應用程式預覽、功能展示短片或 App Store 預告。

cypher-claude-skills) 是什麼?

這個技能讓開發者能利用 Remotion 快速生成 iOS App 的「功能展示」型入門引導短片。核心概念是「只展示功能運作中的關鍵 UI 元件(例如按鈕、卡片、切換開關)」,而非顯示整個螢幕。技能會引導使用者提供多張靜態截圖(例如:靜止狀態、互動中狀態、結果狀態),然後為每個畫面規劃一個簡短(3–8 秒)的「節拍」,並使用彈簧動畫、遮罩揭示、共享元素轉場等流暢過場將這些節拍串連起來。影片最終輸出為 MP4 格式,並可選直向版本供 App Store 使用。 此技能特別強調操作流程:在撰寫任何 Remotion 程式碼前,必須先調用 `remotion-best-practices` 技能,並將詳細的動畫與設計規則作為提示傳遞給它。規則包括:每段節拍必須有對應的靜態截圖(不可憑空虛構 UI)、游標必須以特定方式(從中心淡入、直線移動至目標)引導每個點擊操作、標題文字必須固定在頂部位置並遵循統一的進場動畫(從下方升起並淡入)、以及當連續節拍使用相同標題文字時,標題不得重新播放動畫。這些規則確保輸出的影片具有一致且專業的視覺風格,並能有效「展示」功能,而非「說明」功能。 支援的平台為任何可使用 Remotion 的開發環境(如 Cursor、Codex、Claude Code)。此技能的主要價值在於將抽象的功能描述轉化為視覺上吸引人且目標明確的短影片,特別適合 App Store 預覽、社交媒體功能展示或產品介紹頁面。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

建立入門引導影片

製作一部簡短、有力的 iOS 入門引導影片,使用 Remotion 展示一個功能的運作過程。輸出成果的風格應類似 App Store 預覽影片,聚焦於證明功能確實可用的關鍵時刻——而非教學、螢幕錄製或行銷短片。

你要製作的內容

  • 長度: 簡短。每個引導畫面約 3–8 秒,拼接在一起。整部影片很少超過約 30 秒。
  • 風格: 以 UI 為主,絕對不顯示整個螢幕。每個節拍展示的是功能運作中的一個片段——一個被點擊的按鈕、一個切換開關的撥動、一列的重新排序、一個滑出面板、一個圖表的填入——並透過良好的 UI 式過場動畫(彈簧、滑動、縮放、淡入淡出、遮罩揭示、共享元素切換)來呈現。
  • 「片段」的含義: 從提供的靜態圖中裁剪、遮罩或僅提取相關的元件——卡片、輸入欄位、分頁列、從空白狀態變成已填滿狀態的空狀態。畫面其餘部分則被省略、模糊化,或透過有色背景暗示。我們展示的是該功能做了什麼,而不是整個應用程式長什麼樣子。
  • 基調: 直截了當。每個節拍傳達該功能的一個作用。
  • 輸出: 一個 Remotion 專案,可渲染成 MP4(並可選擇為 App Store 預覽產生直向版本)。

工作流程

遵循以下循環。請勿跳過需求收集環節——猜測流程會產出泛泛的影片。

1. 需求收集——索取靜態圖與意圖

針對使用者想要強調的每個引導畫面,收集:

  1. 靜態畫面(螢幕截圖)——請針對每個畫面提供 2–4 張靜態圖,以便展示互動狀態:
    • 靜止狀態
    • 互動中狀態(按鈕按下、欄位聚焦、滑出面板到一半等)
    • 結果狀態(資料載入完成、成功、下一個畫面)
    • 任何值得展示的變化(空白 vs. 已填滿、淺色模式 vs. 深色模式等)
  2. 該功能是什麼——用一、兩句話說明這個畫面為使用者做了什麼,以及它讓人感覺良好的原因。這會引導我們放大顯示哪個細節。
  3. 順序——引導流程中畫面的先後順序。
  4. (選填) 品牌色/強調色、非常用字型、目標長寬比(iOS 預設 1080×1920 直向)、結束卡文字/行動呼籲按鈕。

當使用者表達模糊時,請使用 AskUserQuestion。在取得所有畫面的靜態圖與意圖之前,不要開始渲染。

2. 規劃鏡頭

針對每個畫面,找出該功能運作的單一關鍵片段——被點擊的按鈕、正在填滿的進度環、被滑動的列、自動完成的欄位——以及它如何過渡到下一個節拍。永遠不要讓整個螢幕動起來。 在編寫元件之前,先構思時間軸(焦點元件 → 動作 → 結果 → 下一個焦點元件)。偏好:

  • 從靜態圖中隔離/裁剪/遮罩相關元件,並將其放置在有色背景上
  • 呈現互動本身(點擊漣漪、拖曳、聚焦、狀態變化),而不只是靜態佈局
  • 節拍之間的共享元件過場(節拍 1 中的按鈕變成節拍 2 中的標題)
  • 分層元件上的微妙視差/景深效果
  • 基於彈簧的動畫,而非線性緩動

3. 使用 Remotion 建構

在編寫 Remotion 程式碼之前,請務必先調用 remotion-best-practices 技能。 調用時,請將以下指導方針包含在您的提示中:

建立一部簡短的 iOS App 入門引導影片。請勿渲染整個螢幕——每個節拍必須展示功能運作中的一個片段:一個被隔離/裁剪/遮罩的 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 直向;將寬度/高度作為屬性暴露出來,以便相同場景在需要時可渲染為橫向。

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.

相關技能