Yuv-Viral-Video
YUV.AI 的招牌病毒式短片製作流程。兩個技能協同工作:
video-use— 透過 ElevenLabs Scribe 轉錄來源影片,進行以逐詞為單位的剪輯,提取並串接片段成為base.mp4。這是剪輯與基礎佈局層。hyperframes— 將基礎影片作為背景,在 HTML/CSS/GSAP 中添加視覺組合層:使用真實backdrop-filter的液態玻璃卡片、具back.out彈性緩動效果的 GSAP 動畫、逐詞卡拉 OK 字幕、場景轉場,並透過 Chromium 渲染為 MP4。
你必須同時使用兩者。 不要自行發明基於 PIL 的卡片,不要預先將模糊效果烘焙到 PNG 中,也不要自行撰寫 ffmpeg 合成器。hyperframes 技能的存在正是為了以好萊塢品質處理視覺圖層。
配套技能(開始前請先閱讀)
兩個配套技能都已本地安裝,並在會話啟動時由 Claude Code 自動發現。你必須載入並應用它們的指南——此技能是它們之上的編輯層,而非取代品。
| 技能 | 路徑 | 負責範圍 |
|---|---|---|
video-use | ~/.claude/skills/video-use/SKILL.md (符號連結 → ~/Developer/video-use) | 轉錄 (ElevenLabs Scribe)、逐詞剪輯、調色、ffmpeg 正確性 (逐片段提取 → -c copy 串接、30 毫秒音頻淡入淡出、setpts=PTS-STARTPTS+T/TB 疊加、輸出時間軸 SRT 偏移、轉錄快取)。在製作 edl.json 之前,請先閱讀其**「硬性規則(生產正確性——不可協商)」**章節。輔助工具位於 ~/Developer/video-use/helpers/,並以 python helpers/<name>.py 方式呼叫。 |
hyperframes | ~/.claude/skills/hyperframes/SKILL.md | HTML 作為真理來源的影片組合、data-* 時間屬性、CSS 驅動的外觀、幀準確的時鐘動畫 (GSAP, Lottie, Motion One)。在撰寫組合 index.html 之前,請先閱讀其配套文件 house-style.md、data-in-motion.md、patterns.md、visual-styles.md。 |
hyperframes-cli | ~/.claude/skills/hyperframes-cli/SKILL.md | hyperframes init / lint / preview / render / transcribe / tts 命令。CLI 也已全域安裝 (hyperframes 在 $PATH 上),因此 npx 為可選。 |
gsap | ~/.claude/skills/gsap/SKILL.md | 完整的 GSAP 動畫詞彙。本文件中的 back.out(1.7) 彈性緩動規則僅是其中一種應用模式;當素材需要時,請使用 GSAP 的完整工具集。 |
website-to-hyperframes | ~/.claude/skills/website-to-hyperframes/SKILL.md | 一鍵操作:抓取 URL → hyperframes 組合。當來源包含值得重新呈現的螢幕 UI 時很有用。 |
優先級(當本文件與配套技能衝突時)
- 生產正確性(剪輯、編碼、ffmpeg 標誌、ffmpeg 濾鏡順序、轉錄處理) → 配套技能優先。 如果
video-use說「字幕在濾鏡鏈中最後應用,在所有疊加之後」,而本文件沉默或不同,請遵循video-use的指示。hyperframes API 慣例、data-*屬性、幀適配器模式也是如此。 - 編輯風格(字型、玻璃卡片、「絕不遮蓋臉部」、
_V<N>版本控制、原型佈局決策、MrBeast 節奏、無虛構內容規則) → 本文件優先。 配套技能刻意保持風格中立;YUV.AI 的自家風格定義在此。 - 策略確認:
video-use硬性規則 11 說「在執行前用純英文確認計劃。」對於 YUV.AI 風格的病毒式短片,這條規則被刻意暫停——風格已完整記錄在本文件的硬性規則中,因此代理應執行首次通過並根據反饋迭代,而不是因創意方向的問題而停頓。(對於非病毒式影片的 video-use 會話,請遵循配套技能的規則。) - 剪輯邊緣填充:
video-use允許 30–200 毫秒;本文件選擇 50 毫秒開頭 / 80 毫秒結尾作為該範圍內的 YUV.AI 預設值。兩者都正確;較窄的值是風格選擇。
共享配置
兩個技能都從 ~/Developer/video-use/.env 讀取 ELEVENLABS_API_KEY。設定一次後兩個技能都能運作。不要在本技能目錄中重複此金鑰。
儲存位置
預設位置: ~/Documents/yuv-projects/videos/<slug>/ — 永遠將病毒式影片專案儲存在此處,以便渲染結果可被找到。<slug> 應簡短,由主題或來源檔案名稱衍生。
mkdir -p ~/Documents/yuv-projects/videos
cd ~/Documents/yuv-projects/videos
# 在此初始化專案。
hyperframes init <slug> --video <source.mp4> --non-interactive
cd <slug>
最終渲染產出位於 ~/Documents/yuv-projects/videos/<slug>/renders/final_*_V<N>.mp4(同時包含 9:16 和 16:9)。每次渲染結束時告知使用者影片位置。
風格偏好(強制性預設值——繼承自 yuv-design-system)
此技能是 Yuval Avidani 品牌系統的影片實例化。每當來源內容未明確指定品牌或色板時,這些預設值便會套用。它們會覆蓋任何配套技能中相互衝突的預設值。
字體排版
| 角色 | 英文 | 希伯來文 | 規則 |
|---|---|---|---|
| 展示 / 卡片 / 卡拉 OK 字幕 | Anton(大寫,粗細 400 + 緊密字距 -0.02em 到 -0.04em) | Rubik Black(粗細 900) | 英文永遠使用大寫,絕不使用標題大小寫。希伯來文展示文字永遠使用粗細 900。 |
| 內文 / 玻璃卡片正文 / 晶片文字 | Inter (400 / 500 / 600 / 700) | Assistant (400 / 500 / 600 / 700) | 僅當卡片在展示標題下方有次要正文時使用。卡片內行高 1.4。 |
| 數字 / 計數器 / 統計資料 | Anton | Rubik Black | 將數字視為展示文字,永不使用內文字型。 |
| 程式碼 / 等寬字型(終端機卡片、路徑) | JetBrains Mono | — | 用於打字機風格的程式碼揭示。 |
希伯來文方向: 每個希伯來文字幕容器上設定 dir="rtl"。僅在 PIL 後備路徑中使用 python-bidi 的 get_display();CSS 原生處理 RTL。邏輯 CSS 屬性(margin-inline-*、padding-inline-*)優先於物理屬性(margin-left)。
禁用: 襯線字型作為預設值、system-ui 堆疊、Anton 用於希伯來文字(會渲染為空心 X——Anton 僅限拉丁字母)。
色彩色板
YUV.AI 的標準色板及其影片調校版本:
| 角色 | 網頁標準 | 影片渲染(在 MP4 內使用) | 偏差原因 |
|---|---|---|---|
| 米白 / 紙張 | #FAFAF7 | #F5F0E1(更暖) | 在有文字描邊的深色背景上顯得更溫暖;減少 H264 上的「藍白眩光」效果。 |
| 黃色 / 強調色 | #E5FF00 | #FFE61E | 飽和度略高;在小尺寸下能穿透黑色文字描邊。 |
| 粉紅 / 品牌線索 | #FF1464 | #FF1464 | 相同。用作玻璃卡片邊框強調、關鍵時刻條紋描邊、品牌線索。 |
| 黑色 / 背景 | #0A0A0A | #0c0e16(暖色近黑) | 避免 H264 下的純黑色帶狀雜訊。 |
| 炭灰 / 淺色背景文字 | #1A1A1A | — | 僅用於 UI 疊加層(預覽頁面,絕不在渲染的 MP4 內部)。 |
| 骨色 / 奶油色 | #F5EEE4 | — | 用於網頁,絕不在 MP4 內部。 |
任何渲染輸出中禁用:
- 純
#FFFFFF— 一律替換為更暖的米白色。 - 藍色強調色(海軍藍、灰藍、靛藍、冷灰),除非來源品牌要求。
- Tailwind 預設色板名稱(
slate-*、zinc-*、gray-*、emerald-*、cyan-*、indigo-*、violet-*、rose-*)。 - 多色圖示集——僅限 Phosphor 或 Lucide 單線條。
佈局與動畫預設值
- 邊框半徑: 玻璃卡片使用
40–56px(標誌性柔和圓角)。按鈕 CTA 使用999px。絕不使用 8/12px 的企業級圓角中間值。 - 陰影: 暖色調(粉/橘色底調)—
0 20px 60px rgba(255, 20, 100, 0.12)應用於玻璃卡片,絕不使用預設的藍黑色rgba(0,0,0,.1)。 - 留白: 寬敞。卡片絕不佔據畫面自由區域超過 60%。
- 不對稱性優先於完美網格。 偏移卡片。重疊。讓一個元素打破網格。
- 顆粒感: 在預覽/目錄頁面上加入 1–2% 的噪點(不在渲染的 MP4 內部,否則壓縮後會變成一團)。
- 動畫庫: GSAP(始終使用)。卡片入場使用
back.out(1.7),SplitText 揭示使用power3.out,重拍使用expo.out,靜止浮動使用sine.inOut。
繼承規則
如果你正在建構任何輔助表面(預覽頁面、目錄、儀表板、渲染狀態 UI),請套用完整的 yuv-design-system 技能預設值——字型使用 Anton + Inter,色板預設使用 Fly High 紫色,以及標誌性元件和品牌資產。yuv-design-system 是所有 Yuval 品牌視覺效果的權威來源。
如果你正在渲染 MP4 本身,請套用上表中的影片調校數值。同一品牌,兩種交付表面。
即時效果目錄(將此作為選單)
Yuval 維護了一個公開、即時、可滾動的視覺效果目錄,包含此技能可應用於影片的每種效果、轉場、標記、卡片、主題和音效:
當委託編輯時,Yuval(或他發送目錄連結的任何人)點擊任何效果的晶片——該晶片會將一個穩定的識別碼(如 captions.karaoke.scale-pop)複製到剪貼簿。他將這些 ID 貼到提示詞中:
"用
style.swiss-pulse編輯這個,字幕使用karaoke.scale-pop,統計資料使用marker.circle,轉場使用blur-crossfade,每個剪輯點音效使用whoosh,重點詞音效使用impact。"
你必須尊重使用者貼上的每個效果 ID。 目錄頁面是單一事實來源——每個 ID 都對應於一個有文件記錄且行為經過驗證的效果。如果使用者說出你無法辨識的 ID,請擷取目錄 (https://effects.yuv.ai) 並找到其定義,而不是即興發揮。
該目錄還包含一個提示詞庫 (effects.yuv.ai #prompts),其中有 8 個生產就緒的完整編輯提示詞(產品發表 / 解說 / 即時編碼 / 流程逐步解說 / 熱門評論 / 教學 / 創始人簡報 / 希伯來語談話節目)。當使用者提到「X 場景的提示詞」時,請導向那裡。
雙語渲染——同一影片中混合希伯來文與英文
許多編輯會混合希伯來語旁白與英文品牌詞彙(Claude、GitHub、hyperframes 等)。此技能必須:
-
逐字形字型路由 — Anton 處理拉丁字母,Rubik Black 處理希伯來文。每個文字容器上聲明單一
font-family: 'Anton', 'Rubik', sans-serif即可自動完成此操作。切勿將 Anton 應用於希伯來文字元(它會渲染成空心 X——Anton 僅限拉丁字母)。 -
RTL 容器 — 每個希伯來文字幕行在其容器上設定
dir="rtl"。同一行內的英文品牌詞彙會透過瀏覽器的雙向演算法保持 LTR——無需手動重新排序。 -
品牌名稱的希伯來文拼寫 — Yuval 偏好的希伯來文音譯:
- "Claude" → "קלוד"(而非 "קלאוד")
- "Hyperframes" → 保留英文 ("Hyperframes")
- "GitHub" → 保留英文 ("GitHub")
- 當 Scribe 轉錄品牌名稱時使用了錯誤的希伯來文拼寫,請在生成卡拉 OK 圖層之前的後轉錄處理中修正它。
-
配套目錄隨處都有雙語 EN/HE — 即時目錄可在切換時將整個 UI 轉換為希伯來文(參見 effects.yuv.ai)。同樣的
data-lang切換模式適用於此技能產生的任何輔助表面(預覽頁面、渲染狀態 UI 等)。
從生產迭代中學到的經驗
以下經驗是在實際會話中學到的,現在存放在 ~/.claude/skills/yuv-design/lessons-learned.md。在建構任何輔助前端(預覽頁面、渲染儀表板、目錄)之前,請先閱讀該檔案。影片流程本身由下方的硬性規則管轄——但此技能產生的任何 HTML/CSS 表面都必須遵守:
- 雙語 = 切換,而非並排(
lessons-learned.md中的經驗 #1) - 行動版 = 在 ≤880px 時使用漢堡選單(經驗 #2)
- 每個章節一個展示標題(經驗 #3)
document.title是語言切換的一部分(經驗 #5)- 任何包含超過 8 個示範的目錄皆使用 IntersectionObserver(經驗 #9)
- 首次通過就全面建構——不要在範圍上迭代(經驗 #10)
- SPA 使用
Claude-in-Chrome,僅靜態 HTML 使用WebFetch(經驗 #7, #15) - 從真實來源頁面驗證內容,絕不虛構(經驗 #8)
何時諮詢此技能
任何時候使用者放下影片檔案並要求編輯時。即使是一行指令如 "把這個拿去編輯:<路徑>" 也應觸發下方的完整流程。不要事先詢問創意方向——使用者的風格已記錄在下方的硬性規則中;只需執行並根據反饋迭代。
在觸碰任何東西之前要內化的三件事
1. 絕不虛構內容。 每張卡片上的每個字都必須追溯到講者在逐字稿中實際說過的內容。沒有假貨幣佔位符 ("$$$"),沒有假百分比 ("100% understood"),沒有虛構的 CTA ("link in bio"),如果沒有承諾過連結的話。使用者會立即發現虛構內容,信任會迅速崩潰。當有疑問時,將希伯來文原文引用複製到卡片上。同樣的規則適用於品牌名稱的希伯來文音譯——例如,當品牌是 "Claude" 時,正確的希伯來文為 "קלוד"。
2. 絕不遮蓋他們的臉。 這是 YUV.AI 風格的一條神聖規則。動畫卡片、彈出文字、品牌標誌——這些東西可以出現在肩部以上、臉部周圍、螢幕角落,但永遠不能在講者的眼睛、鼻子或嘴巴上。如果一個效果有可能遮擋臉部,放棄該效果或將其重新定位到不會遮擋的區域。
3. 始終渲染兩種版本:9:16 和 16:9。 這不是可選的。第一個渲染為 final_9x16_V1.mp4。第二個為 final_16x9_V1.mp4。下一次迭代遞增版本次號:_V2、_V3 等。備份位於 ~/Documents/yuv-projects/videos/<slug>/renders/。
硬性規則(生產正確性——不可協商)
規則 1:始終從 video-use 的 --viral 模式開始
不要猜測剪輯點。執行:
cd ~/Developer/video-use
python pipeline.py --viral <source video path>
這會產生含有逐詞時間戳記的 transcript.json、含有基於逐字稿的剪輯點和 start/end 時間的 edl.json,以及 base.mp4——未經處理、提取的片段串接而成,準備好餵給 hyperframes。
不要修改 edl.json 以加入人工剪輯點,除非使用者明確要求。如果逐字稿中有 47 秒的靜默,沒關係——讓 --viral 模式處理它。
規則 2:在 hyperframes 中處理顏色分級和濾鏡
所有調色、色調映射、升格等操作都在 hyperframes 組合的 CSS 中完成。不要在 ffmpeg 層級對 base.mp4 進行顏色分級。hyperframes 中的影片元素可以使用 CSS 濾鏡和混合模式:
video {
filter: contrast(1.10) saturate(1.15) brightness(0.95);
/* YUV.AI 標誌性外觀:輕微淡化 + 增加對比度 */
}
規則 3:詞彙表
- 段落 (Paragraph / Segment) — 逐字稿中的一個連貫區塊,對應於 Scribe 輸出中的一個段落。
- 剪輯點 (Cut point) —
edl.json中的一個條目,包含start、end(以秒為單位)和text(逐字稿文字)。這是base.mp4中一個片段。 - 卡片 (Card) — hyperframes 中一個視覺元素,呈現剪輯點文字或元資料。一個剪輯點可以產生多張卡片。
- 版本 (Version) — 一個有編號的渲染輸出。從
V1開始,每次修改循環後遞增。
規則 4:一次提示詞循環 = 一個版本 -> 反饋 -> 修改 -> 再次提交
不要嘗試在第一次渲染中就做到完美。執行首次通過,展示結果,根據反饋進行疊代。
規則 5:在 hyperframes 中始終為影片元素設定 object-fit: cover
確保背景影片無裁剪地填滿畫面。在 標籤上使用 playsinline muted loop。
規則 6:卡片的動畫時間與剪輯點對齊
卡片應在剪輯點開始時進入,並在剪輯點結束前淡出。使用 data-start 和 data-end 屬性,這些屬性由 hyperframes 執行時間解析:
<div class="card" data-start="12.5" data-end="18.2">
<h1>內容</h1>
</div>
規則 7:使用效果目錄進行風格決策
如果使用者在提示詞中指定了效果 ID(例如 style.swiss-pulse、captions.karaoke.scale-pop),則在 https://effects.yuv.ai 查詢對應的實作並精確套用。永遠不要猜測效果的行為——查閱目錄。
規則 8:字幕寬度永遠不超過畫面寬度的 90%
為確保可讀性並避免邊界裁剪,所有字幕容器的最大寬度為畫面寬度的 90%。在 CSS 中:
.caption-container {
max-width: 90vw;
margin: 0 auto;
}
規則 9:所有最終輸出為 H.264 編碼的 MP4
使用 libx264 編碼器,CRF 18,preset medium。音頻為 AAC,128 kbps,44.1kHz。hyperframes 渲染命令應該已經處理了這個。如果手動呼叫 ffmpeg,請應用這些設定。
ffmpeg -i <input> -c:v libx264 -crf 18 -preset medium -c:a aac -b:a 128k -ar 44100 <output>
規則 10:渲染前始終執行 hyperframes lint
在呼叫 hyperframes render 之前,在組合目錄中執行 hyperframes lint。這會檢查常見問題:遺失的 data-* 屬性、格式錯誤的時間、缺失的資源。在 lint 通過之前不要渲染。
規則 11:層疊斷言(Cascading Assertions)
如果此硬性規則與 video-use 或 hyperframes 配套技能中的規則衝突,請依照章節 III-A 中的優先級表格處理。
規則 12:最終交付
一旦渲染完成:
- 將檔案移至
~/Documents/yuv-projects/videos/<slug>/renders/ - 確認兩個解析度 (9:16 和 16:9) 都存在
- 告知使用者確切檔案路徑
使用範例提示詞
"編輯這個:~/Downloads/my_video.mp4"
"把這個變成病毒式短片:~/Desktop/screen_recording.mov"
"ערוך סרטון: ~/Videos/interview.mp4"(希伯來文:"編輯這個影片")
"用
style.swiss-pulse效果和captions.karaoke.scale-pop字幕編輯這個"
"顯示目錄"(在這種情況下,開啟 https://effects.yuv.ai)
"我要用產品發表提示詞"(導向 effects.yuv.ai #prompts 中的產品發表提示範本)
此技能由 YUV.AI 維護,並從 yuv-design-system 繼承品牌規則。