yuv-decks

yuv-decks — 构建 Yuval Avidani 风格的电影感演示文稿

这是基于 open-slide 构建演讲演示文稿的观点鲜明的操作手册。内容包括：

• Yuval 风格——通俗易懂、不用术语、以故事驱动
• 四幕叙事弧线——登机 → 爬升 → 巡航 → 下降
• JourneyBar——贯穿每张幻灯片的统一视觉元素
• 配套技能编排——yuv-design-system、slide-authoring、nano-banana-pro、hyperframes、mermaid

视觉配色取自 yuv-design-system 的 Decks 模式——Fly High 紫色／黄色／灰色（专为基于幻灯片的输出准备的配色方案）。如果演讲的核心隐喻就是字面意义上的飞行，此技能自带的 cinematic-flight 可选模式（天蓝色 + 亮粉色）会覆盖设计系统的 Decks 令牌——请参阅第 5 步。幻灯片绝不可使用 Neon 模式；Decks 模式专用于演示文稿。

此技能凝练了为 NICE 预黑客松（2026 年 5 月）制作“Build Agents That Ship”的经验。起草任何幻灯片之前，请从头到尾读完本文。

此技能在 YUV.AI 金字塔中的位置

yuv-decks 位于 YUV.AI 技能金字塔的中间层。当用户需要幻灯片演示文稿时，顶层编排器 yuv-pilot 会将任务路由到此处。用户不经过 yuv-pilot，直接说“帮我做一份演示文稿”时，也可以直接调用此技能。

调用 yuv-design-system 时，必须将模式锁定为“Decks”——绝不可让它回退到 Neon（网页／应用配色）或 Warm Editorial。Decks 模式是幻灯片唯一可用的配色模式。

完整的金字塔地图和路由表请参阅 yuv-pilot/SKILL.md。

参考实现：https://github.com/hoodini/build-agents-that-ship（私有——如有权限，请克隆；此技能描述的整套模式都已在其中实现）。

---

此技能基于什么构建

yuv-decks 是观点鲜明的扩展层。它明确委托以下技能负责：

技能	负责内容	何时查阅
yuv-design-system	配色、排版、动画库、品牌资源、标志性组件（PurpleBar、YellowUnderline、FlightHUD、CompassDial、CounterUp、HeroBg）、规范的社交链接、Hyperframes 模式	始终查阅。第 5 步、第 6 步，以及任何涉及配色／排版／组件的操作。
slide-authoring	Open-slide 文件规范、1920×1080 画布、默认字号比例、垂直空间预算计算、资源路径、框架硬性规则	编写每页 JSX 时（从第 6 步开始）。
create-slide	通用 open-slide 编写工具（会提出范围界定问题并选择主题）	用于非 Yuval 风格的演示文稿（其他人的内容、通用内容）。对于 Yuval 的标志性演讲风格，yuv-decks 优先于此工具。

yuv-decks 规则是在 yuv-design-system 和 slide-authoring 的基础上叠加的，绝不会覆盖它们。

---

何时调用此技能

用户需要制作演讲或演示文稿。触发语句包括：

• “帮我做一份关于 X 的演示文稿”
• “为关于 Y 的演讲制作幻灯片”
• “为 [公司] 黑客松制作演示文稿”
• “我要做关于 Z 的演讲——帮我制作幻灯片”
• “מצגת על...” / “שקפים על...” / “דק על...”

不要用于：单页落地页、视频、文档、Google Slide PowerPoint 导出。本技能适用于以 1920×1080 渲染并带有电影感动态效果的open-slide React 演示文稿。

---

第 0 步——初始化项目

默认保存位置： ~/Documents/yuv-projects/decks/<deck-slug>/——始终将演示文稿保存在此处，以便日后再次找到。技能会在父目录不存在时创建该目录。只有用户明确要求其他位置时才覆盖此默认设置。

# Pick a slug. Lowercase, hyphenated, descriptive.
mkdir -p ~/Documents/yuv-projects/decks
cd ~/Documents/yuv-projects/decks
npx @open-slide/cli init <deck-slug>
cd <deck-slug>
npm install
npm run dev   # starts the preview at http://localhost:5173

最终路径：~/Documents/yuv-projects/decks/<deck-slug>/。每次会话结束时，告知用户演示文稿所在位置。

脚手架会创建 slides/getting-started/（演示示例）。你将在 slides/<deck-id>/index.tsx 下创建自己的幻灯片，并删除或忽略该示例。

第 1 步——明确演示文稿范围（写作前先询问）

开始起草前，通过一次 AskUserQuestion（多问题表单）敲定以下四项：

1. 主题与受众——这份演示文稿的用途是什么？现场有哪些人？尽可能了解客户的实际议程（他们希望听到的具体要点），并逐条对应。
2. 页数——简短（5–6 页）、标准（8–10 页）、深入探讨（12–24 页）。
3. 语言——英语／希伯来语／双语。Yuval 会双语；根据受众选择。
4. 演讲者背景——Yuval 是演讲者吗？这是为某家特定公司准备的吗（NICE 等）？了解主办方后，才能设计呼应现场的内容（“……没错，就是你们现在所在的这家公司……”）。
5. 视觉模式——Fly High（默认紫色）或 cinematic-flight（天蓝色 + 亮粉色，仅当演讲的核心比喻确实是飞行时使用）。拿不准时，选 Fly High。

不要跳过这一步。之后制作过程中出现的每次方向调整，追根溯源都是这里的假设不对。

---

第 2 步——Yuval 风格（不可妥协的规则）

所有文案都遵循以下三条规则：

规则 1——使用白话，杜绝术语

把每个非日常用语都换掉：

不要说	换成
EBIT	实际利润
PoC	原型／演示阶段
BYOC	你自己的云
service-account-as-god	admin-token-for-everything
RAG	回答前先查找
fine-tuning	用你的数据训练模型
vLLM	本地 LLM 运行器

如果必须保留某个名称（LiteLLM、Bedrock、Anthropic、Cognigy），就保留，但要在首次提及时用 3 个词解释（“LiteLLM——AI 网关库”）。

规则 2——句子要短。片段要有力。就像这样。

每个要点最多 8–12 个词。删掉所有“因此／所以／然而”。如果一个句子换行后占了 3 行，就拆开或缩短。

校准测试——起草前，先改写下面这段：

❌ “Watson 给出错误建议时，没有从中吸取任何教训。同样的错误，年复一年地重复。这个系统从未在使用中得到改进。”

✅ “Watson 犯了错。Watson 一错再错。持续多年。”

规则 3——首次提及时解释每个名称

“Watson 是 IBM 的 AI。2011 年赢得了 Jeopardy。之后转向医疗领域。” “Klarna 是瑞典最大的金融科技公司——先买后付，拥有 1.5 亿客户。”

永远不要假设受众知道某人或某物是什么。

---

第 3 步——叙事弧线（4 幕）

能打动不同受众的结构：

ACT I · BOARDING — The Stakes              (slides 1–4)
  Cover · Hook stat · Sources agree · Failure patterns

ACT II · ASCENT — The Stories              (slides 5–9)
  Failure case story · Why it failed (4 bullets) ·
  Success case story · Why it worked (4 bullets) ·
  Reference example (real product the audience knows)

ACT III · CRUISE — The Build               (slides 10–22)
  Anatomy · Agent types · MCP · Multi-agent · Where to apply ·
  Client stack · Server infra · Gateway · Routing · Tracking ·
  Optimization · Evals · MVP → Production

ACT IV · DESCENT — The Action              (slides 23–24)
  How to start tomorrow · Closing

结构规则：

• 案例研究要集中安排（第 5–9 页）。不要和注意事项交错。
• 每个案例研究分 两页：故事 + 经验教训（4 个具体的失败点或成功做法）。经验教训页是“恍然大悟”的关键所在。
• 先讲故事，再讲注意事项。受众需要先知道为什么重要，再了解怎么做。
• 删除客户议程中没有的所有内容——即使你很喜欢它。（NICE 演示文稿中删掉的示例：ROI 计算、管理层推介、技能与 Agent 与功能与产品的比较、过时性检查。）

第 4 步 — 案例三联组（失败 + 成功 + 参考案例）

始终以三个真实、公开、可核实的故事为锚点：

角色	内容	NICE 演示文稿中使用的示例
失败	资金最充足、最受关注，却最终失败的 AI／企业项目。指出具体失败之处。	IBM Watson Health（11 年投入 40 亿美元，帮助的患者数为 0）
有保留的成功	一个真实的成功案例，但后来不得不调整方向。说明取得成果也需要保持谦逊。	Klarna AI Assistant（取代了 700 名全职员工，之后又部分重新聘用）
参考案例	受众已经了解或正在使用的当前生产环境示例。加分项：承办演讲的公司。	NICE Cognigy（NICE 于 2024 年收购）

用于铺陈利害关系的可核实数据（请记住这些数据——它们真实且有出处）：

• MIT NANDA《State of AI in Business 2025》（2025 年 8 月）：95% 的生成式 AI 试点项目未能带来可衡量的损益影响。
• Gartner（2024 年年中预测）：到 2025 年底，30% 的生成式 AI 项目会在概念验证后被放弃。
• BCG《Build for the Future 2024》：只有 26% 的公司真正从 AI 中创造价值。
• McKinsey《State of AI 2024–2025》：每 4 家组织中，只有 1 家从生成式 AI 中获得实际利润。
• 关于 IBM Watson Health，请参阅 STAT News 和 University of Texas System Audit（2017 年）。
• Klarna 新闻稿（2024 年 2 月 27 日）及 Bloomberg／Fortune 的报道（2025 年 5 月）。

绝不要编造数据。 如果没有引文出处，就使用经验法则，不要引用带有虚假来源的数字。

---

第 5 步 — 视觉语言

演示文稿的所有配色、字体、标志性组件和动画默认设置均沿用 yuv-design-system。请先阅读以下章节：

• yuv-design-system §1 — 配色模式（默认使用 Fly High；品牌系列使用 Warm Editorial）
• yuv-design-system §2 — 字体排版（英文使用 Anton + Inter，希伯来语使用 Rubik + Assistant，默认字距为 0）
• yuv-design-system §6 — 标志性组件（PurpleBar、YellowUnderline、FlightHUD、CompassDial、CounterUp、HeroBg）
• yuv-design-system §7 — 动画默认设置及 Hyperframes 兼容性
• yuv-design-system §3 — 品牌素材（用于水印的 Logo 字标、用于介绍页的个人照片）

本技能只对演讲演示文稿的独特之处提出明确要求——叙事弧线、旅程指示器、电影感飞行可选模式，以及演示文稿专属的入场动画。其他所有内容：请查阅设计系统。

默认模式：Fly High（紫色）

所有演示文稿默认使用 Fly High。摘自 yuv-design-system §1：

:root {
  --yuv-purple:      #5E17EB;   /* act-slide backgrounds, vertical accent bars, journey trail */
  --yuv-purple-dark: #3D0DA8;
  --yuv-yellow:      #FFEC00;   /* loud accent only — never a background */
  --yuv-grey:        #F1F2F2;   /* content-slide background */
  --yuv-white:       #FFFFFF;
  --yuv-black:       #000000;
}

双背景规则（不可协商，摘自 yuv-design-system）：

• 章节页（封面、章节分隔页、重点数据页、结束页）——紫色背景、白色标题、大号 Anton 字体。
• 内容页（其他所有页面——信息、证据、列表）——浅灰色 #F1F2F2 背景、黑色标题。

不得使用第三种背景颜色。绝对不行。黄色是强调色，不能用作背景。

yuv-design-system §6 中的 <PurpleBar>、<YellowUnderline>、<FlightHUD> 组件是演示文稿的标志性视觉元素——请使用它们。

可选模式：cinematic-flight（天蓝色 + 亮粉色）

仅当演讲的核心隐喻就是字面意义上的飞行时才使用（即“Build Agents That Ship” NICE 演示文稿中，每张幻灯片都围绕飞行弧线展开）。大多数演讲应继续使用 Fly High。

const cinematicFlight = {
  bg: '#dceaf6',        // sky-blue base
  text: '#1a1814',      // charcoal
  accent: '#ff3b8a',    // hot pink — the trail color
  yellow: '#ffd76e',    // soft sun
  cloudWhite: '#ffffff',
  skyDeep: '#7ab0d4',
  warmGray: '#6b7a8a',
  red: '#c8403d',       // failure indicators
  green: '#2f7d4f',     // success indicators
  shadow: 'rgba(80, 120, 180, 0.20)',
  hairline: 'rgba(26, 60, 100, 0.18)',
};

在 cinematic-flight 模式下，将 JourneyBar 的轨迹颜色改为 --accent（亮粉色），并使用天蓝色作为章节页背景，而不是紫色。其他所有内容（Anton + Inter 字体排版、JourneyBar 结构、叙事弧线、语气规则、可复用模板）均保持不变。

JourneyBar——标志性的统一元素

这是 yuv-decks 最强大的统一元素，位于每张幻灯片的顶部边缘。

一条细虚线航线，从 DEPART · [host company] 延伸至 ARRIVE · [outcome]。随着演示文稿的推进，实线路径逐渐填充（使用当前调色板的强调色：Fly High 模式为紫色，cinematic-flight 模式为亮粉色）。一个小型 ✈ 飞机图标位于当前位置，并带有动态俯仰角：

• Act I 登机 → 90°（水平，滑行中）
• Act II 爬升 → 58°（机头上仰，爬升中）
• Act III 巡航 → 90°（水平，巡航中）
• Act IV 下降 → 115°（机头下俯，下降中）

三个终点圆点标记各幕的边界。进度条下方的阶段标签：II · ASCENT 2/4。

电影感背景（全幅 nano-banana）

除视频幻灯片外，每张幻灯片都使用一张不透明度为 100% 的全幅 nano-banana 图片，并包含：

• Ken Burns 平移动画（yuv-cinematic-pan，22s，scale 1.04 → 1.06，translateX ±12px）
• 定向骨白渐变（textZone: 'left' | 'right' | 'bottom'），确保文字所在区域清晰易读
• 浮于电影感图片之上的白色内容卡片

页面入场动画

@keyframes yuv-page-enter {
  0%   { opacity: 0; transform: scale(1.06); filter: blur(10px); }
  60%  { opacity: 1; }
  100% { opacity: 1; transform: scale(1); filter: blur(0); }
}

每张幻灯片都以 0.65s 的缩放和失焦效果入场，营造出电影剪辑般的感觉。

---

第 6 步——配套技能（何时调用哪些技能）

此技能负责协调其他技能。请在合适的时机调用它们：

技能	调用时机	功能
yuv-design-system	始终——第 5 步以及任何调色板、字体或组件决策	视觉品牌的权威来源。从这里获取调色板令牌、字体规则、标志性组件、品牌素材和社交链接页脚。
slide-authoring	第 6 步起——编写 JSX 时	开放式幻灯片的硬性规则：文件契约、1920×1080 画布、纵向空间预算计算、素材路径。
nano-banana-pro（或 anthropic-skills:nano-banana-2）	第 5 步之后——为每张重要幻灯片生成电影感主视觉／氛围图片	图像生成。使用下方的提示词模板。需要 GEMINI_API_KEY。
hyperframes	用于 4–5 个高影响力视频片段（封面开场、大数字揭晓、案例研究时间线、结尾点睛）	HTML/CSS/GSAP 视频合成 → 渲染为 MP4，并以 <video> 嵌入幻灯片。
mermaid-diagrams	当 SVG 过于繁重时，用于技术架构图	清晰的流程图／时序图。
Excalidraw MCP（create_view）	用于设计讨论期间向用户展示的聊天内实时手绘工作流图	交互式 Excalidraw 渲染。
video-edit / yuv-viral-video	演讲包含需要嵌入的预录自拍视频片段时	视频编辑流程。

nano-banana 提示词模板

两种风格——请匹配当前视觉模式。

Fly High 模式（默认）：

[Scene description — 1–2 sentences, 16:9 cinematic frame, single focal subject]

STYLE: Cinematic editorial poster, electric-optimism dev-keynote aesthetic.
Vibrant. Luminous. Deep purple (#5E17EB) primary tones, electric yellow (#FFEC00)
warm accent lighting, near-black (#000000) shadows, soft grey (#F1F2F2) negative
space. Sharp lighting contrast. Generous space for typography overlay.
Movie poster, not infographic. NO TEXT. NO LOGOS. NO READABLE LETTERS.

cinematic-flight 模式：

[Scene description — 1–2 sentences, 16:9 cinematic frame, single focal subject]

STYLE: Cinematic editorial poster meets aviation-noir aesthetic. Vibrant. Luminous.
Dark moody background with neon-glow accents. Hot pink (#ff3b8a) as primary luminous
accent, soft sun yellow (#ffe066) as warm glow, sky blue (#7ab0d4) deep tones,
charcoal (#1a1814) shadows. Sharp lighting contrast. Generous space for typography
overlay. Movie poster, not infographic. NO TEXT. NO LOGOS. NO READABLE LETTERS.

始终遵循：只有一个视觉主体（不能是蒙太奇），画面中要留出三分之一的空旷天空用于排版，并明确注明 NO-TEXT。

---

第 7 步——开放式幻灯片框架规则

所有开放式幻灯片框架规则都在 slide-authoring 中：

• 文件契约（export default [Page, …] satisfies Page[]）
• 1920×1080 画布，只能使用绝对 px 值
• 每个演示文稿只能有一个 index.tsx，素材放在 slides/<id>/assets/ 下
• 不得添加新依赖（仅使用 react + 标准 Web API）
• 纵向空间预算计算（每页必须适配 1080px——项目符号不得换行）
• 不得使用 overflow: auto

编写任何页面 JSX 之前，请从头到尾阅读 slide-authoring。yuv-decks 规则是在这些框架规则之上的补充；绝不会覆盖它们。

---

第 8 步——可复用模板（复制以下模式）

build-agents-that-ship 演示文稿包含 4 个可复用的组件模板。请将它们复制到新演示文稿中：

UseCase——包含药丸标签、标题、项目符号和指标卡片的考量页面

用于 Act III 考量部分的幻灯片（10–22）。双栏网格：左侧为文字，右侧为带偏移阴影的指标卡片。支持可选的 bgImage + cinematicBg，用于电影感视觉效果。

CaseStudy — 用于失败、成功和参考案例的故事弧线幻灯片

用于 3 个案例研究。顶部：状态标签 + 时段。大号公司名称。下方是标语（“Klarna 是瑞典最大的金融科技公司……”）。左侧有 4 行事实，右侧放图片或视频，另有关键时刻框、经验卡片和引用栏。

LessonsGrid —“为何失败／成功”模式的 4 卡布局

紧接每个案例研究之后使用。标题 + 2×2 网格中的 4 张编号卡片 + 彩色总结条（“记住这一点 · …”）。

JourneyBar — 每张幻灯片顶部的飞行路径指示条

统一视觉元素。绘制虚线完整路线、填充至当前百分比的实线路径（Fly High 中为紫色，cinematic-flight 中为亮粉色）、3 个终点圆点，以及角度随阶段变化的飞机图标。

AtmosphericBg — 带有 cinematic 模式的背景

<AtmosphericBg src={img} cinematic textZone="left" />

这些模板的完整源码位于参考仓库的 slides/claude-cowork-enterprise/index.tsx 中。原样复制，然后进行调整。

---

第 9 步 — 12 步构建工作流

1.  Get the customer's agenda (literal bullets). Map slides 1:1.
2.  Bootstrap: npx @open-slide/cli init <slug> && cd <slug> && npm install && npm run dev
3.  Ask the 5 scoping questions (Step 1). Lock in answers — including visual mode.
4.  Draft the 4-act outline (Step 3). Confirm with user before writing JSX.
5.  Write all slide components in a single index.tsx under slides/<deck-id>/.
    Use the reusable templates (UseCase, CaseStudy, LessonsGrid).
    Pull palette tokens + signature components from yuv-design-system.
6.  Add JourneyBar with PHASES matching your 4 acts.
7.  Invoke nano-banana-pro: generate ~10 cinematic atmospheric images
    (one per major slide, using the mode-appropriate prompt template).
    Save to slides/<deck-id>/assets/.
8.  Invoke hyperframes for 4–5 video moments (cover intro, hook reveal,
    case-study timelines, closing). Render to MP4, drop into assets/.
9.  Wire images and videos into slides. Use AtmosphericBg cinematic for
    images, full <video> for the dramatic moments.
10. Verify in browser: walk every slide. Check vertical budget. Check
    that no bullet wraps. Check that fonts loaded.
11. Iterate with the customer. EXPECT 5+ redirects. Don't fight them —
    each one improves the deck.
12. Push to a private GitHub repo BEFORE the talk so it survives a
    laptop failure. Include a README with clone-and-run instructions.

---

第 10 步 — 反模式（看起来不错却会失败的做法）

• ❌ 用除法公式计算 ROI → 用通俗语言表达（“是否物有所值？= 收回的价值 ÷ 花费的成本。”）
• ❌ 把“你应该自己构建吗？”写成 4 个要点 → 使用 2×2 象限矩阵（高／低用量 × 重复性／创造性）。可视化矩阵比文字清晰 10 倍。
• ❌ 在黑客松演示文稿中使用管理层推介幻灯片 → 删除。受众不匹配。
• ❌ 在非飞行隐喻主题的演讲中使用 cinematic-flight → 默认使用 Fly High 紫色。只有当字面意义上的飞行就是故事主线时，才使用 cinematic-flight。
• ❌ 每张幻灯片都用同一种模板 → 看起来统一，却很无聊。为每张幻灯片添加电影感背景，营造统一中有变化的效果。
• ❌ 向开发者受众引用虚构统计数据 → 改用经验法则，否则就完全删掉数字。
• ❌ 不加解释地抛出 EBIT、PoC、RAG、BYOC → 受众会在 30 秒内失去兴趣。
• ❌ “Watson 失败是因为不协调” → 太抽象。具体说明：“用教科书案例训练。真实患者并不在教科书里。”
• ❌ 会导致项目符号文本换行的布局 → 缩短文字或拆分内容。
• ❌ 用 overflow: auto 隐藏溢出内容 → 画布不会滚动。被裁切的内容就看不到了。
• ❌ 在一张幻灯片上堆叠多个 Anton 元素 → 参见 yuv-design-system §6“每张幻灯片／每个部分只用一个 Anton 元素”。

---

第 11 步 — DECK-PLAYBOOK.md 文件

完成脚手架搭建后，在项目根目录放入一个 DECK-PLAYBOOK.md，供演讲者添加个人笔记。手册的第 10 部分有意设为 TODO 检查清单，供演讲者在演讲后填写：

• 现场哪些内容效果好？
• 下次我会做哪些不同的调整？
• 有什么出乎我的意料？

每份演示文稿都会为下一份提供反馈。经过 10 场演讲后，手册会比演讲者的有意识记忆更加准确。

---

第 12 步 — 仓库结构（交付物）

<deck-slug>/
├── package.json               # @open-slide/core ^1.1.0
├── package-lock.json          # locks exact versions (commit this)
├── README.md                  # clone-and-run instructions
├── DECK-PLAYBOOK.md           # this skill, distilled for the speaker
├── AGENTS.md / CLAUDE.md      # symlinked open-slide rules + playbook link
├── open-slide.config.ts
├── slides/
│   └── <deck-id>/
│       ├── index.tsx          # ALL slides in one file (typically 22–24)
│       └── assets/            # *.mp4 (videos) + *.png (nano-banana images)
└── .gitignore                 # node_modules, .env*, .DS_Store

演讲前推送到一个私有 GitHub 仓库：

gh repo create <user>/<deck-slug> --private --source=. --remote=origin --push \
  --description "..."

---

参考实现

本技能介绍的具体模式已在以下项目中实现：

https://github.com/hoodini/build-agents-that-ship（私有仓库——如有访问权限，请克隆）

该仓库包含：

• 1 个 index.tsx 中的 24 张正式幻灯片（约 3000 行）
• 5 个由 HyperFrames 渲染的 MP4 视频
• 14 张 nano-banana 电影感背景图
• 可复用模板（UseCase、CaseStudy、LessonsGrid、JourneyBar、AtmosphericBg）
• 本技能源自的 DECK-PLAYBOOK.md

如不确定如何实现本技能描述的某种模式，请阅读该仓库中对应的文件。

收尾原则

演示文稿是为观众准备的，不是为演讲者准备的。

每一层打磨——声音、故事、视觉效果、动效——都是为了让观众感到自己正在经历一段旅程，明白这些经验教训由自己汲取，也感受到演讲者尊重他们的时间和智慧。

如果某张幻灯片通不过“它能否在观众心中点亮一个顿悟时刻”的测试，就删掉或重写。要好莱坞风格，不要企业风格。讲故事，不做总结。带来飞翔感，不要框框架架。