產品影片 是做什麼的?
若使用者有明確指示,則優先遵循使用者指示。僅處理已授權的產品與範例資料。 請勿要求提供密碼、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/ 保持不變,用作比較
基準。
了解產品,然後撰寫故事
node scripts/capture.mjs <url> capture:檢視所有螢幕截圖,並閱讀capture/brand.json。找出產品的用途、其使用的詞彙、品牌色彩與標誌,其所提出的聲明及來源,以及在何處可以找到其真實的使用者介面(頁面本身、即時示範、沙盒)。- 依照
reference/STORY.md的格式撰寫film/STORY.md。這是一部 故事,而非功能導覽:- 觀眾及其目標: 產品為誰而設計,以及他們為此造訪的單一任務,使用網站本身的術語;
- 阻礙他們的問題,網站本身提及的障礙(鉤子): 舊有方式及其代價,每一行都將被劃掉;
- 轉折點: 以其自身術語呈現的鉤子的解答(與問題相反, 字數精簡),在一個節拍內提及產品名稱;
- 在真實產品上朝目標前進的三或四個步驟,每個步驟包含一個 字幕(觀眾所做或所學的內容,幾個字)、要擷取的實際畫面與狀態、動作,以及回答字幕的螢幕結果;
- 回報: 目標達成;行動呼籲: 單一動作;
- 時間基於120 BPM網格,且每個聲明都附帶來源。數字 僅來自您引用的來源。 以陌生人的角度重新閱讀:若某個步驟的結果未回應其字幕,或某個步驟未朝目標前進,則進行修改。
- 用幾行文字向使用者展示故事(五幕、兩個動作),並要求進行一次審閱,除非使用者要求非監督運行。切勿將沉默視為同意。
擷取真實畫面
- 依照
reference/plans/lamplit.json的格式撰寫film/plans/app.json(格式說明位於scripts/screens.mjs頂端):- 故事中顯示的每個狀態,作為
click、type、drag(長按, 用於應用程式自身的按壓狀態)和capture步驟; - 每個畫面以完整尺寸、3倍縮放比例擷取,以便鏡頭能夠拉近;
- 對於輸入欄位,使用
type搭配其面板的around(每個字母擷取一次); rects:鏡頭、色彩欄位或游標使用的每個元素,按名稱標記。 一組擷取結果適用於所有比例:每種比例會自行取景。 使用click步驟關閉 Cookie 橫幅。對於影片自行繪製的內容,請使用hide。
- 故事中顯示的每個狀態,作為
- 執行擷取:
node scripts/screens.mjs film/plans/app.json film/assets/screens - 檢視每個擷取結果。修正計畫,直到每個狀態都正確為止。若使用者介面 需要登入,請使用公開示範、使用者提供的螢幕截圖,或使用者明確授權的已登入本機瀏覽器。切勿要求提供憑證。切勿擷取客戶資料,也切勿繪製想像中的 使用者介面。
建立影片
編輯 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、產品功能描述、
品牌色彩與標誌(附授權資訊)、選擇的文字以及日期。
審閱、渲染、交付
- 針對每種比例進行工作表與手機檢查:
然後在每個快速搖攝、拉遠和滿版畫面處,以寬和直式比例產生 12 幀條狀圖:node scripts/render.mjs film --all --times key --sheet node scripts/render.mjs film --all --phonenode scripts/render.mjs film --size 9:16 --strip <time>。 - 使用
critique.md評分,並修正最嚴重的問題。在交付前, 取得一次新的評判。若您的代理可以在沒有本次對話記憶的情況下啟動子代理, 則僅提供critique.md、STORY.md和影像給它, 其他都不給,並修正它發現的問題。否則,重新閱讀critique.md並僅根據影像評分。 低於 8 分的影片不得交付。經過三輪修訂後,報告剩餘的問題。 - 檢查可重複性、新分頁、長命名以及影片自身的檢查:
node scripts/render.mjs film --all --check --check-fresh --stress。 在所有三種比例都通過檢查前,不要進行渲染。僅在新分頁中出現差異的幀, 通常表示影像是在影片中間才首次繪製:請在prepare()中一次繪製完成。 溢出的名稱需要調整以符合該比例在壓力測試長度下的限制。 檢查還會判定以下情況為失敗:游標未停留在目標上時按下按鈕、 游標移動時在欄位中輸入文字、結果顯示後到下一次移動前少於 0.9 秒、 字幕在點擊前沒有足夠的閱讀時間、證明過程中靜止不動超過 1.8 秒, 以及長度未對齊小節網格。請調整時序設定,而非檢查邏輯。 - 進行渲染:
此命令會產生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搭配使用。 - 執行
node scripts/preview.mjs film並提供其 localhost 位址。它會播放 每種比例並允許編輯文字;儲存的編輯內容需要重新渲染才能更新 MP4 檔案。 - 撰寫
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。