Communitygithub.com

產品影片

將你的產品實際畫面轉為34秒的上市影片:五幕結構(問題、承諾、產品展示、成果、行動呼籲),包含大游標、動態鏡頭、字幕與音效,提供寬、正方、直立三種比例。當使用者要求為其產品、應用程式或網站製作上市影片、行銷影片、宣傳片、展示影片、預告片或動畫時使用。

產品影片 是什麼?

這項技能專為使用Claude Code、Cursor、Codex等AI代理設計,可自動化從產品真實畫面生成專業上市影片的完整流程。影片嚴格遵循五幕結構(問題、承諾、產品展示、成果、行動呼籲),時長約34秒,並支援寬、正方、直立三種比例,內建大游標、動態鏡頭、字幕與背景音樂。技能會自動探查使用者提供的產品URL,擷取品牌色彩、字體與標誌,並撰寫分鏡故事。隨後使用Puppeteer擷取產品真實畫面,並根據預設範本合成影片。支援循環監控、自動校對與版本修訂,確保品質。使用前需安裝Node 20+、ffmpeg及本地Chrome核心瀏覽器。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/omnigami-ai/plugins/tree/main/plugins/omnigami-launch-films/skills/product-film

在你喜歡的 AI 中提問

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

說明文件

產品影片 是做什麼的?

若使用者有明確指示,則優先遵循使用者指示。僅處理已授權的產品與範例資料。 請勿要求提供密碼、API金鑰、付款資料、政府識別碼、健康記錄或其他敏感資料。 若需在工作專案中安裝缺少的本機相依套件,請先說明原因。網路存取權限僅限於 已授權產品及其合法資產,以及宣告的npm依賴項;請遵守存取控制。 一次僅處理一個作業,等待完成後再進行下一個。請將發布、發送和部署作業保留在此任務之外。

若有多項技能可完成相同任務: 當請求未指名此技能,且你的代理也擁有其他可製作同類作品(其他上市影片、截圖、簡報或模型)的omnigami技能時,請列出名稱,詢問使用者想使用哪一項再開始。若已指名,或這是唯一安裝的技能,則直接進行。

若為日文、韓文或中文產品頁面,請保留該語言的文案,並將影片的lang設為頁面<html lang>的值;內建的Noto字型與片語換行會自動處理文字。

製作一部能推銷一個產品的上市影片:以大字呈現問題,一行 承諾,在產品真實畫面上展示四個證明步驟,結果, 以及停留在最後一幀的行動呼籲。從reference/目錄中已完成的影片開始( Lamplit,一個為omnigami範例建立的虛擬開發者工具;故事位於 reference/STORY.md)。其工具組(字型、游標、頁面鏡頭、色彩欄位、 字幕欄、繪圖、音樂)保留;其文字、畫面與步驟則改為使用者的內容。

在開始建置前,請閱讀 style.md;在進行判斷前,請閱讀 critique.md。

開始或繼續

  • 檢查 Node 20+、ffmpeg 及本機 Chrome 核心瀏覽器 (scripts/chrome.mjs 會自動尋找;CHROME_PATH 可覆蓋路徑)。若缺少任何項目,請說明原因。
  • 使用使用者提供的資料:產品URL、欲展示或避免的內容、行動呼籲(註冊、安裝、一個URL)。在詢問前,請先閱讀網站一次。針對網站無法回答的問題,僅詢問一次。若使用者希望不提出問題或執行非監督運行,則根據網站內容自行決定。
  • 若 product-film/ 已存在且包含 film/STORY.md,則表示這是修訂版: 請對該影片進行修改。若為其他影片,請使用新資料夾,並重複使用 PRODUCT.md 中的品牌備註。

設定第一部影片:

mkdir product-film && cd product-film
cp -R "$SKILL_DIR/reference" reference && cp -R "$SKILL_DIR/scripts" scripts && cp -R "$SKILL_DIR/music" music
mkdir film && tar -C "$SKILL_DIR/reference" --exclude='./assets/screens' --exclude='./assets/brand' --exclude='./plans' -cf - . | tar -C film -xf -
npm init -y >/dev/null && npm i -D 'puppeteer-core@^24'

film/ 是不含畫面、品牌和計畫的參考版本。 puppeteer-core@^24 可在 Node 20 上運行;更新的主要版本可能需要更新的 Node 版本。

SKILL_DIR 是此檔案所在的資料夾。reference/ 保持不變,用作比較 基準。

了解產品,然後撰寫故事

  1. node scripts/capture.mjs <url> capture:檢視所有螢幕截圖,並閱讀 capture/brand.json。找出產品的用途、其使用的詞彙、品牌色彩與標誌,其所提出的聲明及來源,以及在何處可以找到其真實的使用者介面(頁面本身、即時示範、沙盒)。
  2. 依照 reference/STORY.md 的格式撰寫 film/STORY.md。這是一部 故事,而非功能導覽:
    • 觀眾及其目標: 產品為誰而設計,以及他們為此造訪的單一任務,使用網站本身的術語;
    • 阻礙他們的問題,網站本身提及的障礙(鉤子): 舊有方式及其代價,每一行都將被劃掉;
    • 轉折點: 以其自身術語呈現的鉤子的解答(與問題相反, 字數精簡),在一個節拍內提及產品名稱;
    • 在真實產品上朝目標前進的三或四個步驟,每個步驟包含一個 字幕(觀眾所做或所學的內容,幾個字)、要擷取的實際畫面與狀態、動作,以及回答字幕的螢幕結果;
    • 回報: 目標達成;行動呼籲: 單一動作;
    • 時間基於120 BPM網格,且每個聲明都附帶來源。數字 僅來自您引用的來源。 以陌生人的角度重新閱讀:若某個步驟的結果未回應其字幕,或某個步驟未朝目標前進,則進行修改。
  3. 用幾行文字向使用者展示故事(五幕、兩個動作),並要求進行一次審閱,除非使用者要求非監督運行。切勿將沉默視為同意。

擷取真實畫面

  1. 依照 reference/plans/lamplit.json 的格式撰寫 film/plans/app.json (格式說明位於 scripts/screens.mjs 頂端):
    • 故事中顯示的每個狀態,作為 click、type、drag(長按, 用於應用程式自身的按壓狀態)和 capture 步驟;
    • 每個畫面以完整尺寸、3倍縮放比例擷取,以便鏡頭能夠拉近;
    • 對於輸入欄位,使用 type 搭配其面板的 around(每個字母擷取一次);
    • rects:鏡頭、色彩欄位或游標使用的每個元素,按名稱標記。 一組擷取結果適用於所有比例:每種比例會自行取景。 使用 click 步驟關閉 Cookie 橫幅。對於影片自行繪製的內容,請使用 hide。
  2. 執行擷取:
    node scripts/screens.mjs film/plans/app.json film/assets/screens
    
  3. 檢視每個擷取結果。修正計畫,直到每個狀態都正確為止。若使用者介面 需要登入,請使用公開示範、使用者提供的螢幕截圖,或使用者明確授權的已登入本機瀏覽器。切勿要求提供憑證。切勿擷取客戶資料,也切勿繪製想像中的 使用者介面。

建立影片

編輯 film/index.html。其章節已標示為 KEEP、ADAPT 和 REPLACE。

  • ADAPT 文字: DEFAULTS 和 FIELDS,來自 STORY.md,包含 步驟字幕(step1 … step4)及其在 STEPS 中的時間。
  • ADAPT 顏色: 底色(INK、NIGHT、INK2)、文字和 來自產品的一個強調色(參考版本為深色優先;淺色 產品則使用其紙張和墨水色彩)。將產品的標誌放入 film/assets/brand/mark.svg;它會在轉折點下方放大,展開為 一行文字,並引導後續的組合。
  • ADAPT 證明: P(每次點擊和變更發生的時間)、screenAt (目前顯示的擷取畫面)、proofScene 中的構圖(頁面矩形,鏡頭會完整顯示, 直式比例使用較窄的範圍)、floats(正在操作的元素,在深色背景上 單獨顯示)、PATCH(狀態在原地更新時,唯一會變化的區域: 透過比對擷取畫面的差異來測量)、SETTLED (每個步驟的結果在畫面上穩定下來的時間),以及游標的 cursorSets。應用程式開啟的頁面會透過切換進入;一個在原地變化的狀態 只會在 PATCH 內部變化。
  • 每次點擊與游標同步: 使用 clickKeys 編寫每個游標集合 (其註解會顯示 Lamplit 的三個範例)。游標滑入、 到達目標後靜止停留 0.3–0.5 秒,在應用程式的按壓狀態顯示時 精準按下(相同的 P 時間驅動兩者),在按壓過程中保持靜止,然後離開。 輸入欄位的點擊方式相同;按壓結束後開始輸入文字, 游標移到一旁,在輸入期間保持靜止。切勿將游標的到達和離開時間 設定在點擊時間的兩側:這會導致游標在按下按鈕的同時滑離。 刪除 APPROVED_CURSOR 和 Lamplit 自身的集合(其已批准的剪輯版本早於此規則)。 若游標沒有停留在目標矩形上,或在按下前 0.25 秒內移動過, 影片的檢查將判定為失敗。
  • ADAPT 回報與行動呼籲: TILES(三個真實畫面的拼貼)以及 您的名稱、地址、要輸入的文字和標語。 保持各幕時間在小節線上,並保持提示與各幕同步。
  • KEEP 工具組、鏡頭、欄位、繪圖和 120 BPM 網格,並在觀眾需要的地方 留出空間(style.md,「暫停」):每個步驟的字幕在第一次動作前顯示;每個結果穩定後, 大約留一秒鐘閱讀,再進行下一個鏡頭或游標移動;在頁面切換 或長距離滑動後,畫面在點擊前先靜止。保持活潑:在證明過程中, 任何畫面靜止不動的時間不超過約 1.8 秒。當您的文字較長或 較短時,調整停頓時間(TU、ST、P),而非產品的實際操作。 當步驟需要的空間超過 34 秒時,一次延長一個小節 (2 秒),最多約 40 秒:一起移動 ST 和 DURATION, 保持各幕的比例(style.md,「五幕」),並更新 STORY.md 中的時間。 歌曲會自動適應新的長度(它會在結束前至少 3.5 秒 落在最後一個小節線上);使用 --music 時,將 music.sections 的最後一個 部分拉伸到新的小節數。

在專案根目錄撰寫 PRODUCT.md:包含 URL、產品功能描述、 品牌色彩與標誌(附授權資訊)、選擇的文字以及日期。

審閱、渲染、交付

  1. 針對每種比例進行工作表與手機檢查:
    node scripts/render.mjs film --all --times key --sheet
    node scripts/render.mjs film --all --phone
    
    然後在每個快速搖攝、拉遠和滿版畫面處,以寬和直式比例產生 12 幀條狀圖:node scripts/render.mjs film --size 9:16 --strip <time>。
  2. 使用 critique.md 評分,並修正最嚴重的問題。在交付前, 取得一次新的評判。若您的代理可以在沒有本次對話記憶的情況下啟動子代理, 則僅提供 critique.md、STORY.md 和影像給它, 其他都不給,並修正它發現的問題。否則,重新閱讀 critique.md 並僅根據影像評分。 低於 8 分的影片不得交付。經過三輪修訂後,報告剩餘的問題。
  3. 檢查可重複性、新分頁、長命名以及影片自身的檢查: node scripts/render.mjs film --all --check --check-fresh --stress。 在所有三種比例都通過檢查前,不要進行渲染。僅在新分頁中出現差異的幀, 通常表示影像是在影片中間才首次繪製:請在 prepare() 中一次繪製完成。 溢出的名稱需要調整以符合該比例在壓力測試長度下的限制。 檢查還會判定以下情況為失敗:游標未停留在目標上時按下按鈕、 游標移動時在欄位中輸入文字、結果顯示後到下一次移動前少於 0.9 秒、 字幕在點擊前沒有足夠的閱讀時間、證明過程中靜止不動超過 1.8 秒, 以及長度未對齊小節網格。請調整時序設定,而非檢查邏輯。
  4. 進行渲染:
    node scripts/render.mjs film --all --video --blur 4 --audio music/song.mp3 --sound --poster <time>
    
    此命令會產生 out/16x9.mp4、out/1x1.mp4 和 out/9x16.mp4:每秒 60 幀, 包含動態模糊、技能的歌曲與效果,音量約為 −14 LUFS。渲染需要數分鐘: 請在前景執行,等待三個檔案全部產生完成後再交付。 在非監督運行中,若將渲染作業留在背景執行,可能會在 工作階段結束時被中斷。歌曲(music/song.mp3:120 BPM 的 Nu-Disco)已針對 每種比例進行調整:它從一個小節線開始,將在接近結尾時,於一個拍點上落地, 鼓聲在此停止,其餘部分結束並淡出(來自 music/song-stems/ 中的音軌)。 --from <秒數> 可從其他不同的 8 小節段落開始(歌曲長度約兩分鐘)。 --music 則使用合成配樂;使用者自備的歌曲可使用 --audio their.wav 搭配使用。
  5. 執行 node scripts/preview.mjs film 並提供其 localhost 位址。它會播放 每種比例並允許編輯文字;儲存的編輯內容需要重新渲染才能更新 MP4 檔案。
  6. 撰寫 README.md(說明檔案、預覽方法、修改文字的方法、渲染方法) 和 out/CAPTION.md(一段少於 280 個字元的貼文,使用產品 自己的文字,並包含其 URL)。交付 MP4 連結、海報、 說明文字、簡短的檢查摘要,以及一個最能改善影片的變更建議。將詳細評分記錄在 out/REVIEW.md 中。

修訂

對於「結果停留久一點」或「顯示匯出功能」等要求, 請編輯當前故事與影片。保留已批准的內容和使用者儲存的文字。 僅重新擷取已變更的狀態,重新執行檢查,重新 渲染,並更新 STORY.md 和 PRODUCT.md。

嚴格規則

  • 僅使用擷取的真實畫面;僅使用範例資料;僅使用使用者的品牌。
  • 畫面上的每個聲明都必須在 STORY.md 中有來源。
  • 留出呼吸空間:每個步驟的字幕必須在任何動作前展示完畢、 元素必須在操作前先被看到,且每個結果在鏡頭或游標下一次移動前, 必須有大約一秒的閱讀時間。任何畫面靜止不動的時間不得超過約 1.8 秒。 當故事無法容納時,一次延長一個小節(最多約 40 秒),或刪除一個步驟; 絕不壓縮停頓時間。
  • 游標在按下時必須停留在目標上,並與應用程式自身的按壓狀態同步(clickKeys)。
  • seek(t, values) 僅從其參數繪製:不使用時鐘、未播種的 隨機性、計時器或網路。使用 CPU 支援的 Canvas,每幀重置。
  • 影片載入的每個檔案都必須位於 film/ 目錄內。

檔案列表

  • reference/:Lamplit 的上市影片、STORY.md、擷取計畫 (plans/lamplit.json)、擷取的畫面、標誌以及附帶 OFL 授權的字型(Instrument Sans、JetBrains Mono)。Lamplit 是一個 為 omnigami 範例建立的虛構公司。
  • style.md:文法規則,附帶數字範例。critique.md:審查指南。
  • music/:技能的歌曲及其音軌。
  • scripts/:screens.mjs(真實畫面的狀態擷取)、capture.mjs(從 URL 擷取品牌資訊)、render.mjs(靜止幀、條狀圖、檢查、MP4)、preview.mjs、 music.mjs、song.mjs(調整提供的歌曲)、包含音效工具組的 sfx.mjs,以及 chrome.mjs。

此技能為 omnigami 所有,© 2026 Auberon LLC。您可以使用其產出的任何內容, 包括商業用途,並可自行修改此技能;但請勿重新散布或 販售此技能。完整條款請參閱 LICENSE.md。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相關技能