Sarthib7/agentsmith

前言（先執行）

_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 變得更好！我們會追蹤哪些技能被使用以及花費時間—— 不包含程式碼、檔案路徑或個人識別資訊 (PII)。隨時可在 ~/.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 製作抖音影片"

不可妥協的原則

• 絕不省略訪談。 不要猜測產品、目標受眾或視覺方向。提問。
• 絕不詢問動畫技術細節。 使用者不在乎 spring 設定或 TransitionSeries。詢問他們的產品、他們的故事、他們的品味。
• 堅持你的觀點。 如果使用者對影片的想法很糟（太長、目標受眾錯誤、沒有鉤子），要直接說出來並引導他們。
• 先有視覺品味，再談程式碼。 在撰寫任何一行 Remotion 程式碼之前，先確定影片應該給人什麼「感覺」。
• 主動收集素材。 要求提供螢幕截圖、Logo、品牌顏色。如果他們沒有，就自行尋找 SVG 圖示（Lucide、Heroicons）、產生色板，並建議插圖風格。
• 一站式服務。 此技能處理所有事情：訪談 → 概念 → 分鏡 → 素材收集 → 建立框架 → 編碼 → 渲染 → 平台剪輯。使用者不需要其他工具。

工作流程

步驟 1：脈絡蒐集（在問任何問題之前）

靜默檢查現有脈絡。如果這些檔案存在，請讀取它們——不要讓使用者重複說明：

.superstack/idea-context.md    → 產品概念、目標受眾、價值主張
.superstack/build-context.md   → 技術棧、功能、部署狀態

同時檢查：工作目錄中是否已存在 Remotion 專案？（remotion.config.ts 或帶有 remotion 依賴的 package.json）

自動偵測產品素材。 在訪談之前，掃描專案中可用的視覺素材：

# 螢幕截圖和圖片
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 檔案（Logo、圖示、插圖）
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 Logo——我可以直接使用它們。」

步驟 2：訪談（深入、專注於產品）

這是一場對話，不是一份問卷。從核心問題開始。根據他們的回答深入挖掘。在你能清楚表達「產品做什麼、誰在乎、為何重要、以及影片應該讓人有何感受」之前，不要進入製作階段。

第一輪 — 產品（必問，全部要問）：

1. 「請像把我當成一個潛在用戶一樣解釋你的產品，而不是一個開發者。」 原因：迫使他們擺脫技術術語。影片需要能和使用者溝通。

2. 「具體是誰會來看這支影片？不是『所有人』——告訴我一個特定的人。」 原因：為 DeFi 狂熱者做的影片和為黑客松評審做的影片完全不同。 後續追問（如果答案模糊）：「這個人懂技術嗎？他們已經在使用加密貨幣了嗎？他們看到你的影片時在做什麼——滑 Twitter、瀏覽登陸頁面、還是在開提案會議？」

3. 「你希望觀眾看完影片後做的一件『具體行動』是什麼？」 原因：每一個畫面都是為了引導觀眾完成這個行動。沒有行動 = 沒有意義。 如果他們說「了解我們」，要反駁——這不是一個行動。「註冊」、「試用示範」、「造訪網站」、「投票給我們」——這些才是行動。

第二輪 — 故事（必問，全部要問）：

4. 「你的產品解決了什麼問題？描述這個痛點——讓我『感覺』到它。」 原因：最好的影片從觀眾已經遇到的問題開始。沒有問題 = 就沒有鉤子。

5. 「你產品中的『驚喜時刻』是什麼？就是讓人家覺得『哦等等，這真的很酷』的那個點。」 原因：這會成為影片的核心。如果他們說不出來，要試探：「用戶最常稱讚什麼？哪個示範環節會引起反應？」

6. 「你有沒有一個數字，能讓人停止滑動？」 原因：在加密內容中，指標是最強大的鉤子。例如：「$2M TVL」、「400ms 結算」、「5 萬筆交易」、「比以太坊便宜 10 倍」。 如果他們沒有指標：「你的產品最具體的成效證明是什麼？用戶數量？交易量？速度比較？」

第三輪 — 品味（必問，全部要問）：

7. 「給我看一支你喜歡的影片——任何品牌、任何行業都可以。一支能捕捉到你想要的那種『能量』的影片。」 原因：這比任何選擇題更能揭露他們對品質和風格的期望。如果他們說不出來，提供參考錨點：

   • 「乾淨簡約，像 Apple 產品發表會那樣？」
   • 「快速有力，像加密貨幣 Twitter 上的熱門影片？」
   • 「技術宅風格，像開發者會議的演講？」
   • 「大膽電影風，像電影預告片？」
   • 「有趣迷因風，像 TikTok 趨勢？」

8. 「這支影片應該有什麼『氛圍』？選一個：自信、急迫、有趣、神秘、權威、叛逆。」 原因：氛圍決定一切——色板、動畫速度、字型粗細、音樂選擇。

9. 「人們會在什麼地方看到這支影片？哪個平台？」 原因：決定格式（16:9 vs 9:16）、長度（15 秒 vs 3 分鐘）和鉤子時間（TikTok 1 秒，YouTube 5 秒）。

第四輪 — 素材（必問，全部要問）：

10. 「你有：Logo、品牌顏色、以及產品螢幕截圖嗎？分享你有的東西。」 原因：真實的產品畫面能讓專業影片與普通影片區分開來。如果他們什麼都沒有也沒關係——我們會生成視覺素材。

    • 如果有 Logo：盡可能取得 SVG 格式，否則 PNG
    • 如果有品牌顏色：取得十六進位色碼
    • 如果有螢幕截圖：以最高解析度取得
    • 如果什麼都沒有：「沒關係。我會建立一個視覺系統——我們會使用 SVG 圖示、生成的色板，以及動態文字來構建影片。」

11. 「對於文字疊加和字幕，你有偏好的寫作語氣嗎？像全小寫的 casual 風格，還是經過修飾的正式風格？」 原因：文字疊加和貼文文案應符合創辦人的語氣。請參閱 ../tone-guide.md 了解預設值。

12. 「有任何『必須』出現的特定文字嗎？標語、網址、指標、黑客松名稱？」 原因：有些文字是不可協商的（贊助商 Logo、黑客松品牌標示、產品網址）。

第五輪 — 限制條件（必要時詢問）：

12. 「有截止日期嗎？黑客松提交、產品發布、提案會議？」 原因：如果他們需要在 2 小時內完成，我們會使用快速 Remotion 模板或 Renoise。如果他們有一週時間，我們可以更有企圖心。

13. 「有額外的預算嗎？例如配音（ElevenLabs）、音樂、庫存影片素材？」 原因：決定我們要使用純音效（免費）或加入 TTS 配音/授權音樂。

訪談規則

• 適應性調整，不要死背稿。 如果使用者對問題 1 的回答已經涵蓋了問題 2-4 的內容，就跳過它們。如果他們回答簡短，則深入挖掘。
• 挑戰薄弱的鉤子。 如果他們的「讓人停止滑動的指標」是「我們使用 Solana」——這不是一個鉤子。要求一個具體且令人驚訝的點。
• 不要虛假讚美。 如果他們的影片概念對一個 15 秒的 Twitter 剪輯來說太過雄心勃勃，就直接說出來。如果他們的產品還沒有清晰的視覺故事，幫助他們找到一個。
• 永遠不要詢問動畫偏好。 使用者不知道 spring damping 是什麼意思，也不應該需要知道。詢問「感覺」，而不是技術。你負責將品味轉化為技術。
• 每則訊息最多 3 個問題。 不要把全部 13 個問題一次倒出來。以對話方式進行。

步驟 2.5：即時研究（在創意方向確定前必須執行）

影片中顯示的每個指標都必須是當前的。在產生創意簡報之前，請先進行研究：

• 使用網路搜尋或 MCP 工具（DefiLlama、CoinGecko）獲取產品及其競爭對手的當前 TVL、交易量、用戶數
• 取得與鉤子相關的最新生態系統計數據（例如 Solana 總永續合約交易量、在 pump.fun 上發行的代幣數量等）
• 驗證使用者在訪談中提到的任何數字

影片中以文字形式出現的每個數字都必須來自這次的研究。 影片中使用過時的指標比完全沒有指標更糟。

檢查近期是否有駭客攻擊/漏洞事件。 不要在影片中正面提及被駭的協議。在引用任何協議作為競爭對手或比較對象之前，務必先進行驗證。

步驟 3：創意方向（你決定，使用者批准）

訪談結束後，由你來產出創意方向。不要要求使用者從選單中挑選——提出一個單一的、充滿自信的建議，他們可以批准或提出異議。

輸出一個包含以下內容的創意簡報：

1. 影片概念 — 一句話：「一個 30 秒的 Twitter 剪輯，以你的 $2M 結算指標開場，展示一個 3 步驟的產品示範，並以導向你網站的 QR 碼結尾。」

2. 說故事框架 — 選擇最佳框架（請閱讀 references/video-storytelling.md）：

   框架	最適合	結構
   鉤子-證明-行動呼籲	Twitter、TikTok（15-30 秒）	驚人指標 → 示範證明 → 「試試看」
   問題-示範-結果	產品示範（30-90 秒）	痛點 → 解決方案示範 → 成果
   之前/之後	登陸頁面（30-60 秒）	舊方法（痛苦） → 新方法（順暢）
   快速通關	黑客松示範（1-3 分鐘）	快速完整的產品導覽
   使用者口碑三明治	YouTube、較長內容	用戶引言 → 示範 → 用戶引言
   數據故事	DeFi/基礎設施產品	動畫指標講述成長故事

3. 視覺方向 — 用文字描述的 mood board：

   • 色板（十六進位色碼——根據他們的品牌衍生或自行生成）
   • 字型選擇（標題字型 + 內文字型）
   • 動畫感覺：「流暢優雅」或「快速有力」或「厚重電影風」
   • 關鍵視覺元素：每個場景中螢幕上會出現什麼

4. 逐場景分鏡腳本 — 逐幀書寫：

   場景 1 (0-3 秒)：鉤子 — 大型動畫指標「$2.1M」在黑色背景上彈入。
                   字幕淡入：「30天內結算。零銀行帳戶。」
   場景 2 (3-8 秒)：問題 — 文字逐行顯示：「AI 代理無法在沒有人類共同簽署者的情況下相互支付。」紅色調、去飽和處理。
   場景 3 (8-22 秒)：示範 — 產品螢幕截圖從右側滑入。動畫箭頭指向關鍵功能。步驟標籤依序出現。
   場景 4 (22-27 秒)：證明 — 三張指標卡片交錯彈入：「5 萬+ 筆交易」、「120 個代理」、「<400ms 結算」
   場景 5 (27-30 秒)：行動呼籲 — 「立即試用」並附上網址和 QR 碼。光漏轉場。
   

5. 所需視覺元素 — 具體清單：

   • 需要截取/提供的螢幕截圖
   • 要使用的 SVG 圖示（來自 Lucide、Heroicons 或自訂）
   • 需要創建的插圖或圖表
   • 品牌素材（Logo 放置位置、顏色）

6. 方法決定 — Remotion 或 Renoise

...