前置動作(先執行)
_TEL_TIER=$(cat ~/.superstack/config.json 2>/dev/null | grep -o '"telemetryTier": *"[^"]*"' | head -1 | sed 's/.*"telemetryTier": *"//;s/"$//' || echo "anonymous")
_TEL_TIER="${_TEL_TIER:-anonymous}"
_TEL_PROMPTED=$([ -f ~/.superstack/.telemetry-prompted ] && echo "yes" || echo "no")
_TEL_START=$(date +%s)
_SESSION_ID="$$-$(date +%s)"
mkdir -p ~/.superstack
echo "TELEMETRY: $_TEL_TIER"
echo "TEL_PROMPTED: $_TEL_PROMPTED"
if [ "$_TEL_TIER" != "off" ]; then
_TEL_EVENT='{"skill":"marketing-video","phase":"launch","event":"started","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"}'
echo "$_TEL_EVENT" >> ~/.superstack/telemetry.jsonl 2>/dev/null || true
_CONVEX_URL=$(cat ~/.superstack/config.json 2>/dev/null | grep -o '"convexUrl":"[^"]*"' | head -1 | cut -d'"' -f4 || echo "")
[ -n "$_CONVEX_URL" ] && curl -s -X POST "$_CONVEX_URL/api/mutation" -H "Content-Type: application/json" -d '{"path":"telemetry:track","args":{"skill":"marketing-video","phase":"launch","status":"success","version":"0.2.0","platform":"'$(uname -s)-$(uname -m)'","timestamp":'$(date +%s)000'}}' >/dev/null 2>&1 &
true
fi
如果 TEL_PROMPTED 是 no:在開始技能工作流程之前,詢問使用者關於遙測資料的意願。
使用 AskUserQuestion:
幫助 superstack 變得更好!我們會追蹤哪些技能被使用以及使用時間 — 不包含程式碼、檔案路徑或個人識別資訊。隨時可以在
~/.superstack/config.json中更改。
選項:
- A) 當然,幫助 superstack 改進(匿名)
- B) 不了,謝謝
如果選擇 A:執行此 bash 指令:
echo '{"telemetryTier":"anonymous"}' > ~/.superstack/config.json
_TEL_TIER="anonymous"
touch ~/.superstack/.telemetry-prompted
如果選擇 B:執行此 bash 指令:
echo '{"telemetryTier":"off"}' > ~/.superstack/config.json
_TEL_TIER="off"
touch ~/.superstack/.telemetry-prompted
這只會發生一次。如果 TEL_PROMPTED 是 yes,則完全跳過此步驟,直接進入技能工作流程。
錯誤的技能? 請參閱 SKILL_ROUTER.md 以取得所有可用的技能。
行銷影片 — Remotion + Renoise
使用兩種互補的方法為你的 Solana 專案建立行銷影片:
- Remotion(程式碼驅動):程式化的 React 影片 — 完全控制、可重現、可版本控制。使用官方 Remotion 技能(38 個規則模組)。
- Renoise(AI 生成):AI 影片生成 — 快速、有創意、不需要程式碼
目標:看起來不像 AI 生成的專業品質。 在開始任何 Remotion 工作之前,請先閱讀 references/professional-quality-guide.md。
何時使用
/marketing-video— 完整的影片製作工作流程/deck-review— 將簡報轉換為影片格式- 「為我的 Solana 專案建立行銷影片」
- 「製作產品展示影片」
- 「把我的簡報變成影片」
- 「建立社交媒體宣傳片」
- 「為我的 dApp 製作 TikTok」
不可妥協的原則
- 絕不跳過訪談。 不要猜測產品、受眾或視覺方向。要問清楚。
- 絕不詢問動畫技術細節。 使用者不在乎 spring 設定或 TransitionSeries。詢問他們的產品、他們的故事、他們的品味。
- 保持有主見。 如果使用者對影片的想法很薄弱(太長、受眾不對、沒有鉤子),就要坦白說出來並引導他們。
- 視覺品味優先,程式碼其次。 在撰寫任何 Remotion 程式碼之前,先確定影片應該給人什麼樣的感覺。
- 主動收集素材。 要求提供螢幕截圖、標誌、品牌顏色。如果他們沒有,則自行尋找 SVG 圖示(Lucide、Heroicons)、生成配色方案,並建議插圖風格。
- 一站式服務。 此技能處理所有事情:訪談 → 概念 → 腳本 → 素材收集 → 架構建立 → 程式碼 → 渲染 → 平台裁切。使用者不需要其他工具。
工作流程
步驟 1:背景資訊收集(在問任何問題之前)
靜默檢查現有背景資訊。如果這些檔案存在,就讀取它們 — 不要讓使用者重複說:
.superstack/idea-context.md → 產品概念、受眾、價值主張
.superstack/build-context.md → 技術棧、功能、部署狀態
同時檢查:工作目錄中是否已存在 Remotion 專案?(remotion.config.ts 或 package.json 中有 remotion 依賴)
自動偵測產品素材。 在訪談之前,掃描專案目錄以尋找可用的視覺素材:
# 螢幕截圖和圖片
find . -maxdepth 3 -type f \( -name "*.png" -o -name "*.jpg" -o -name "*.jpeg" -o -name "*.webp" \) ! -path "*/node_modules/*" ! -path "*/.git/*" 2>/dev/null | head -20
# SVG 檔案(標誌、圖示、插圖)
find . -maxdepth 3 -type f -name "*.svg" ! -path "*/node_modules/*" ! -path "*/.git/*" 2>/dev/null | head -20
# 影片/螢幕錄影
find . -maxdepth 3 -type f \( -name "*.mp4" -o -name "*.webm" -o -name "*.mov" \) ! -path "*/node_modules/*" ! -path "*/.git/*" 2>/dev/null | head -10
# 來自 CSS/Tailwind 設定的品牌顏色
grep -r "primary\|accent\|brand" tailwind.config.* globals.css theme.* 2>/dev/null | head -10
# Package.json 中的專案名稱/描述
cat package.json 2>/dev/null | grep -E '"name"|"description"' | head -5
如果你找到了素材,在訪談中提到它們:「我注意到你在 public/ 目錄中有螢幕截圖和一個 SVG 標誌 — 我可以直接使用這些。」
步驟 2:訪談(深入、以產品為中心)
這是一場對話,不是問卷。從核心問題開始。根據他們的回答深入探討。除非你能清楚說明:產品是做什麼的、誰在乎、為什麼重要、以及影片應該讓人有什麼感覺,否則不要進入製作階段。
第一輪 — 產品(強制,全部詢問):
-
「向我解釋你的產品,就像我是個潛在用戶,而不是開發者。」 為什麼:迫使他們跳出技術術語。影片需要使用使用者的語言。
-
「具體來說,誰會看這個影片?不是『每個人』 — 告訴我一個人。」 為什麼:給 DeFi 老手的影片和給黑客松評審的影片完全不同。 如果回答模糊就跟進:「這個人是技術背景嗎?他們已經在用加密貨幣了嗎?當他們看到你的影片時在做什麼 — 滑 Twitter、瀏覽落地頁、坐在簡報會議裡?」
-
「你希望觀眾看完後做的一件事是什麼?」 為什麼:每個畫面都是為了引導達成這一個行動。沒有行動 = 沒有重點。 如果他們說「了解我們」就要反駁 — 那不是行動。「註冊」、「試用 demo」、「造訪網站」、「投票給我們」 — 這些才是行動。
第二輪 — 故事(強制,全部詢問):
-
「你的產品解決了什麼問題?描述那個痛苦 — 讓我感受到它。」 為什麼:最好的影片從觀眾已有的問題開始。沒有問題 = 沒有鉤子。
-
「你產品的『驚喜時刻』是什麼?就是讓人『喔等等,這真的很酷』的那個點。」 為什麼:這會成為影片的核心。如果他們說不出來,就深入探討:「使用者最常稱讚什麼?哪個展示環節會引起反應?」
-
「你有沒有一個數字可以讓人停止滑動?」 為什麼:在加密內容中,指標是最有力的鉤子。例如:「$2M TVL」、「400ms 結算」、「50K 筆交易」、「比以太坊便宜 10 倍」。 如果他們沒有指標:「你的產品最具體的證明是什麼?用戶數?交易量?速度比較?」
第三輪 — 品味(強制,全部詢問):
-
「給我看一個你喜歡的影片 — 任何品牌、任何行業都可以。要有那種你想要傳達的能量。」 為什麼:這比任何選擇題更能揭示期望的品質和調性。如果他們說不出來,就提供參考錨點:
- 「乾淨簡約,像 Apple 產品發表會?」
- 「快速有力,像加密 Twitter 的爆款?」
- 「技術宅風,像開發者大會演講?」
- 「大膽電影感,像電影預告片?」
- 「俏皮迷因風,像 TikTok 趨勢?」
-
「這個影片應該有什麼氛圍?選一個:自信、急迫、俏皮、神秘、權威、叛逆。」 為什麼:氛圍決定一切 — 調色盤、動畫速度、字體粗細、音樂選擇。
-
「人們會在哪裡看到這個?什麼平台?」 為什麼:決定格式(16:9 或 9:16)、長度(15 秒或 3 分鐘)和鉤子窗口(TikTok 1 秒、YouTube 5 秒)。
第四輪 — 素材(強制,全部詢問):
-
「你有:標誌、品牌顏色和產品螢幕截圖嗎?分享你有的東西。」 為什麼:真實的產品畫面讓專業影片與普通影片區分開來。如果他們什麼都沒有,沒關係 — 我們會生成視覺素材。
- 如果有標誌:儘可能取得 SVG 格式,否則 PNG 也行
- 如果有品牌顏色:取得十六進位色碼
- 如果有螢幕截圖:以最高解析度取得
- 如果什麼都沒有:「別擔心。我會建立一個視覺系統 — 我們會使用 SVG 圖示、生成的配色方案和動畫文字來建構影片。」
-
「文字疊加和字幕你偏好什麼寫作風格?全小寫且隨意,還是精緻且正式?」 為什麼:文字疊加和貼文文案應該符合創辦人的語氣。預設設定請閱讀 ../tone-guide.md。
-
「有沒有任何文字是必須出現的?標語、網址、指標、黑客松名稱?」 為什麼:有些文字是無可妥協的(贊助商標誌、黑客松品牌、產品網址)。
第五輪 — 限制條件(如有需要則詢問):
-
「有截止日期嗎?黑客松提交、發布日期、簡報會議?」 為什麼:如果他們需要在 2 小時內完成,我們就使用快速 Remotion 模板或 Renoise。如果有一週時間,我們可以更有野心。
-
「額外內容的預算?配音(ElevenLabs)、音樂、庫存素材?」 為什麼:決定我們只使用音效(免費)還是加入 TTS 配音 / 授權音樂。
訪談規則
- 順應調整,不要照本宣科。 如果使用者對問題 1 的回答很豐富,涵蓋了問題 2-4,就跳過那些問題。如果他們回答簡短,就深入挖掘。
- 挑戰薄弱的鉤子。 如果他們的「吸引人指標」是「我們使用 Solana」 — 那不是鉤子。要求具體且令人驚喜的內容。
- 不要虛假讚美。 如果他們的影片概念對 15 秒的 Twitter 剪輯來說太過野心勃勃,就直言不諱。如果他們的產品還沒有清晰的視覺故事,就幫助他們找到一個。
- 永遠不要問動畫偏好。 使用者不知道
spring damping是什麼,也不需要知道。詢問感覺,而不是技術。你負責將品味轉化為技術。 - 每則訊息最多 3 個問題。 不要一次丟出所有 13 個問題。以對話輪次進行。
步驟 2.5:即時研究(在創意方向決定前為強制步驟)
影片中顯示的每個指標都必須是最新的。在產出創意簡報之前,先進行研究:
- 使用網路搜尋或 MCP 工具(DefiLlama、CoinGecko)拉取產品及其競爭對手的當前 TVL、交易量、用戶數
- 取得與鉤子相關的最新生態系統統計資料(例如:Solana 永續合約總交易量、pump.fun 上啟動的代幣數量等)
- 驗證使用者在訪談中提到的任何數字
影片中以文字出現的每個數字都必須來自這次研究。 影片中的過時指標比沒有指標更糟。
檢查近期是否有駭客攻擊或漏洞利用。 不要正面提及被駭的協議。在引用任何協議作為競爭對手或比較對象之前,請先驗證。
步驟 3:創意方向(由你決定,使用者批准)
訪談結束後,由你產出創意方向。不要讓使用者從選單中挑選 — 提出一個單一且自信的建議,他們可以批准或反駁。
產出包含以下內容的創意簡報:
-
影片概念 — 一句話:「一個 30 秒的 Twitter 剪輯,以你的 $2M 結算指標開場,展示 3 步驟產品示範,並以你網站的 QR Code 結尾。」
-
故事敘述框架 — 選擇最佳的一個(閱讀 references/video-storytelling.md):
框架 最適合 結構 鉤子-證明-CTA Twitter、TikTok(15-30 秒) 驚人指標 → 示範證明 → 「試試看」 問題-示範-結果 產品展示(30-90 秒) 痛點 → 解決方案展示 → 結果 前後對比 落地頁(30-60 秒) 舊方法(痛苦) → 新方法(流暢) 極速通關 黑客松展示(1-3 分鐘) 快速完整產品導覽 見證夾心 YouTube、較長內容 用戶引言 → 展示 → 用戶引言 數據故事 DeFi/基礎設施產品 動畫指標講述成長故事 -
視覺方向 — 閱讀
video-craft技能的畫面構成參考以了解畫面原型,以及產品展示模式參考(如果影片包含產品螢幕截圖)。然後定義:- 調色盤(十六進位色碼 — 從他們的品牌衍生或自行生成)
- 字體選擇(標題字體 + 正文字體)
- 動畫感覺:「流暢優雅」或「快速有力」或「厚重電影感」
- 每個場景的畫面原型(英雄 / 產品 / 分割 / 數據 / 對比 / 結尾卡)
- 特效系列選擇(每個影片最多 1-2 個 — 參閱 frame-composition.md 中的特效系列章節)
- 關鍵視覺元素:每個場景中螢幕上出現什麼
-
逐場腳本 — 逐幀書寫:
場景 1(0-3 秒):鉤子 — 大型動畫指標「$2.1M」彈跳出現於黑色背景上。 字幕淡入:「30 天內結算。零銀行帳戶。」 場景 2(3-8 秒):問題 — 文字逐行揭示:「AI 代理無法相互付款 除非有人類共同簽署。」紅色調,低飽和度。 場景 3(8-22 秒):展示 — 產品螢幕截圖從右側滑入。動畫箭頭指向 關鍵功能。步驟標籤依序出現。 -
平台格式規格:
平台 比例 最大長度 建議長度 鉤子窗口 Twitter 1:1、16:9 2:20 15-30 秒 前 2 秒 TikTok 9:16 10:00 15-60 秒 前 1 秒 Instagram Reels 9:16 1:30 15-30 秒 前 1 秒 YouTube(Shorts) 9:16 1:00 15-60 秒 前 3 秒 YouTube(橫向) 16:9 ∞ 30 秒-3 分鐘 前 5 秒 網站/落地頁 16:9 ∞ 30-90 秒 前 3 秒
步驟 4:素材收集與製作
一旦方向獲得批准:
-
收集品牌素材:
- 從使用者的設計檔案或網站取得標誌(SVG > PNG)
- 從 tailwind 設定、CSS 變數或設計系統中提取品牌顏色
- 取得產品 UI 的螢幕截圖。如果沒有,使用 Lucide 或 Heroicons 生成 SVG 佔位符
-
設定 Remotion 專案: 將 Remotion Skills 安裝為子模組或複製到專案中:
git clone https://github.com/remotion-dev/skills.git cd skills npx remotion init npm install或將 Remotion 添加到現有專案:
npm install remotion @remotion/cli @remotion/renderer參考 Remotion Skills 規則模組來使用:
stills、transitions、text-animations、compositions和assets目錄中的 38 個模組
-
產生理想參考(可選): 如果使用者選擇了 Renoise(AI 生成),這種情況較少發生:
- 告訴 Remotion Skills 關於視覺方向並生成影片
- 它會生成一個參考影片,你可以用來向使用者傳達想法
- 目前,這是人類 vs Remotion 的創意生產力工具,還沒有人只是為了表達想法而使用 AI 生成器,但這種情況正在改變。
步驟 5:撰寫與製作
-
為每個場景撰寫 Remotion 元件,重複使用 Remotion Skills 模組進行排版、資產管理和轉場。使用來自
skills/effects、skills/typography等的規則。 -
實作視覺方向:
- 從
skills/assets載入 SVG 資產 - 使用來自
skills/colors的品牌顏色 - 使用來自
skills/transitions的轉場 - 應用來自
skills/animation的動畫
- 從
-
整合產品截圖和資料視覺化
-
在 Remotion 開發伺服器中預覽和迭代
步驟 6:渲染與輸出
為目標平台渲染:
| 平台 | 比例 | 解析度 | FPS | 音訊格式 |
|---|---|---|---|---|
| 1:1 | 1080x1080 | 30 | AAC | |
| TikTok | 9:16 | 1080x1920 | 30 | AAC |
| 9:16 | 1080x1920 | 30 | AAC | |
| YouTube | 16:9 | 1920x1080 | 30 | AAC |
使用 Remotion 批次渲染:
npx remotion render compositons --props='{"platform": "twitter"}'
npx remotion render compositons --props='{"platform": "tiktok"}'
步驟 7:交付與迭代
- 交付最終影片並附上平台專用版本
- 詢問:「還有什麼需要調整的嗎?我可以修改音訊、時間、文字、顏色或長度。」
- 根據需要進行迭代
參考文獻
- references/professional-quality-guide.md — 不顯示 AI 痕跡的專業品質
- references/video-storytelling.md — 故事框架
- ../video-craft/references/frame-composition.md — 畫面與特效
- ../video-craft/references/product-demo-patterns.md — 產品展示佈局
- ../tone-guide.md — 預設寫作語調
- ../../SKILL_ROUTER.md — 所有可用的技能
常見問題
影片太長/太短怎麼辦?
根據平台目標調整速度。Twitter 剪輯應該節奏明快(15-30 秒),YouTube 解說可以更從容(60-90 秒)。
我可以在 Remotion 中使用 AI 生成的資產嗎?
可以。Renoise 可以為 Remotion 元件生成資產(SVG 圖示、背景圖案)。
支援哪些語言?
預設為英文。Remotion 文字元件可以接受任何 Unicode 字串。腳本應以目標語言撰寫。
如何為多個平台進行最佳化?
以 16:9 寬螢幕渲染,然後為 9:16 平台重新構圖。或者,將所有渲染到 16:9 再發布。對於向量資產,Remotion 可以重新縮放,但基於截圖的展示需要小心處理。
最終檢查清單
在視覺定稿前請先檢查這個清單:
- 每個指標都已驗證為當前最新
- 影片概念與使用者描述的產品相符
- 目標受眾明確,鉤子也適合他們
- 結尾 CTA 清晰且可付諸行動
- 品牌顏色和字體在整個影片中一致使用
- 已檢查近期沒有漏洞或爭議
- 文字疊加在 3 秒內可讀
- 動畫流暢且不突兀
- 音訊音量一致(-14 LUFS 目標)
- 最終影片檔案已重新命名且易於定位
故障排除
- Remotion 渲染失敗: 檢查
node_modules是否已安裝。運行npm ls remotion驗證版本。 - 資產路徑錯誤: 在 Remotion 中使用絕對路徑或
staticFile()。 - 轉場未註冊: 從
skills/transitions匯入並註冊。 - 字幕溢出: 對於長文本使用
measureText(),或縮小字體大小。 - 文字動畫效能: 使用
spring而非timing以獲得更好的時間控制。 - 動畫與聲音不同步: 檢查
fps設定是否匹配。確保Audio元件具有正確的startFrom。 - 樣式不一致: 使用 CSS-in-JS 或 CSS 模組進行樣式封裝。