Communitygithub.com

mertz1999/luma-assistant

建立電影級 SaaS 示範影片頁面與可螢幕錄製的產品簡報。當 Codex 被要求建立 /demo 路由、動畫產品導覽、SaaS 促銷簡報、螢幕錄製頁面、旁白產品示範、游標驅動 UI 故事,或為應用程式/網站建立可重複使用的示範影片系統時使用。

luma-assistant 是什麼?

此技能專為 AI 代理(如 Codex)設計,用於建立全螢幕、自動播放的 SaaS 產品示範頁面,適合錄製成精美的示範影片。它能自動生成一個完整的演示系統,包含分鏡場景、動畫轉場、游標模擬及畫外音同步功能,特別擅長以客戶故事而非功能列表的方式呈現產品價值。支援 Next.js 及通用 HTML/React 框架,並整合 Framer Motion 實現電影級視覺效果。技能會自動收集必要的產品資訊、品牌素材及工作流程限制,確保示範內容真實反映產品實際行為,避免虛構功能。最終產出包含可播放的演示頁面、場景時間表、畫外音腳本及錄製建議,並通過 Playwright 等工具進行跨尺寸驗證,確保在桌面與行動裝置上都能正常顯示。

相容平台~Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/mertz1999/luma-assistant/tree/HEAD/skills/saas-demo-video

在你喜歡的 AI 中提問

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

說明文件

SaaS 示範影片

成果

建立一個全螢幕、自動移動的示範頁面,可錄製成精美的 SaaS 產品影片。優先採用簡短的客戶故事而非功能導覽:問題鉤子、產品行動、客戶時刻、結果揭露、商業成果、最終行動呼籲。

使用此技能來建立或改善如 /demo、/presentation、/video-demo 等路由,或等效的獨立 HTML/React 頁面。

必要輸入

在實作前收集或推斷以下資訊。僅針對阻礙項目提問。

  • 產品名稱、領域、目標受眾與主要承諾。
  • 目標時長與長寬比,通常為 30-60 秒與 16:9。
  • 要展示的現有應用程式路由:註冊、儀表板、產品建立、連結建立、客戶頁面、分析。
  • 品牌素材:標誌、顏色、字型、產品圖片、客戶圖片、螢幕截圖、圖示、手機框架。
  • 真實工作流程限制:應用程式實際做了什麼、哪些是手動、哪些是自動、哪些資料可用。
  • 畫外音腳本或時間軸。如果使用者已產生音訊,請使用確切的時間戳記。
  • 最終行動呼籲與錄製 URL。

絕對不要發明產品不支援的行為。如果商家手動複製連結,就說「手動複製連結」,而不是說應用程式自動發送。

分鏡

預設 30-50 秒結構:

  1. 問題鉤子:展示一個真實的客戶問題或痛點。
  2. 管理員操作:新增產品、建立私有連結、複製訊息。
  3. 客戶時刻:客戶收到連結、開啟、上傳圖片、開始生成。
  4. 結果揭露:前/產品/結果並排顯示,搭配乾淨的揭露動畫。
  5. 商業成果:重要的儀表板指標。
  6. 最終行動呼籲:簡短的產品承諾與網域。

使用應用程式的真實網域與真實產品用語。對於社交商務,Instagram 風格的 DM 介面僅作為視覺敘事工具,除非產品實際整合了 Instagram API。

實作模式

使用應用程式現有技術棧。對於 Next.js 應用,偏好:

  • 一個如 src/app/demo/page.tsx 的路由。
  • 一個用於計時簡報的客戶端元件。
  • Framer Motion 用於場景轉場、游標移動、揭露效果、微光與縮放。
  • 現有 UI 元件、標誌、調色板與素材。
  • 查詢參數場景預覽,例如 /demo?scene=resultReveal。

核心示範元件行為:

  • 將場景定義為資料:id、title、caption、durationMs、cursor 以及選擇性的視覺焦點/攝影機元資料。
  • 根據 durationMs 計算場景開始時間。
  • 使用真實時鐘時間軸,使開發者熱重載或重新渲染不會意外重設播放。
  • 除非使用者想要純錄製頁面,否則加入播放、暫停、重新開始、上一個與下一個控制項。
  • 如果與生成的音訊同步,請確保場景時長與音訊時間戳記範圍完全吻合。
  • 為重要的 UI 控制項加入 data-demo-cursor-target 屬性,並透過 getBoundingClientRect() 計算游標位置。當有真實目標時,避免使用硬編碼的游標座標。
  • 使用 ResizeObserver 與 requestAnimationFrame 在各種視口尺寸下保持游標目標準確。
  • 尊重減少動畫設定。

視覺方向

營造現代 SaaS 上市/示範影片的感覺:

  • 全螢幕舞台,而非一般的說明文件頁面。
  • 對重要點擊進行電影級縮放。
  • 從前一個游標位置連續移動的平滑游標動畫。
  • 簡短疊加標題:「1. 新增產品」、「2. 傳送連結」、「3. 客戶試用」。
  • 在瀏覽器/手機框架內的實際應用程式截圖或擬真 UI 模擬圖。
  • 結果揭露時刻,帶有閃爍、擦拭、模糊轉銳利或並排比較效果。
  • 乾淨的儀表板成果畫面,顯示 2-4 個高訊號指標。
  • 避免密集段落、開發者日誌及虛假技術術語。

對於行動客戶流程,使用手機框架。確保框架內的內容在桌面與行動錄製視口中都清晰可讀。

旁白與時間

如果使用者需要畫外音,提供語音模型的提示:

  • 語調:自信、溫暖、高級、清晰、不機械。
  • 節奏:符合目標時長。
  • 產品名稱的發音說明。
  • 按場景標記時間的腳本。

如果使用者提供生成的音訊時間戳記,請將場景時長更新為這些確切範圍,並驗證總時長。

請參閱 references/storyboard-and-voiceover.md 以取得可重複使用的時間與旁白範本。

驗證

在完成之前:

  • 在本機執行應用程式,或確認現有的開發/生產伺服器。
  • 執行相關檢查:型別檢查、lint、建置或框架等效項目。
  • 使用 Playwright/瀏覽器檢查桌面與行動尺寸。
  • 確認沒有水平溢出。
  • 確認手機框架內容可見。
  • 使用 DOM 目標測量確認游標落在預期的按鈕上。
  • 如果實作了查詢參數,確認每個預覽場景都能正常運作。
  • 確認最終公開 URL 或本機 URL 回傳 200 OK。
  • 如果嵌入了影片 iframe,請確認 iframe 存在於渲染後的 HTML 中。

如有任何僅在開發環境出現的警告,請另外回報,例如開發伺服器使用公開 IP 時的 Next HMR WebSocket 失敗。

交付

回傳:

  • 示範頁面 URL。
  • 新增或變更了哪些路由/檔案。
  • 場景時長表格。
  • 畫外音提示(若要求)。
  • 驗證命令/結果。
  • 任何錄製備註,例如建議的視口尺寸與是否隱藏控制項。

相關技能