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)。
禁止: 将衬线字体作为默认字体、系统 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(标志性的柔和圆角)。胶囊按钮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、每次剪切sfx whoosh、关键词语sfx 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)
- 单页应用使用
Claude-in-Chrome,静态 HTML 使用WebFetch(经验教训 #7、#15) - 从真实源页面验证内容,绝不虚构(经验教训 #8)
何时使用此技能
每当用户拖放一个视频文件并请求编辑时。即使是像 ”拿去编辑:“ 这样一行字的请求,也应触发下面的完整流程。不要一开始就问创意方向——用户的风格已包含在下面的硬性规则中;只需执行并从反馈中迭代。
在动手之前要内化的三件事
1. 绝不虚构内容。 卡片上的每个词都必须源自发言人在转录中实际说过的话。没有虚假的货币占位符("$$$"),没有虚假的百分比("100% 理解"),如果未承诺链接,则没有虚构的行动号召("链接在个人简介")。用户会立即发现虚构内容,信任会迅速崩溃。如有疑问,将希伯来语原文引语复制到卡片中。此规则同样适用于品牌名称的希伯来语音译——例如,当品牌是"Claude"时,正确的希伯来语音译是"קלוד"(而非"קלאוד");请使用品牌所有者偏好的拼写,而不是 Scribe 听到的。
2. 绝不遮挡说话者的脸部。 将卡片定位在与脸部相反的画面一半,或使用位于脸部区域上方/下方的顶部/底部横幅。对于全屏自拍,安全区域是 y=0–400(顶部横幅)和 y>1500(底部)。对于说话者位于角落画中画的屏幕共享素材,卡片可以放置在屏幕内容区域的任何位置。
3. 绝不非等比缩放说话者。 源画中画的宽高比必须等于目标画中画的宽高比。如果你将 470×460 的源裁剪区域缩放到 920×580 的框内,说话者会水平压扁,用户会拒绝输出。选择与源宽高比匹配的目标尺寸,或使用 force_original_aspect_ratio=decrease 加居中填充。
本文档中的其他所有内容都是工作示例或工具细节。以上三条是不可协商的硬性规则。违反其中任何一条都会导致输出被拒绝。