Vibe 知識大賞製作

將一個知識主題製作成可觀看的短影片及發布素材。支援完整製作，也支援只改字幕、節奏、配樂、封面或文案；局部修改時保留已確認內容，只交付用戶要求的部分。

已確認的默認偏好

默認值見 assets/defaults.json，用戶本次要求和已有項目設置優先：

中文知識內容；橫屏16:9，1920×1080、30fps；一般30–45秒，按內容和音樂整拍確定，不強行湊固定秒數。
不添加旁白或配音。用戶音樂原有的人生保留；「無額外配音」不等於純音樂。
大字、短句、較快切換、鮮明視覺重點。暗色＋薄荷綠＋暖橙是可用的起點，不把所有題材固定成電路風格。
使用用戶給的音樂，保持原速，分析拍點後排切鏡。可用4/6/8拍長短交替，但按曲子的實際節拍與閱讀時間調整。
完整交付包含MP4、4:3橫封面、3:4豎封面、標題、簡介、話題及可繼續修改的源碼。
標題格式默認 Vibe知識大賞｜具體掛鉤或問題，再按需要加入知識名稱。
輸出放在當前工作區一個獨立項目中，最終給可點擊的絕對文件路徑。

接手任務

先檢查當前項目已有的project.json、分鏡、預覽、成片及用戶已確認意見。不要重新製作已經完成的部分。主題、音樂、規格或授權在對話裡已明確時，不重複詢問。只在缺失輸入確實影響工作時提問，並先推進不依賴回答的部分。

最小輸入是主題；音樂可在後續補充。沒有音樂時先做文案與分鏡，不捏造音樂路徑或宣稱完成卡點。用戶說「按你的理解」時，用默認偏好自主完成常規選擇。預覽確認與本地導出的既有授權持續有效；已授權的渲染、修復和重試無需反覆確認。若用戶只要預覽則停在預覽階段；若當前尚未授權最終導出，提供可審閱版本後只確認一次。此流程不包含自動發布到平台。

製作流程

建立項目。 用 scripts/create_project.py 創建獨立項目、保存主題/音樂/規格；已有項目直接繼續。腳本只建工程目錄和輸入記錄，不替代創作、測拍或渲染。
核對知識。 優先一手資料，明確核心結論、適用前提、一個可驗證算例和容易誤解的邊界，保存到 sources.md。隱喻要標明邊界，不能把物理定理改寫成心理學定律。數學、電路、單位和正負號需要前後一致。
寫短文案和分鏡。 用具體問題開場，每鏡承載一個重點，結尾回扣問題。標題、說明、圖形分別承擔不同信息，避免一屏多段解釋。先確定閱讀負擔，再安排快慢節奏，不以鏡頭數量代替衝擊力。
音樂與統一時間表。 需要卡點時讀取 references/timing-and-render.md。用 scripts/beat_plan.py analyze 測拍，檢查BPM、半拍/倍速歧義和強起音；以用戶選定片段或試聽結果為準。用 plan 將鏡頭拍數、關鍵詞、公式與糾錯等事件轉換成統一的幀號與時間表。音樂截取點、場景、字幕和動效全部使用該表，不同時維護多套手填秒數。
製作工程與預覽。 默認優先本地可用的 HyperFrames 工程。需要時讀取可用的 hyperframes-vibe-169 及其組合契約，遵守子組合和 paused GSAP 時間線要求。使用 assets/hyperframes-clock.js 或等效精度修正，避免GSAP六位小數使切鏡晚一幀。換引擎時沿用用戶已有工程，不為調用技能而重做。
檢查並完成渲染。 運行引擎校驗，檢查每鏡、大字邊界、隨機跳播、關鍵拍點前後幀，再按已有授權本地導出。用 scripts/audit_render.py 檢查實際成片的規格、幀數、完整解碼和音軌偏移；另外逐幀檢查所有切鏡及關鍵動效，腳本解碼通過不能代替畫面檢查。發現問題修復後只重跑受影響檢查與最終成片驗證。詳情見時序參考。
封面與發布素材。 讀取 references/visual-and-delivery.md。使用 imagegen 或已有明確的封面模板生成4:3、3:4兩種獨立構圖，核對漢字、公式、箭頭、邊距與實際像素比例。生成與成片一致的標題、簡介和少量相關話題。
交付。 確認實際文件存在後給出MP4、雙封面、發布文案和項目目錄。說明時長與規格、重要限制即可。沒有成功導出時明確說「預覽/源碼已完成」，不能稱成片完成。保留project.json、sources.md、storyboard.json、beat-map.json、驗證結果及源碼，便於後續繼續修改。

組合其他技能

hyperframes-vibe-169：選用該引擎時負責組合結構、lint、preview、render。其風格示例不替代本次主題。
lemo-opuscar：用戶要求該技能或題材需要其導演/風格方法時使用，讀取相應風格即可。已有成片局部修訂不自動重走新片風格問卷。
painted-animation / Joker-chichi/claude-mv-skill：僅在手繪動畫、歌詞MV或需要其測拍工具時讀取相應部分。知識片配BGM不要求用戶另給LRC。
imagegen：負責生成或修改位圖封面。保存最終圖片到項目，記錄提示詞；不把技能說明當作可直接調用的圖片API。
openfilm / jianying-editor：用戶指定或現有工程確實使用時再走對應流程。

不要求每期同時運行所有技能。工具不可用時，先檢查既有本地運行環境和可行替代，不靜默安裝大型依賴、不替換用戶指定產品。保留明確失敗信息，不用無限重試掩蓋問題。

輔助腳本

腳本以Python 3運行，音頻分析與同步檢查另需NumPy；FFmpeg/FFprobe可從PATH或顯式參數傳入。無需API金鑰，不附帶音樂、渲染器或第三方二進制。用本機已發現的Python/Node，不把舊項目的絕對路徑當通用依賴。

python scripts/create_project.py --workspace <工作區> --slug <主題短名> --topic <主題> --music <MP3可選>
python scripts/beat_plan.py analyze --music <音樂> --out <拍點JSON> --offset 0 --seconds 50 --ffmpeg <ffmpeg路徑>
python scripts/beat_plan.py plan --grid <拍點JSON> --story <分鏡JSON> --out <beat-map.json>
python scripts/audit_render.py --video <MP4> --plan <beat-map.json> --score <最終配樂文件可選> --out <audit.json>

分鏡輸入格式、人工修正拍點和渲染精度見時序參考。目錄模板、封面和文案驗收見視覺與交付參考。腳本輸出數值是檢查證據，不是美術或科學正確性的自動保證。

vibe-video-producer