Communitygithub.com

產品宣傳影片,以程式碼呈現

指導 AI 代理如何規劃、建構或剪輯「產品宣傳影片」,最終產出完整的影片剪輯。流程涵蓋產品宣傳片,以程式碼渲染,以及 Studio 視窗中的簡報與引導模式。當有新任務需要這項技能時使用。

產品宣傳影片,以程式碼呈現 是什麼?

此技能定義了一個基於函數式與程式化的影片製作流程,特別適合 AI 代理用於創建產品宣傳片、教學影片或更新內容。其核心概念是將影片視為一個數學函數:`seek(t)` 會從頭開始繪製時間 `t` 的幀。無頭 Chrome 會為每個影片幀捕獲多個子幀,並由 ffmpeg 混合與編碼,實現逐幀可審查、低成本修改以及精確循環。技能附帶一整套模板,包括一個完整的 `film.js` 引擎,支援場景、章節、超過 20 種 2D 與 WebGL 轉場、彈簧動畫、攝像機以及景深等特效。它還包含向量零件(macOS 視窗、瀏覽器、終端機、各類 Apple 設備)、內建 13 種風格的動態排版引擎、以及四種立即可用的開源字體。在開發環境方面,此技能涵蓋了從頭開始建立工作目錄、使用 `studio.mjs` 的視覺化設定嚮導(可產生一個 `brief.json`),到透過 `render.mjs` 進行可恢復、並行的渲染,並以 `deliver.mjs` 完成最終交付的完整流程。技能也處理配備有 AI 模型的旁白製作(支援 Chatterbox、Orpheus 和 Kokoro)、音樂混音、節拍分析、點擊校驗與版面容錯檢查。它支援 Cursor、Claude Code、Codex、Windsurf 與 Aider 等平台,其威力來自於將整個影片工作流程抽象為一個可被版本控制、反覆審查並精確重現的程式碼庫,使影片創作與軟體開發同樣嚴謹。

相容平台✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/gfazioli/manovella/tree/HEAD/plugins/manovella/skills/site-promo-film

在你喜歡的 AI 中提問

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

說明文件

產品宣傳影片,以程式碼呈現 是做什麼的?

一個頁面,一個畫布,seek(t) 從頭開始繪製時間 t 的幀。無頭 Chrome 為每個幀捕獲 N 個子幀,ffmpeg 混合並編碼它們。影片是一個 函數;影片是對它的取樣——這使得每一幀都可審查,每一次修改都成本低廉,並且循環精確。

這些檔案隨此技能附贈。將它們複製到影片的工作資料夾中;不要重寫 引擎。

檔案說明
template/promo.html引擎加上一個 8 秒的示範:閉合式彈簧、彈簧求和軌跡、一個相機、文字輔助功能(表格數字、翻轉)、標題、一個真實的游標、一個單一物件變形鏈,以及一個用於真正 3D 的 WebGL 合成器。開箱即用並可渲染。
template/reel.html時間軸上的長片:六個場景,六種格式(動態字體、瀏覽器、一個具有對焦變換的便當網格、終端機、一個 3D 設備封面流、一個尾卡),五個轉場,每個場景一種外觀,章節。約 56 秒非循環片段。§2 的目錄,實際運作。
template/film.js頁面共用的引擎:舞台(每個子幀的亞像素抖動,因此緩慢移動中不會出現階梯或閃爍)、用於光柵的 FILM.draw、彈簧和相機、時間軸(場景、章節、檢查點和二十四種轉場:十六種在 2D 畫布上,八種作為一個 WebGL2 上下文上的片段著色器)以及效果(景深、鏤空字體、打字效果)。頂部有文件說明。
template/parts.js向量零件:macOS 視窗、瀏覽器、終端機、iPhone、iPad、MacBook、iMac、鍵帽、開關、環、按鈕、指標。每個都會傳回其內容放置的矩形。
template/parts.html所有零件集中在一個 16:10 的頁面上,與其他頁面相同:PAGE=parts.html node render.mjs stills parts 0 會生成 docs/parts.jpg 轉換自的 PNG(使用 sips -s format jpeg -s formatOptions 92)。
template/fx.js外觀,由頁面載入:背景(純色、漸層、場域或圖片;柔和品牌光;視差中的點、網格或線條;透視地板;聚光燈)、收尾效果(暗角、顆粒)以及依賴它的效果(磨砂玻璃、點擊漣漪、對焦拉近標題)。23 個預設和 photo,每個欄位都可覆蓋,檔案頂部有文件說明。與 release-film 共享。
template/type.js標題和動態字體(§3):TYPE.draw(ctx, t, spec) 有十三種樣式——升起、對焦、穩定、軌跡、擦除、串聯、字重、分割、翻轉、打字、交換、里程表、解碼——帶有強調標記、節奏,以及用於字體家族的 TYPE.load。像其他功能一樣,是 t 的純函數。
template/fonts/二十個開放授權的字體家族(拉丁文 + 拉丁擴展 woff2,每個都附有 OFL.txt)和 fonts.json 它們的字型。一個影片只複製它使用的到 src/fonts/ 中;scripts/fonts.mjs add 會獲取另一個。
scripts/render.mjsstills <dir> t…、sheet <dir>(時間軸的檢查點)、looks <dir> <t>、loopcheck、video <out> [workers]。從頁面讀取尺寸、fps、持續時間和章節;抖動每個子幀;以可恢復的區塊渲染;FROM/TO、PREVIEW=1、RESUME=1、KEEP=1、AUDIO=、SHUTTER=;副檔名決定格式(.mp4、.mov ProRes、.webm、.gif;HEVC=1;ALPHA=1 用於透明 .mov 或 .webm);在渲染前檢查軌道,在渲染後檢查檔案;如果頁面失去 WebGL 上下文則捕獲失敗,如果在渲染進行中嘗試二次渲染則失敗。頂部有文件說明。
scripts/narrate.mjs一個影片的故事(story.json:每一步一句話,一個教學或宣傳片的敘述)轉換為聲音、時鐘和字幕:voice/*.aiff、narration.wav(影片的 AUDIO)、narration.js(每一步的時間,供頁面使用)以及 captions.srt / .vtt。使用 Mac 的 say,或 --from 你自己的錄音資料夾。"human": "natural" 會像真人一樣變化停頓;模型發出的聲音([chuckle])會從字幕中排除。頂部有文件說明。
scripts/voice.mjs同一個故事由在 Mac 上執行的語音模型講述(story.json 中的 "mlx":用於課程的 Chatterbox、用於宣傳片的 Orpheus、用於快速草稿或義大利語影片的 Kokoro),比 say 更像真人:它會朗讀每一步(voice-mlx.py,透過 mlx-audio),調整其節奏和音量,然後呼叫 narrate.mjs。一個 take 是一個種子;"tone"(平靜、溫暖、明亮)是模型朗讀的自由度,"human" 會在 3% 內變化每行的節奏,並允許一行發出聲音([chuckle]、[sigh]:每個模型自己的拼寫,或省略)。--audition 比較不同 take,--recordings 停在錄音,--setup 製作 Python 環境並在每台 Mac 上只獲取一次模型(voice-constraints.txt 固定其安裝的內容)並告知該 Mac 是否重複在此錄製的 take。頂部有文件說明。
scripts/mix.mjs將一個語音軌和一個音樂軌混合成一個音軌,用於 AUDIO=:兩者都經過測量(EBU R128),音樂在語音說話時 --under LU 低於語音,在句子之間 --lift dB 升高,在每行開始前降低;輸出結果及其測量值。頂部有文件說明。
scripts/contact.mjs一個來自靜態圖片或外觀資料夾的附標題聯絡表(標題來自其中的 labels.json);--size WxH 使其剛好是那個大小(--font、--gap、--pad;靜態圖片絕不裁剪;.jpg 會以 JPEG 寫入);--dark 用於深色表格。--compare A=<dir> B=<dir> [C=<dir>] <out.png>:兩個或三個資料夾並排,每個一個帶標籤的欄位,每個它們共有的靜態圖片一行,用於在一張圖片上進行 A/B 選擇。
scripts/beats.mjs一個音軌的節拍,來自其樣本:節奏、是否穩定、每個節拍、小節、段落,以及提供給頁面的 bpm 和 AUDIO_AT;--out beats.js 用於跟隨一個漂移軌道的頁面(FILM.beats)。render.mjs 匯入它以將頁面的節拍與軌道的節拍進行比對。--selftest。
scripts/clickcheck.mjs每次點擊是否都被看見:對於頁面的每個 CLICKS,點擊點在螢幕上的移動速度以及在按下前和按下期間游標移動的距離。如果點擊無人能看到則退出 1(release-film §3b),如果頁面沒有游標則退出 2。
scripts/layoutcheck.mjs每個標題是否都在畫面內、分開且可讀:在每個檢查點,每個 TYPE.draw 繪製的標題,與安全區域、其他標題和周圍背景進行比較(限制在其標頭中)。如果標題失敗則退出 1,如果頁面完全沒有透過 TYPE.draw 繪製則退出 2。
scripts/deliver.mjs最後一步(§8):完成的影片及其封面離開工作資料夾到一個自己的資料夾;一旦影片完成輸出,trash 會在檢查其來源在套件中安全後丟棄工作資料夾。--selftest。
scripts/fonts.mjs套件的字體:add "<Family>" [axes] 從 Google Fonts 獲取及其授權,check、list。

除了它們之外,還有 studio/(下方的 Studio)、guide.md(下方的引導模式)和 README.md (圖片目錄,以及針對影片每個階段的範例請求)。

設定:一個工作資料夾,~/Downloads/<name>-work/(~/Downloads 是工作根目錄,除非下方設定檔中的 workRoot 另有指定),頁面和這些檔案都在其 src/ 中, 並在該處執行 npm i playwright-core。它會透過 channel: 'chrome' 驅動已安裝的 Chrome,因此 無需下載其他東西。<name> 是 <product>-<what>(例如 acme-promo、 acme-2.4-whats-new),並且它也會命名交付資料夾和每個交付檔案(§8)。

Studio:一個視窗中的簡報

視覺化的進入方式。一個在其自身視窗中的精靈:配方、格式、外觀、來自 Mac 的圖片、 在真實引擎上運行的動態字體和動作、以產品的顏色和比例呈現、聲音(音樂庫的曲目播放、語音模型的聲音在選擇前朗讀一行)、 以及每個選擇都寫入一個 brief.json。無需安裝任何東西,也不進行渲染。 /manovella:studio 也可以打開它。

  • 何時使用:當呼叫 studio 時使用,或者當對話中完全沒有提到要製作哪個影片時使用。 已經以文字表達需求的用戶可以直接進入 §0。
  • 執行:從工作區在背景執行 node <此技能目錄>/studio/studio.mjs(其儲存庫的 同級目錄即為所提供的產品),並用一行文字說明視窗已打開。 它會自行退出,列印一行文字,退出時會喚醒你:BRIEF <path>、或 CANCELLED、 CLOSED、TIMEOUT(說明並停止)。該視窗是 Studio 在此 Mac 上建構的自家應用程式 (~/Applications/Manovella.app,其名稱、版本和圖示會出現在 Dock 中),否則是一個 Chrome 應用程式視窗;MANOVELLA_WINDOW=chrome 會保留 Chrome。如果沒有這兩者,它會打開預設 瀏覽器;--no-open 則會列印 URL,適用於螢幕在別處的 session。
  • 音樂庫是選用的:一個包含用戶影片音樂的資料夾,可以放在任何他們喜歡的地方 (一個同步的磁碟、一個專案資料夾)。它的位置由一次性的 MANOVELLA_MUSIC 指定,否則由 ~/Library/Application Support/manovella/settings.json 中的 musicLibrary 指定 (在非 macOS 系統上是 ~/.config/manovella/settings.json;開頭的 ~ 會被展開);同一個檔案中的 musicLibraryIgnore 列出了要跳過的資料夾名稱,而 deliverToLibrary(true 或 false,預設為 false)則指定完成的影片是否也放入其中。沒有自動檢測。一個較舊的檔案,帶有 brandLibrary 和 brandLibraryIgnore 鍵,會被讀取為 musicLibrary 和 musicLibraryIgnore,並啟用 deliverToLibrary,如其之前所做,並且在 Studio 的設定中進行第一次更改時會用新鍵重寫。同一個檔案也接受 projectFolders(Studio 用於 查找產品的位置)、pictureFolders(其背景圖片位置;未設定:~/Pictures)和 workRoot(<name>-work 以及,除非影片被交付到庫或專案有 指令,<name>/ 的位置;未設定:~/Downloads);Studio 的設定視窗(Manovella.app 中標誌或 ⌘ 旁邊的齒輪圖示)可以寫入所有這些設定,並且 deliver.mjs 也會讀取 workRoot。 程式碼中沒有其他地方讀取庫鍵:對於沒有使用 Studio 製作的影片,本段就是給我的指示。
    • Studio 會提供音樂庫頂層以及每個資料夾中(直接或在該資料夾的 audio/ 資料夾中)的每個音訊檔案(mp3、m4a、aac、wav、aiff、flac、ogg);會跳過點資料夾和 musicLibraryIgnore 中的名稱。 按品牌分類的資料夾是可選的,並會對其曲目進行分組;以產品命名的資料夾會排在第一位(「此產品的」)。一個可選的備註檔案 位於曲目旁邊(…notes.txt 或 .md:每個曲目一段,以曲目的檔案 名稱開頭:說明它是什麼、其氛圍、適合哪裡)說明每首曲目的用途,Studio 會顯示它。
    • 完成的影片:如果 deliverToLibrary 為 true 並且有設定庫,則放在 <library>/<Brand>/video/<name>/ (§8);否則根據專案自身指令存放完成的媒體,或者放在工作根目錄的 <name>/ 中(預設為 ~/Downloads/<name>/)。
    • 一個新製作的曲目(見下文)會保存在庫中,如果庫按品牌分類,則保存在產品的資料夾中,並附上其在該資料夾 備註檔案中的段落(當庫存在時);否則只會放在影片的 src/audio/ 中。檔案提供者(Google Drive、iCloud Drive、Dropbox)中的資料夾可能會將其檔案保持為「無資料」狀態直到被打開,因此請在測量之前先打開或複製一個檔案。庫保存的檔案會被複製,絕不會從庫中移出。
  • brief <path>,作為參數或來自 BRIEF 行:讀取簡報;它回答了 §0。
    • formats: [] 是我選擇的三種格式。對於宣傳片或有章節的影片,一個、兩個或三個命名的格式 是分鏡的格式,按此順序,我選擇其餘的,每個都不同;一個版本更新和一個 教學影片的格式是它們自己的(whatsnew、tutorial),永遠不會填寫。look: null 是 外觀表(§4)。

    • frame:產品顯示在什麼之中,無論格式為何;null 是每種格式自己的( 瀏覽器用於逐步導覽,終端機用於命令列,Mac 視窗用於教學),由我選擇。

      • window:其在 macOS 視窗中的應用程式(PARTS.window)。
      • macbook:從正面看的 MacBook,其螢幕上是應用程式的視窗或網站的瀏覽器 (PARTS.laptop、PARTS.notch 最後繪製)。
      • imac:從正面看的 iMac,在其支架上,其桌面上是應用程式的視窗或網站的 瀏覽器(PARTS.desktop:其矩形是本體,547 : 375,支架在其下方繪製; color 是 Apple 的七種顏色之一,或是最接近的品牌強調色)。沒有 瀏海:相機在白色邊框中。
      • iphone、ipad:設備(PARTS.phone,最後繪製 PARTS.island;PARTS.tablet, 根據其矩形平放或直立,相機在其長邊上),產品自身的佈局在其 上(§1),並且每次點擊都是一次觸摸:一個柔軟的圓盤,會按壓,帶有外觀的漣漪,絕不使用 PARTS.ARROW;教學片會說點按。
      • browser:產品作為 PARTS.browser 中的一個頁面,其真實位址在欄位中。
      • terminal:PARTS.terminal,使用 FILM.typed 打字。
      • bare(Studio 中的僅 UI):產品自己的 UI,一個帶有圓角和陰影的浮動面板, 沒有視窗裝飾或設備環繞。產品仍然在 螢幕上:一個沒有產品的影片是動態字體格式,而不是這個。

      對於每個展示產品的故事板中的每個場景,此幀都會保持不變:一個 iPhone 應用程式的教學片 會從第一步到最後一步都在 iPhone 上講述。一種本身是表面 的格式會適應它:使用 iphone 的瀏覽器逐步導覽是該寬度下手機中的網站; 使用 macbook 或 imac 的終端機是 Mac 桌面上的終端機視窗。3D 中的設備是 唯一一種顯示多個設備的格式:選定的設備引導封面流(面向 相機的第一張卡片,以及它會回來的卡片),而其他設備跟隨它。如果幀和一個格式 衝突(例如,macbook 中的終端機?那只是桌面上的終端機),則格式優先。

      frame 的 backdrop(一個平面顏色,或 photo(file)、field(…)、gradient(…)、dots(…)、grid(…)、lines(…)、floor(…)), 或 null 用於鏡像視窗背景。對於一個沒有格式的影片(標題卡、循環播放),它總是 null。

      • 對於 macbook、imap、iphone 和 ipad,有一個標準幀:從正面, 在其支架或旋轉底座上,水平,比例在 PARTS 中。如有需要,我會拍攝 該設備的照片(photo(…))以獲得正確的比例,但標準幀對於 螢幕錄製和 UI 特寫已經足夠。iphone 總是帶有動態島,除非 PARTS.phoneShort 更好(Mini 或 SE,例如一個 工具或一個簡單的 UI)。ipad 總是帶有螢幕上的相機。在 Studio 的 圖片庫中,一個設備照片會覆蓋標準幀。

      一個自定義幀可以作為 Studio 中的 frame:*Choose from Pictures…* 提供(類型 photo(<file>),一個 <file> 的名稱)。

    • CONTINUE:如果簡報有 CONTINUE: true,則從上一個影片繼續,沒有介紹。在 快速的版本更新中很有用。

    • THEME、BRAND_NAME 等:用於該電影的品牌和主題。

引導模式:?

在提示中插入一行以獲取特定步驟的任務特定指導。例如,? 建立一個新的工作資料夾

此引導模式的完整文件位於 guide.md 中,在同一個技能目錄中。它解釋了如何

  • 建立一個工作資料夾(guide.md §0)
  • 規劃故事並使用 Studio 設定一個實例(guide.md §1)
  • 製作 UI 操作(guide.md §2)
  • 動態排版(guide.md §3)
  • 外觀與感覺(guide.md §4)
  • 特效(guide.md §5)
  • 音效與旁白(guide.md §6)
  • 渲染、產出和交付(guide.md §7)
  • 交付最終影片(guide.md §8)

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能