Communitygithub.com

reels-dopamina

建立高保留率的直式 Reels/Shorts/TikTok 影片 (1080x1920),用於銷售應用程式、SaaS 或產品 — 從說服性腳本到渲染好的 MP4 成品。

reels-dopamina 是什麼?

此技能旨在建立高保留率的直式短影片,專為銷售 App、SaaS 或任何數位產品而設計。其獨特的兩階段流程(腳本與製作)可避免昂貴的重新渲染,因為它會先提交說服性腳本(包含視覺與聽覺鉤子、痛點、解決方案,並搭配實際應用程式畫面)供人工審核,審核通過後才開始生成配音、背景音樂和動畫。 技能內部整合了 ElevenLabs 文字轉語音、GSAP 動畫庫和 HyperFrames 渲染工具,能產出流暢的多巴胺觸發效果,如進度條、縮放衝擊、五彩紙屑和計數器。它會自動檢查腳本中的每個承諾是否與實際程式碼或產品畫面相符,以避免虛假廣告,並提供完整的資產驗證管道(轉錄、時間對齊、渲染檢查)。 該技能支援 Claude Code、Cursor 和 Codex 等 AI 代理平台,並可透過 `brands/` 目錄中的品牌設定檔進行品牌化。它特別適合用來建立 App 解說影片、痛點廣告、以及任何需要在開頭 3 秒內抓住觀眾注意力的短影片內容。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gabrielrmgs/reels-dopamina/tree/main

在你喜歡的 AI 中提問

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

說明文件

多巴胺 Reels — 為應用程式打造的短影片

此技能產生用於銷售產品的直式短影片,針對目標族群的一個痛點,從頭到尾保持高保留率。流程分為兩個階段,中間需經過人工審核,因為生成語音、音樂和圖片需要消耗額度與時間——若等到渲染後才發現腳本錯誤,是流程中最昂貴的浪費。

階段 1 (低成本)  簡報 → 確認產品真實性 → 腳本 → 審核
階段 2 (高成本)  素材 → 時間對應表 → 合成 → 視覺審查 → 渲染 → 驗證

前置作業:品牌設定檔

在 brands/<品牌名稱>.md 中尋找品牌設定檔(包含顏色、字型、Logo SVG、品牌名稱發音、CTA、優惠內容、Instagram 帳號、應用程式畫面存放位置)。如果不存在,請根據 brands/_modelo.md 建立一個新的設定檔,內容以客戶提供的資訊或從產品程式碼/網站(例如 CSS 顏色 token、品牌元件中的 Logo、定價頁面)中擷取的資訊為準。brands/vehiro.md 是一個完整的範例。

階段 1 — 腳本

1. 簡短的簡報

僅詢問缺失的資訊:產品/品牌、目標族群(購買決策者)、痛點(或 "為何選擇你")、語音(女聲/男聲,或無旁白)、目標長度(30–50 秒)、格式(Reels 9:16 為預設)。如果客戶說 "你決定",則自行決定並用一句話解釋你的選擇。

2. 選擇痛點

每個影片只聚焦一個痛點。優先選擇 (a) 目標族群在經濟或自尊上感受到的痛點,(b) 能夠視覺化呈現的痛點,(c) 產品確實能用現有畫面解決的痛點。避免重複同系列先前影片已使用過的痛點——在選擇前,先列出先前已製作過的痛點。

3. 確認產品真實性

針對腳本中的每個承諾,在程式碼、畫面或網站中確認該功能確實存在,且行為與你的描述一致。這可以避免不實廣告與後續的修改。此檢查曾發現的真實案例:儀表板無法依狀態區分車輛(只有列表篩選器能做到);"即時"改為"隨時更新",因為狀態只在有人更新時才改變;免費試用期為 7 天(程式碼中的常數);應用程式產生的 WhatsApp 訊息有特定的文字內容,該內容直接成為影片的台詞。如果某項功能不存在,請修改承諾,而不是憑空捏造。

4. 撰寫腳本

請閱讀 references/copywriting.md(文案結構與規則)和 references/hooks-catalog.md(經過驗證的鉤子)。使用 references/dopamine-fx.md 為每個場景選擇效果。

請務必以下列格式在聊天中呈現:

## Reels N — "<痛點名稱>"
**痛點:** <一句話說明>。**產品實際具備的功能:** <列出確認來源的項目符號>。
**語音:** <語音名稱> · **長度:** ~XX 秒

### 鉤子 (0–3 秒)
- **視覺:** ...   - **聲音:** ...   - **旁白:** "..."
- 為何能抓住注意力:...

### 腳本
| 時間 | 旁白 | 視覺與效果 |
|---|---|---|
| 0–3 秒 · 鉤子 | ... | ... |
| ... · 煽動 | ... | ... |
| ... · 打擊 | ... | ... |
| ... · 轉折 | ... | ... |
| ... · 解決方案 | ... | ... |
| ... · CTA | ... | ... |

### 待你決定
- <僅列出真正需要決策的項目:語音、替代鉤子、需要修飾的承諾>

暫停並等待審核。修改腳本的成本很低;僅需套用修改並重新呈現變更的部分。

階段 2 — 製作(僅在收到 "可以開始製作" 後執行)

建立專案資料夾(例如:marketing/videos/<slug>/ 包含 assets/),將 templates/base.html 複製到 <slug>/index.html,並將 templates/fx.js 複製到 <slug>/fx.js。

5. 素材

在生成任何素材前,請先閱讀 references/audio.md 和 references/elevenlabs.md。

  • 旁白: 在 ElevenLabs 中生成 2 個 take(eleven_v4,使用 [urgent]、[short pause] 等標籤),品牌名稱應以其發音方式拼寫(例如:VEHIRO → "Verriro")。
  • 背景音樂: 在轉折前使用帶有緊張感的器樂,之後則用活潑的 Drop。
  • 鉤子音效: 警報聲、遊戲節目蜂鳴聲、收銀機聲等(短音效,約 1 秒)。
  • 寫實圖片(選用):"業務員的手機照片" — 請參閱 references/elevenlabs.md 關於每日限額與橫向格式的說明。
  • 應用程式真實畫面: 使用 3x 手機截圖(1170x2532)在手機構圖中效果最佳。 若無 ElevenLabs 或額度不足:提供無旁白版本(由動態排版傳達訊息),或等待客戶補充額度——未經詢問請勿更換語音或供應商。

6. 驗證語音

執行 python scripts/transcribe_check.py <語音檔案.mp3>(若存在 watch 技能則優先使用,否則使用 Whisper),並與文字比對。選擇沒有單字錯誤的 take;如果只有某個片段有錯誤(例如:「現在就停止」說成「現在就石停」),僅重新生成該片段,並使用 scripts/splice_phrase.py 拼接。如果需要替換某個單字但保持與現有影片的同步,請重新生成整個 take,並使用 scripts/align_phrases.py。

7. 時間對應表

  • python scripts/timing_map.py 語音.mp3 → 輸出包含每句台詞開始/結束時間的清單(包含靜音段)。
  • python scripts/music_drop.py 音樂.mp3 → 輸出 Drop 的精確秒數(低頻能量高峰)。
  • 定義 V(語音延遲,0.25–0.9 秒),並調整音樂起始點,使 Drop 落在轉折句的地方:音樂起始點 = (轉折開始時間 + V) - Drop時間。
  • 若音樂過短:執行 python scripts/extend_music.py 音樂.mp3 音樂-ext.mp3 --cut <秒數> --bars 2 --bpm <bpm>(使用交叉淡出重複活潑段落的節拍)。
  • 若語音超過約 48 秒:使用 atempo 加快 5–8%(保持音調)。 每個旁白動畫的開始時間:影片時間 = 語音時間 + V。

8. 合成

依照 references/dopamine-fx.md 和 references/hyperframes.md 在 index.html 中建構場景。最重要的規則:場景之間需重疊 0.2–0.5 秒,並以動畫過渡;每約 2 秒提供一次視覺 "獎勵";頂部保留進度條;避免將重要文字放在 Reels UI 會遮蓋的區域(頂部約 220 px,底部約 380 px)。

9. 視覺審查

執行 npx hyperframes lint .(確認 0 錯誤)和 npx hyperframes snapshot . --at <關鍵時間點> --no-end -o snapshots。檢查聯絡表:是否有文字被裁切、疊加難以辨識、空白場景、未產生動畫的元素。修正後僅對受影響的時間點重新檢查。當元素未出現或出現時機不對時,請查閱 references/pitfalls.md。

10. 渲染與驗證

執行 npx hyperframes render . -o ../renders/<slug>-9x16.mp4 -f 30 -q delivery,然後執行 python scripts/verify_render.py ../renders/<slug>-9x16.mp4:檢查影片長度、解析度 1080x1920、平均音量(約 -18 至 -20 dB),並進行轉錄。若鉤子未出現在轉錄結果中,表示音效蓋過了語音——請降低音效音量(請見 references/audio.md)。

11. 交付

傳送 MP4 檔案,並以白話說明:使用的鉤子、每個場景的內容、使用的效果,以及需要誠實告知的注意事項(例如轉錄結果聽起來不同的發音、僅為示意用的數字、已消耗的額度、未經聆聽驗證的部分)。

參考資料

  • references/copywriting.md — 7 幕結構、文案規則、觸發點。
  • references/hooks-catalog.md — 經過驗證的鉤子(視覺+聲音+旁白)以及適用時機。
  • references/dopamine-fx.md — 效果目錄、節奏與流暢過渡。
  • references/audio.md — 語音、發音、混音、Drop、拼接。
  • references/elevenlabs.md — 連接器、配額、限制與常見陷阱。
  • references/hyperframes.md — 合成骨架、音訊、Lint、快照、渲染。
  • references/pitfalls.md — 已解決的錯誤及其修正方法。
  • examples/ — 真實系列(VEHIRO)已審核通過的腳本,用於校準語氣與格式。

相關技能