Communitygithub.com

designos-beat-edit-video

製作推廣 design:os studio 應用程式的行銷影片 — 每次使用真實的 Studio 畫面、全新的點子、視覺、動態與音樂。適用於 TikTok/Reels/Shorts 節拍剪輯與 3–5 分鐘的 YouTube 教學影片,並搭配經過核准的越南語旁白。

designos-beat-edit-video 是什麼?

這個技能會根據一份規格 JSON 自動產生 marketing 影片,重點是推廣 design:os studio 應用程式。每支影片會展示應用程式的一個實際功能、一個明確的承諾與一個行動呼籲,並確保應用程式本身是影片的主角,而非剪輯技巧。它支援 TikTok、Reels、Shorts 的節拍剪輯以及 3–5 分鐘的 YouTube 教學影片(附越南語旁白)。 此技能強制要求每支影片與先前所有影片都不同:點子、功能、畫面、結構、調色盤、動態與音樂都必須是新的。所有畫面都必須透過 Openscreen 重新錄製,來自真實的 design:os studio 應用程式,不能使用舊素材或任何模擬畫面。管線會先產生一個創意計畫與規格 JSON,然後根據時間碼與節拍對齊驗證剪輯點,最後產出最終的 1920×1080 30fps 影片。所有程式碼都不需更動;新影片等於新規格加新原始素材。 在行銷方面,它遵循嚴格的規範:一律說「source-available」(從不說「open-source」)、不提「Figma killer」、只展示已出貨的功能,且每項聲明都要有實際畫面佐證。 針對長篇教學影片,它提供一個包含指令碼、TTS 產出與字幕時間設定的起點引擎。旁白使用 VieNeu-TTS v3 Turbo(預設「Hải Đăng」),句子之間會插入精確的 0.18 秒靜音,以利字幕時間對齊。所有越南語旁白都必須事先經過審核,確保發音正確。

相容平台~Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/NamAIEngineer/bundle-skill-video/tree/main/designos-beat-edit-video

在你喜歡的 AI 中提問

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

說明文件

designos-beat-edit-video 是做什麼的?

目的:行銷 design:os studio 應用程式。 每支影片都展示應用程式實際執行觀眾想看的某項功能(一項功能、一個明確承諾、一個行動呼籲)。應用程式是主角,而不是剪輯技巧。

並非固定範本。每支影片都必須與所有先前的影片不同: 新的點子、新的功能或展示的任務、新的畫面、新的結構、新的調色盤與背景、新的動態語言、新的音樂。創意必須在前 3 秒就脫穎而出。在開始規劃之前,請閱讀專案中的先前簡報 (orca-briefs/*designos*),選出那些都未被使用過的選項;將這些選項寫入新簡報,以便下一支影片可以避開它們。(engine/ideate.py、engine/music.py、references/creative-brief.md 會有幫助。)spec/design-in-4-4.spec.json 只是一個工作範例(它的畫面很舊:切勿重複使用,一律錄製新畫面)。

一個規格 JSON 驅動一切:影片 (render.py)、音訊 (audio.py)、檢查 (beatlib.validate、qa.py)。 新影片 = 新規格 + 新的原始素材。不需修改程式碼。

批次產生: python engine/ideate.py batch --count 30 --seed N --out batch/ 會產生 N 個不同的計畫(風格、BPM、概念、調色盤、結構、剪輯、長度、功能)以及 manifest.json。請參閱 references/chatgpt-instructions.md。

嚴格規則

所有畫面都來自真實的 design:os studio 應用程式 (Openscreen --window "design:os studio"),且每支影片都必須重新錄製。不得使用模擬畫面、其他應用程式或舊素材。

管線

  1. python engine/ideate.py plan --edits N --seed <new> --out plan.json -> 產生概念、音樂風格 + BPM、調色盤、結構以及每個剪輯點的位置。請自行改寫文案。 錄製後:ideate.py build plan.json times.json --out spec.json。音樂:5 種生成式風格(house、lofi、trap、synthwave、cinematic),在 spec.music 中設定。
  2. 錄製 應用程式的實際畫面 (Openscreen,--window "design:os studio",游標為可編輯疊層)。 規則:點擊、暫停約 0.8 秒,然後打字。顯示整個應用程式。游標要像真人操作。錄製時間要比動作本身更長。
  3. 填寫規格 (spec/design-in-4-4.spec.json 是工作範例;欄位說明請看 references/spec-fields.md)。 每個剪輯點只需要原始素材的時間碼:tc(游標開始點擊側邊欄)、hit(畫面切換)、 td(雙擊文字)、ts/te(第一個/最後一個輸入的字元),以及 T = 剪輯點落到的影片秒數(小節線)。
  4. python engine/run.py validate spec.json - 若剪輯點未對齊小節線、打字未對齊 16 分音符格線、 點擊到文字的停頓太短或場景未鋪滿時間軸,則驗證失敗。
  5. python engine/run.py all spec.json --root <dir with raw takes> --out <dir> -> 產生 final.mp4 (1920x1080, 30 fps, AAC) 並執行 qa.py。 部分執行:render F N (場景)、audio、mux、qa。
  6. 在交付前檢查 3-4 個影格與連絡表。Nam 會自己發布;切勿代發。

護欄(行銷總部)

FREE,請說「source-available」(絕不能說「open-source」),不能說「Figma killer」、「Developer view」,只能展示已出貨的功能,每項聲明都要有實際畫面佐證。影片內容是關於產品,而非製作過程。

為什麼這樣做有效

透過錨點(beatlib.Timeline.anchors)將畫面時間對應到影片時間,因此無論以什麼速度錄製,點擊都會落在小節線上。120 BPM:拍 = 0.5 秒,小節 = 2 秒,一個輸入字元 = 0.125 秒。

已驗證

從規格重新渲染的場景 F 與原始版本影格完全相同(PSNR 無限大);音訊 WAV 則與原始版本位元組完全相同。 範例中預設峰值 0.89 得到了 +0.7 dBFS 真實峰值;新影片請將 audio.peak 設為約 0.8。

需求

python3、numpy、Pillow、ffmpeg/ffprobe;macOS 字型(HelveticaNeue.ttc、SFNSMono.ttf)或在規格中修改 fonts。 legacy/design-in-4-4/ 保留了原始指令碼(tl.py、make8.py、audio9.py、cursor2.py)以供參考。

Prompt Motion:每支影片都要使用

Prompt Motion Bridge 工具(Prompt_Motion_Bridge__recommend_motion_references、search_motion_references、get_motion_reference)是動感點子的來源。對於每支影片:

  • 描述每個場景(鉤子、章節卡、轉場、標註、統計/回顧、片尾卡)並要求參考;每次使用不同的關鍵字搜尋(kinetic type、mask reveal、morph、parallax、split-screen、glitch、liquid、stagger、counter、3D tilt 等)。
  • 每支影片至少選 5 個不同的參考,並用程式碼實作出來(PIL/numpy/ffmpeg 或 Remotion)。在簡報中記下參考 ID,且不要重複使用上一支影片用過的參考集合。
  • 畫面要明亮、動畫豐富,但應用程式畫面仍須保持主角地位且可讀。

長篇教學影片(3-5 分鐘,越南語旁白,YouTube)

第一部經 Nam 於 2026-11-16 核准(final_v3.mp4,4:21:從 .fig 範本到桌面+手機畫面的 6 步驟流程)。僅將其視為範例:下一部長片需要不同的主題、畫面、結構與視覺風格。 起始程式碼:longform/(Mac 上的 longform/ 目錄也有):README.md、script2.py、gen_tts.py、lib.py、build.py、audio.py。將其複製到新工作區並進行修改:章節、版面配置、卡片與標註設計、背景、調色盤、動態(來自 Prompt Motion)、音樂風格與速度。切勿輸出相同的視覺風格兩次。

點子: 每支影片選擇自己的角度與格式,例如計時挑戰、改造前/後、單一功能深入探討、「初學者常犯的 3 個錯誤」、重新設計一個真實感十足的畫面、建立一個迷你設計系統、行動優先、快速執行、問答。每個章節都必須展示觀眾想看的內容;只包含「我犯的錯」的章節已被拒絕,因為與觀眾無關。僅限已出貨的功能;在承諾功能前,請先在應用程式中確認(右上角的 Play 預覽 ▷ 運作良好且畫面漂亮)。

畫面: 每支影片都要用 Openscreen 重新錄製(不同的範本或檔案、不同的畫面、不同的編輯)。Openscreen 只錄製應用程式視窗,不會錄製 macOS 原生對話框:請以文字標註的方式顯示檔案選取器,絕對不要使用模擬畫面。在圖層面板中選取文字圖層,按下 Return,確認文字反白後再打字;在未聚焦的欄位中打字會觸發快捷鍵。在旁白提及某項編輯前,請再次確認應用程式狀態(曾有復原動作默默還原了按鈕文字的前例)。

旁白(已獲 Nam 核准):VieNeu-TTS v3 Turbo,預設「Hải Đăng」。 在 Mac 上執行(.venv-voice/bin/python、gen_tts.py),48 kHz,約即時速度的 0.3 倍。未經 Jang 書面同意,不得複製 Jang 的聲音。

  • 逐句生成,句子之間插入 0.18 秒的完全靜音;字幕根據這些間隔進行時間設定,因此顯示文字與 TTS 文字必須有相同的句子數。
  • 保留兩種文字:顯示用(字幕,正確拼寫)與 TTS 用(重新拼寫)。已核准範例:「Design OS Studio」->「Đi-giai Âu-ét Studio」(保留「Studio」的英文發音)、「Figma」->「Phích-ma」、「.fig」->「phích」、「megabyte」->「mê-ga-bai」。絕不能使用全大寫的「DESIGN OS」(逐字母拼讀)。
  • Nam 不接受錯誤的英文發音:請用越南語說 UI 相關詞彙(bảng lớp、vùng vẽ、bảng thuộc tính、phím xuống dòng、phím thoát、màu nền);英文 UI 字串只放在標註中。
  • 新的重新拼寫方式:嘗試 5-7 種變體,用 faster-whisper(vi 與 en)檢查,寄送一小段 WAV 樣本給 Nam,只有在他核准後才能重建。

畫面規則: 1920x1080,30 fps。Openscreen 原始畫面只有 1600 px 寬,因此相機縮放請保持在約 1.6x 或更低(放大太多在 YouTube 上看起來會模糊)。所有文字都要能放入其卡片內(自動縮小),並檢查回顧/統計影格是否有內容溢出。片尾卡顯示完整的 URL https://jangtrinh.github.io/design-os-studio/ 大字顯示 8-10 秒,再加上「Source-available · Not affiliated with Figma」。

交付: 輸出 1080p 再加上一個 4K 升頻版本(lanczos、crf 16);將 4K 版本寄給 Nam 上傳 YouTube,並且只有在 ffprobe 讀取到完整片長之後才寄送。告知 Nam 將上傳設為私人,直到 YouTube 顯示 2160p 為止。提供一個清楚的標題建議,以及包含章節時間戳、連結、範本出處與「Not affiliated with Figma」的描述。切勿代發;Jang 擁有最終核准權。

此套件中的參考檔案

  • references/openscreen.md + tools/record.sh:Openscreen 確切指令、原始素材存放位置、cursor.json 格式、螢幕對應。
  • references/voice.md + longform/gen_tts.py + longform/check_voice.py:已核准的旁白、安裝、重新拼寫表格、Whisper 檢查。
  • references/prompt-motion.md:如何使用 Prompt Motion 工具、已使用過的參考、在沒有 MCP 時的備援方案。
  • references/chatgpt-instructions.md:提供給 ChatGPT/ORCA/Codex 的交接文件,現在包含長篇模式。
  • longform/:長篇影片的起始引擎(ROOT=<workspace> python build.py info|agenda|<chapter>、python audio.py)。

相關技能