Communitygithub.com

Cjbuilds/launch-video

從產品URL、簡報或提供素材,利用HeyGen HyperFrames建立產品發布影片。研究產品與品牌、編寫簡短腳本、展示設計好的HTML故事板畫面以取得明確批准,然後進行動畫、渲染並檢查MP4。適合用於發布影片、SaaS宣傳、功能介紹與產品示範;不適用於一般影片編輯。

launch-video 是什麼?

此技能專為AI代理(如Claude Code、Cursor、Codex等)設計,能將真實產品轉化為清晰的視覺故事:從痛點、改變、運作方式到行動呼籲,一氣呵成。技能以HeyGen HyperFrames為動畫引擎,支援多種平台。工作流程包含:依據使用者提供的簡報、URL或素材進行深入研究並建立BRIEF.md;使用上游HTML合成合約與診斷工具準備專案;為每個場景撰寫精簡腳本並建立完整的靜態HTML設計框架,必須取得使用者明確批准後才能進入動畫階段;動畫階段忠於已批准的故事板,使用時間軸安全檢查與場景分鏡;最後透過輔助腳本渲染MP4,並進行嚴格的視覺品質檢查,包含幀提取與完整播放檢視。它特別強調真實來源、資產授權與視覺品質,避免虛構內容或未經授權的素材。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Cjbuilds/launch-video/tree/main/skills/launch-video

在你喜歡的 AI 中提問

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

說明文件

發布影片

將真實產品轉化為清晰的視覺故事:痛點、改變、運作方式與下一步行動。使用 HyperFrames 作為引擎。保留使用者選擇的模型作為管理者。請勿取代引擎或建立影片編輯器、範本庫或動畫框架。

1. 紮根簡報

首先閱讀使用者提供的簡報、產品、素材與現有專案。接續現有工作。僅詢問會改變影片的缺失事實;不要重複已回答的問題。僅有產品名稱不足以作為功能宣稱的證據。若輸入資訊有限,請在撰寫故事板之前先釐清目標受眾、實用價值與結尾行動。

對於提供的 URL,請檢查實際產品與官方品牌來源。在適當情況下使用 HyperFrames 擷取功能;遵循 upstream.md 中釘選的擷取失敗規則。若擷取失敗,切勿自行發明替代網站。對於「如實展示」影片,請以實際畫面為基礎。除非獲得編輯授權,否則保留提供的確切文案。將宣稱、來源、資產權利與任何假設記錄在影片專案中的簡短 BRIEF.md 檔案中。未經授權,請勿將私人素材納入公開展示。

使用產品的顏色、字型、密度與實際 UI。選擇一個特定的視覺方向,包含有意義的動態、可讀的字型與刻意安排的節奏。選擇性地閱讀上游創意與動態參考。 reference-study.md 說明的是技巧,而非強制性的內部風格。虛構範例必須明確標示;不要將其轉化為暗示的實際客戶成果。

2. 準備專案

閱讀 upstream.md,並在使用前驗證釘選的來源與 CLI。使用上游的 HTML 合成合約、診斷工具與渲染功能。僅讀取所需的領域參考;不要將整個原始碼樹複製到交付物中,或默默地重新整理到最新版本。

建立一個專屬的影片專案。使用 project-format.md 定義 project.json。在故事板中協商一致的輸出尺寸、幀率、長度與音訊選擇。對於 X,請在選擇匯出前先驗證當前的官方上傳要求。預設為一部簡短、適合靜音觀看的影片;未經授權,請勿購買媒體或呼叫付費語音供應商。缺少的素材需要一個符合簡報的本地、已授權的替代品,或一個具體的問題,絕不能使用損毀的佔位符。

3. 設計、展示並取得批准

撰寫精簡的腳本:每個場景一個清晰的想法、真實的產品證據、有用的回報。為每個場景建立一個完整的靜態、設計好的 HTML 畫面,包含實際提出的文案、佈局、調色板與素材。僅有文字描述與線框圖塊並非審查成品。在整部影片中保持單一的連續產品範例。以可讀的比例顯示重要的 UI,並留出時間來理解每個動作。

每個畫面必須是自包含的靜態 HTML,使用內嵌 CSS。使用本地、已聲明的圖片/字型素材;請參閱格式參考。在完整輸出尺寸與饋送比例下檢查畫面。在 project.json 中包含確切標題、可選旁白、持續時間與預期動態,然後執行:

python3 <SKILL_DIR>/scripts/launch_video.py storyboard <PROJECT_DIR>

為使用者開啟產生的 storyboard.html。自己先檢查每個畫面。要求對顯示的版本或特定場景的修改給予批准。在獲得使用者明確批准之前,請勿進行完整動畫或渲染。 沉默、通用的早期「是」、對建置想法的接受以及自動模式均不構成對未見過的故事板的批准。在此關卡之前,允許進行中立的技術渲染器探測。

只有在使用者批准顯示的版本後,記錄他們的實際決定:

python3 <SKILL_DIR>/scripts/launch_video.py record-approval <PROJECT_DIR> \
  --version <DISPLAYED_SHA256> --approver <USER_NAME> --decision '<ACTUAL_APPROVAL_TEXT>'
python3 <SKILL_DIR>/scripts/launch_video.py check-approval <PROJECT_DIR>

收據綁定了清單、畫面位元組、素材與產生的故事板。它記錄了人類的決定;它不會驗證發言者的身份,也不會解釋任意文字是否代表批准。絕不偽造收據。預設情況下,將批准記錄保密。

4. 為已批准的故事製作動畫

使用釘選的 HyperFrames 動畫規則與藍圖。重複使用已批准的設計畫面作為合成基礎。每個場景應揭示一個實際的動作與結果;動態必須支援故事。使用安全搜尋的時間軸。在實作某項技術之前,請先閱讀相關的上游規則。在連續轉場中匹配位置、比例、方向與不透明度。避免遮蔽產品或快速閃爍的動態。

按照格式參考中的規定,建立 index.html 以及每個已批准場景的一個子合成。保持 ID/順序、確切文字、時間、尺寸與資產身份忠於已批准的故事板。輔助腳本會檢查結構、文字與時間;請自行檢查視覺效果與素材。它無法僅從原始碼證明語意忠實度。請勿編輯已批准的畫面來隱藏偏差。

任何對請求的故事、文案、素材、佈局、持續時間或音訊的變更都需要修改後的故事板以及重新批准。保留先前的版本。可以繼續進行實作已批准意圖的動態修復,然後重新執行受影響的檢查。如果與代理合作,請分配每個代理一個確切的場景以及不重疊的檔案所有權;管理者負責組合與品質保證。

5. 檢查、渲染與交付

從專案目錄使用釘選的 CLI 執行 lint、check、keyframes . --json 以及 snapshot --at <scene-midpoints-and-transition-boundaries>。檢查每個場景、開始/結束以及每個剪輯的兩側。開啟 preview --background 並以正常速度觀看完整的動態。檢查可讀性、時間、重疊、裁剪、素材載入、轉場連續性以及靜音理解。對於音訊,還要檢查權利、同步、裁剪與結尾。通過靜態檢查並不能證明視覺品質。

在批准與渲染前的視覺品質保證之後,透過輔助腳本渲染:

python3 <SKILL_DIR>/scripts/launch_video.py render <PROJECT_DIR> --output output/video.mp4

這會呼叫 HyperFrames 0.8.37 與 ffprobe,檢查匯出是否符合批准的尺寸/幀率/持續時間/音訊,並寫入 .qa.json 收據。其視覺品質保證狀態仍為待定:在交付前,檢查實際的 MP4、提取代表性畫面並觀看完整播放。分別報告證據與判斷。不要因為編碼成功就將結果標記為完成。

若失敗,請閱讀錯誤訊息,修正其具體原因,並重複受影響的檢查。保留現有的影片;檢查部分失敗的渲染結果後,選擇一個新的輸出路徑。切勿更換引擎、使用舊輸出作為新結果,或隱藏缺失的功能。若受阻,請說明剩餘部分並提供已完成的可審查工作。

交付 MP4、設計好的故事板、用於修改的場景 ID、尺寸/持續時間/音訊、可重現的指令以及誠實的品質保證備註。僅在要求時發布。請勿承諾「病毒式傳播」、一次性品質或未經測量的時間/代幣節省。

相關技能