Communitygithub.com

Win-Hao/knowledge-video

將一個主題轉化為易於理解、美觀且令人想看到最後的知識解說影片(螢幕文字搭配音樂,類似抖音 #Vibe知識大賞 熱門風格),並使用 HyperFrames 渲染。提供從研究、文案、圖片、視覺設計到渲染的完整流程,以及音樂編輯、節奏對拍、音效與自我檢查等小工具。

knowledge-video 是什麼?

這個技能「knowledge-video」旨在協助使用者將任何主題(如知識、科學、歷史或運作原理)製作成一支高品質的短影音。它的核心是一條經過驗證的流程:研究(產出有來源的文章)→ 文案(改寫成吸引人的腳本)→ 圖片(使用真實圖片或 AI 提示)→ 視覺與分鏡(設計風格並對齊音樂節奏)→ 渲染(先預覽開頭,再產出完整影片)。該技能強調逐步驗證,避免在渲染後才發現方向錯誤。它支援多個平台(如 Claude Code、Cursor、Codex),並內建腳本工具來分析音樂節拍、剪輯音樂、對齊時間軸、下載音效以及進行最終的 QA 檢查。技能文檔中提供了詳細的 Prompt 設計指南(包含角色、任務、風格、檢查點),並強制要求事實需有可靠來源、素材需有授權、AI 生成的人臉不得用於真實人物、以及隨機種子需固定以確保渲染一致。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Win-Hao/knowledge-video/tree/HEAD/skills/knowledge-video

在你喜歡的 AI 中提問

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

說明文件

知識影片

將一個主題轉化為人們想看到最後的知識影片。以下是一條有效的路徑,而非固定程序:你可以合併、跳過或重新排序步驟,並為此主題自行設計文案、視覺風格與動態。

以使用者的語言與其溝通;下方的檔案名稱為預設值。

大致流程

  1. 研究 → article.md:尋找來源並撰寫一篇有根據的文章。首先觀察主題的形態(時間軸、因果鏈、概念、比較、迷思、單一故事),然後決定要涵蓋哪些重點。由使用者決定數量:根據音樂長度提供兩到三個選項,並推薦其中一個
  2. 文案 → script.md:將文章改寫成一個讓人們會滑動觀看的影片
  3. 圖片 → images.md 或 image-prompts.md:真實圖片,或用於 AI 插圖的提示詞(假設你無法呼叫圖片 API;使用者執行自己的工具)
  4. 視覺與分鏡 → looks/、storyboard.md:向使用者展示幾個方向,然後根據音樂進行分鏡
  5. 渲染 → opening-preview.mp4 → final.mp4:先渲染一小段開頭,確認無誤後再渲染完整影片

預設情況下,在進入下一步之前向使用者展示每一步的結果:錯誤的方向在渲染後成本最高。如果使用者說「直接做到底」,則繼續進行,並在 storyboard.md 中記錄你的選擇及原因。

每一步:填入提示,然後遵循它

根據 Anthropic 的提示工程指南,將背景、要求和檢查點分別放在不同的 XML 標籤中,並為每一行提供原因:分開的部分不會混在一起,而且知道原因能讓模型推廣到未寫出的內容。你需根據此主題和使用者說過的話自行填入標籤。

  • 簡報 prompts/brief.md:在開始時填寫一次,並在每個步驟後更新。只有一個 <context>:主題、觀眾、核心訊息、長度、方向、音樂、使用者喜歡與不喜歡的內容、之前步驟確定的內容、檔案位置

  • 此步驟的提示 prompts/<step>.md,四個標籤:

    • <role>:此步驟的角色以及該角色最關心的事。步驟之間角色不同;為此步驟選擇一個,例如研究是知識編輯(最關心來源),文案是編劇(最關心觀眾是否會滑走),圖片是圖片編輯或插畫師,視覺是藝術總監,分鏡是分鏡師,合成是動態設計師(最關心每個動作解釋了什麼)
    • <task>:此步驟產出什麼以及產出位置
    • <style>:推薦的方法,每個方法附帶理由;推薦而非規則:從 references/ 中的範例選擇,或為此主題設計新的;如果使用者已表達需求,則遵循使用者;同時在此記錄他們不想要的內容
    • <check>:要驗證的項目,逐項列出,直到步驟被視為完成;包含「必須遵守」的項目

    每個步驟都必須撰寫 <role>、<task> 和 <check>;在不需要時略過 <style>(研究和渲染通常不需要)。從主題推斷使用者未提及的內容,並在報告中詢問你不確定的部分。在輸出步驟結果時一併顯示已填寫的提示;如果使用者編輯了它,則根據編輯後的版本重新執行該步驟

誰來執行:需要與使用者來回溝通的步驟(例如多少個重點、哪種外觀)由你自己執行。大型的獨立步驟(研究、尋找圖片或撰寫圖片提示、撰寫合成與渲染)則交給子代理:只給它簡報、此步驟的提示和檔案路徑,這樣它的上下文就是乾淨的,只包含此步驟所需的內容。它不知道你和使用者討論了什麼,因此兩者都必須完整。完成後,閱讀其輸出並在向使用者展示之前執行自我檢查。如果沒有子代理,則由你自己遵循提示。

必須遵守

  • 事實必須有來源:每個年份、名稱、數字和引用都要追溯到可靠的來源(論文、機構、檔案館、當事人自己的話),並在 article.md 中連結;無法找到來源的內容要刪除,估計值要標明,二手聲明要說明是誰的說法。螢幕上出現的每一行文字,包括開場問題和結尾,都必須與 article.md 一致
  • 素材必須可用:圖片、音樂、音效和字體均需取得使用授權(檢查檔案頁面);致謝內容寫入 credits.md
  • 真實人物的臉部不可使用 AI 繪製;如果影片使用 AI 插圖,請開啟平台的「AI 生成內容」標籤
  • 畫面僅依賴時間:固定任何隨機種子,使每一幀在每次渲染時都相同(HyperFrames 需要此設定)
  • 交付前,請自己完整觀看一遍:文字在時間內可見且可讀,年份和數字與文章一致,聲音和畫面同步

可用的工具

HyperFrames 用於畫面渲染(npx hyperframes init / docs / check / snapshot / render);如果已安裝其技能,請遵循其合成方式。scripts/ 中的小工具,可自行決定是否使用:

腳本功能
beats.py音樂的節奏、拍子、小節線以及每小節的音量變化
music_loops.py、cut_music.py尋找可重複或無縫剪輯的小節,根據小節列表建立新的音樂
timing.py將腳本的每個畫面對齊節奏網格,將關鍵畫面固定到指定小節
sfx.py下載 Kenney 的 CC0 環境音效,將音效提示混合到一個音軌中
qa.py每個畫面的聯絡表單以及關鍵節拍附近的幀

之前影片留下的資源

是參考,不是規則。首先為此主題進行設計;在不確定或遇到相同問題時再參考此處:

  • references/example-ai-history.md:第一個測試運行,包含每一步的輸出和時間安排
  • references/prompt-examples.md:來自一個測試影片的兩個已填寫提示,可了解其詳細程度
  • references/notes.md:關於文案和節奏的觀察
  • references/images.md:檢查授權、撰寫提示、分層生成
  • references/visuals.md:密集拼貼、時間軸時刻、照片卡片、將 UI 適配到生成的畫面上、用程式碼繪製的內容
  • references/sound.md:音樂編輯、音效、音量
  • references/pitfalls.md:當渲染失敗或畫面不對時,優先檢查此處

相關技能