前置動作(先執行)
_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":"video-craft","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":"video-craft","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:在開始技能工作流程之前,詢問使用者關於遙測的偏好。選項:A) 可以(匿名) B) 不用了,謝謝。這件事只會發生一次。
錯誤的技能? 請參閱 SKILL_ROUTER.md 查看所有可用的技能。
影片工藝
用於 Remotion 影片的幀級視覺構圖與產品展示呈現。這個技能讓影片的每個影格看起來是經過刻意設計的,而不僅僅是正確動畫化而已。
marketing-video 負責生產流程(訪談、故事敘述、動畫機制、渲染)。這個技能負責每個靜態影格的外觀——構圖、裝置框架、背景、效果選擇以及片尾卡片設計。
權責模型
marketing-video→ 生產流程、動畫機制、基本品質(字型最小值、安全區域、彈簧物理)design-taste→ 美學方向。這個技能使用它,而不是重新定義它。- 本技能 → 針對時間受限觀看的幀構圖、產品展示呈現、片尾卡片設計、效果家族
繼承(不重述): 字型最小值、行動安全區域、文字可讀性、來自 marketing-video 的彈簧預設值。來自 design-taste 的色彩節制、不對稱、留白。
何時觸發
- 審查 Remotion 構圖的視覺品質
- 建立含螢幕截圖的產品展示影片
- 設計片尾卡片 / 號召性用語(CTA)影格
- 使用者說「影片影格看起來很普通」或「讓這個看起來更精緻」
marketing-video在創意方向或建置階段時呼叫此技能
不要在「建立影片」或「行銷影片」時觸發——這些應導向 marketing-video。
工作流程
- 檢查
design-taste以取得美學方向(或要求使用者選擇一個) - 識別相關的參考資料:
- 構圖影片影格或片尾卡片 → references/frame-composition.md
- 建置產品展示場景 → references/product-demo-patterns.md
- 為每個場景產出幀簡報
- 在渲染前執行預飛檢查清單
幀簡報(每個場景)
場景:[名稱]
時長:[秒 / 影格數]
比例:[16:9 / 9:16 / 1:1]
焦點:[眼睛首先看到的地方]
類型:[英雄 / 產品 / 分割 / 數據 / 比較 / 片尾]
裝置:[筆電 / 手機 / 瀏覽器 / 無]
所需素材:[螢幕截圖路徑、標誌、圖示名稱]
背景:[放射漸層 + 噪點 / 螢幕截圖模糊 / 網格 / 純色]
效果家族:[發光 / 動態 / 液體 / 音頻鎖定 / 深度 / 無]
動畫:[入場彈簧設定、停留影格、出場]
預飛檢查清單
- 每個影格都有一個清晰的焦點
- 螢幕截圖放在裝置框架內,而不是浮動的原始圖
- 背景具有深度(漸層 + 噪點或暗角),不是純色平面
- 螢幕上每個文字區塊最多 8 個字
- 文字影格的停留時間 >=
(字數 x 0.3) + 1秒 - 片尾卡片至少 3 秒且只有一個動作
- 效果家族限制在每個影片 1-2 個
- 在任何幀工作之前選擇美學方向
資源
references/
- references/frame-composition.md — 幀類型(16:9 和 9:16)、時間受限的可讀性、背景深度、效果家族、片尾卡片類型(簡潔/指標/動作/循環)
- references/product-demo-patterns.md — Remotion 就緒:裝置框架(筆電/手機/瀏覽器)、遊標編排、縮放配方、螢幕截圖準備、註解模式
跨技能參考
marketing-video— 生產流程、動畫機制、基本品質規則design-taste— 在幀工作前使用的美學方向number-formatting— 用於幀中顯示的任何指標
遙測(最後執行)
_TEL_END=$(date +%s)
_TEL_DUR=$(( _TEL_END - ${_TEL_START:-$_TEL_END} ))
_TEL_TIER=$(cat ~/.superstack/config.json 2>/dev/null | grep -o '"telemetryTier": *"[^"]*"' | head -1 | sed 's/.*"telemetryTier": *"//;s/"$//' || echo "anonymous")
if [ "$_TEL_TIER" != "off" ]; then
echo '{"skill":"video-craft","phase":"launch","event":"completed","outcome":"OUTCOME","duration_s":"'"$_TEL_DUR"'","session":"'"$_SESSION_ID"'","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","platform":"'$(uname -s)-$(uname -m)'"}' >> ~/.superstack/telemetry.jsonl 2>/dev/null || true
true
fi
根據工作流程結果,將 OUTCOME 替換為 success / error / abort。