Communitygithub.com

產品解說影片產生器

將任何軟體專案(GitHub 儲存庫、本地資料夾、爬蟲、自動化工具、機器人、網站、CLI、API 或一整個工具組合)轉換成乾淨、客製化的動畫解說影片,包含 AI 語音旁白、字幕和音樂。

產品解說影片產生器 是什麼?

此技能能自動分析一個軟體專案(程式碼、README、關鍵檔案)以提取真實的事實與功能,然後設計一個完全客製化的動畫解說影片。它不依賴固定模板,而是為每個專案建立獨特的視覺隱喻和場景。技能支援多種來源(本地路徑、壓縮檔、GitHub URL 或即時網站),並能生成 MP4(橫向或直向)、SRT 字幕、以及一個可嵌入的 HTML 播放器。處理流程包括:事實收集、故事板設計(可混合內建和自訂場景)、佈局驗證(聯絡表單)、以及帶有自動語音旁白的渲染(支援多種引擎,包含 Edge TTS 和 ElevenLabs)。此技能特別適用於開發者希望為其工具、網站或 API 建立展示影片、產品上市影片或社交媒體短片,即使他們沒有明確要求「影片」也能被觸發。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/cheransanketh070-afk/claude-explainer-skill/tree/HEAD/product-explainer-video

在你喜歡的 AI 中提問

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

說明文件

產品解說影片產生器 是做什麼的?

使用者指向他們建置的東西;你回傳一個精美的動畫解說影片附帶語音旁白,讓陌生人在一分鐘內就能理解。影片必須為這個專案設計:它自己的視覺隱喻、它自己的客製化動畫。切勿產出只換了名稱的通用模板影片。

分析 (事實) → 設計簡報 → storyboard.json (內建 + 自訂場景) → 驗證 → 聯絡表單品質檢查 → 修正 → 渲染 (+語音, +音樂) → 交付

腳本位於此檔案旁的 scripts/ 資料夾中。$SK = 此技能的資料夾(此 SKILL.md 所在位置)。

0. 設定檢查 (10 秒)

python3 -c "import playwright, PIL, numpy" && which ffmpeg && python3 $SK/scripts/voiceover.py --list

缺少套件:pip install playwright pillow numpy edge-tts --break-system-packages && playwright install chromium。沒有 ffmpeg → 告知使用者(MP4 需要;--html-only 仍可提供 HTML 播放器)。語音 --list 會顯示目前哪些語音引擎可用。

1. 了解要解釋的內容

先推斷,極少提問:主題(一個產品或一個組合)、受眾/目的(GitHub 上的開發者、客戶、社群)、來源(本地路徑、上傳的壓縮檔、GitHub URL、即時網站或只是描述)。預設值:16:9,45–75 秒,開發者加上好奇的非技術觀眾,開啟語音旁白。只有在真正模稜兩可時(例如 15 個儲存庫,沒有關於目標的提示)才問一個簡短問題。否則,在一行內陳述假設並繼續進行。不要訪談使用者。

2. 收集事實(絕不跳過:這能確保影片的真實性)

python3 $SK/scripts/analyze_project.py /path/or/git-url [more...] -o facts.json
python3 $SK/scripts/capture_site.py https://their-site.com -o site-capture     # 即時網站:擷取螢幕截圖 + 頁面事實

分析器會印出描述、語言、功能、真實的 README 命令、CLI 旗標、路由、聯絡的網域、輸出、環境變數、CI/排程以及可安全顯示的 REAL STATS。閱讀它,然後在事實不足時自行閱讀 README 和 1–3 個關鍵原始檔案(核心迴圈是什麼?使用者實際執行什麼?輸出看起來像什麼?)。複製失敗或無網路 → 要求提供壓縮檔或 README。網站擷取被封鎖 → 要求提供螢幕截圖或使用自訂場景繪製 UI。

3. 設計簡報,然後是故事板

閱讀 references/narrative-playbook.md(故事弧線、真實性規則)、references/storyboard-schema.md(所有場景類型/欄位)和 references/custom-scenes.md(如何撰寫自訂場景)。assets/examples/ 中的參考故事板展示了好的範例;它們是靈感,不是模板:不要重複使用其內容、結構或措辭。

首先決定(簡短寫下):

  1. 一句話的承諾。
  2. 產品實際做什麼(事物在位置間移動)以及展示它的單一視覺隱喻。
  3. 「啊哈」時刻的場景。
  4. 主題、強調色(如果知道使用者的品牌顏色)、bg 風格、節奏:與產品的個性相匹配。
  5. 哪 2–4 個場景將是自訂的(為此產品繪製),哪些通用節拍使用內建元件(標題、問題、步驟、行動呼籲...)。

然後撰寫 storyboard.json:

  • 故事弧線:鉤子 → 問題 → 運作方式 → 證明其簡單 → 具體結果 → 為何它很棒 → 行動呼籲;7–10 個場景,45–75 秒。
  • 品質標準:至少有一個場景是自訂的,除非產品真的只是一個簡單的 CLI;啊哈場景總是自訂的或仔細挑選的內建場景。機器人展示對話;爬蟲展示頁面變成行;API 展示請求和回應;儀表板展示即時數字。
  • 每個場景都有 narration:口語風格,15–35 字。它將成為語音旁白、字幕和 SRT。
  • 只有事實:命令、旗標、功能、路由和數字來自事實或使用者。終端機輸出和表格行可以是說明性的但通用的;絕不編造基準測試、客戶數量或功能。統計場景只使用 REAL STATS/README/使用者數字。
  • 設定 meta.url 為儲存庫/網站,並以一個清晰的行動呼籲結尾。

4. 驗證,然後在渲染前查看

python3 $SK/scripts/storyboard.py explainer/storyboard.json
python3 $SK/scripts/render_video.py explainer/storyboard.json --contact-sheet

聯絡表單(約 20 秒)會執行佈局審計(舞台外、裁剪、截斷、字幕碰撞的文字以及自訂場景的 JS 錯誤)並寫入 explainer-output/contact-sheet.png。查看它並檢查:沒有擁擠或裁切的內容、文字可讀、場景彼此明顯不同、自訂場景看起來有設計感。聯絡表單只顯示每個場景的最後一個影格,因此對於每個自訂場景,也要檢查早期和中期的影格:--still 3.2,6.5。修正並重複直到乾淨為止。

5. 使用語音旁白渲染

cd explainer
setsid nohup python3 $SK/scripts/render_video.py storyboard.json --quality final --gif \
  > render.log 2>&1 < /dev/null &
sleep 100; tail -c 300 render.log

持續輪詢(sleep 100; tail -c 300 render.log)直到 DONE。在沙盒環境(claude.ai)中,背景工作只會在工具呼叫執行時前進,因此休眠輪詢會驅動渲染;不要在它執行時結束你的回合。預設:draft(960×540,15 fps),standard(1280×720,30 fps,預設),final(1920×1080,30 fps)。更多 CPU 核心 → 更快(--workers N)。直向:meta.aspect: "9:16" 或 --vertical。慢速機器:--fps 24。

語音旁白是自動的(--voice auto,預設)。渲染器會為每個場景生成一個音訊檔案,拉伸場景使旁白永不中斷,在語音下方降低音樂音量,並快取音訊以便重新渲染無需成本。引擎優先順序:ElevenLabs(ELEVENLABS_API_KEY)→ OpenAI TTS(OPENAI_API_KEY)→ Edge 神經網路語音(pip install edge-tts,免費,無需金鑰,需要網路)→ Piper(離線神經網路)→ macOS say → espeak-ng。選項:--voice-name en-US-AndrewNeural(任何引擎的語音名稱),--voice-rate +8%(Edge),--voice none 僅音樂,--voice-dir folder/ 使用使用者自己的 scene-01.mp3… 檔案,meta.voice 將選擇儲存在故事板中。

如果渲染列印 WARNING voiceover: no speech engine available,影片仍然會渲染(僅音樂),而 voiceover.txt 會包含腳本。直接告知使用者,並附上一行修復方式:啟用網路並執行 pip install edge-tts(免費),或設定 API 金鑰,或安裝 espeak-ng;然後重新執行相同命令(僅重新處理語音和編碼;播放器和故事板不變)。在 claude.ai 中,沙盒通常沒有網路,因此預期會發生此情況:如此說明,交付無聲音樂影片和腳本,並解釋他們可以透過在 Claude Code 中本地執行管道或使用 API 金鑰來添加語音。除非日誌顯示 voiceover: using '<engine>',否則切勿聲稱影片有語音旁白。

音樂:生成免版稅背景音樂(--mood calm|upbeat|tech 或 meta.music_mood);--music none 或 --music file.mp3。

6. 交付

輸出在 explainer-output/:<名稱>.mp4、<名稱>-poster.png、player.html(自包含的互動式播放器;使用 <iframe src="player.html?embed"> 嵌入;它有動態和字幕但沒有音訊)、captions.srt、voiceover.txt、storyboard.resolved.json、voice/、可選的 .gif。

驗證:ffprobe -v error -show_entries stream=codec_type -of csv=p=0 <名稱>.mp4 顯示一個音訊串流;持續時間相符;查看海報。將交付檔案複製到 /mnt/user-data/outputs/,並使用 present_files 先顯示 MP4,然後是海報、字幕、player.html 和 storyboard.json(以便他們可以編輯和重新渲染)。保持訊息簡短:每個場景一行、所做的假設、使用的語音引擎以及如何調整。僅在有用時提供變體:9:16 的社交媒體剪輯(約 30 秒)、不同的語音或品牌顏色、為另一個儲存庫製作的影片。

編輯和重新渲染

編輯 storyboard.json(文字、順序、顏色、自訂場景程式碼),重新執行聯絡表單,然後渲染。旁白變更只會重新合成已變更的場景。設定場景的 duration 以延長它;它絕不會被縮短到低於動畫和旁白所需的時間。

組合 / 「我所有的工具」

在一次呼叫中分析每個儲存庫,挑選 3–4 個展示範圍的旗艦產品,為每個產品提供一個帶有自己視覺隱喻的自訂或最佳搭配場景,以一個其餘工具的 features 網格和一個指向個人資料的行動呼籲結尾。之後為每個產品提供深入探討的影片。

故障排除

  • Playwright is not installed → 執行步驟 0 的命令。
  • 空白/黑色影格或 scene error 訊息 → 自訂場景的 JS 拋出錯誤;審計會列印例外。修正程式碼。
  • 文字被裁剪/截斷 → 縮短、移除項目或製作自訂版面。
  • 語音聽起來像機器人 → 那是 espeak;改用 Edge/OpenAI/ElevenLabs/Piper。
  • 語音與場景時間不匹配 → 時間是自動的(場景會拉伸以配合音訊);如果字幕感覺太早,請縮短旁白。
  • 日誌沒有進展 / 渲染被終止 → 它以附加模式執行或無人輪詢它;重新以分離模式啟動並輪詢。
  • 輸出太長 → 移除最弱的場景;驗證器會在約 90 秒以上時發出警告。

誠實的限制

動態圖形(圖表、終端機、程式碼、UI 模型、客製化動畫),非螢幕錄製或寫實鏡頭。對於真實的 UI,傳遞螢幕截圖或繪製介面。語音品質取決於可用的引擎。

相關技能