技能概述
Simple Deck 係一个单文件水平滑动 HTML deck 技能。从 simple-deck/assets/template.html 复制种子模板开始,种子内置 proven 嘅 iframe nav script(解决 5 个 iframe 导航 bug),然后从 references/layouts.md 粘贴幻灯片布局。不同于其他预设风格模板,Simple Deck 直接从项目嘅 DESIGN.md 读取 token,保证 deck 与项目品牌风格一致。
觸發關鍵字
- deck、slides、ppt、presentation、幻灯
- ppt 模板、slide deck、horizontal slide
什麼時候用
- 需要做一个 deck / 幻灯片
- deck 需要匹配项目品牌风格(DESIGN.md)
- pitch deck、产品概述、学习材料
- 唔需要杂志 aesthetic
- 用户只说「make me a deck」时嘅默认选择
使用方法
自然語言觸發
帮我做一个 6 页的 pitch deck
工作流程
- Pre-flight — 阅读
template.html(CSS + JS 完整),阅读layouts.md(8 种布局 + 主题节奏规则),阅读当前 PROJECT DESIGN.md 获取 token - 复制种子 — 复制
assets/template.html到项目根目录为index.html,替换 6 个:root变量为 DESIGN.md token - 决定节奏 — 写 slide rhythm(默认 6 页),例如:Cover → Problem → Big Stat → Three Points → Quote → Ask
- 粘贴布局 — 从
layouts.md复制匹配嘅<section>,填入真实内容 - 自检 — 运行 checklist.md(P0/P1/P2),确认主题节奏正确(无 3+ 同主题相邻)
- 输出 — 单文件 HTML,保持
data-screen-label标签
主题节奏规则
| 规则 | 说明 |
|---|---|
| 每个 slide 必须有主题 class | light、dark、hero light、hero dark |
| 无 3+ 同主题相邻 | 不超过连续 3 个相同主题 |
| 8+ 页必须有 hero dark 和 hero light | 确保节奏变化 |
| Display = serif | 通过 var(--font-display) 强制 serif 标题 |
Slide 数量建议
| 场景 | 数量 |
|---|---|
| Product overview / 闪电演讲(5-10 分钟) | 6 页 |
| Pitch deck(15 分钟) | 8-10 页 |
| Investor update(20-30 分钟) | 12-18 页 |
實際例子
例子 1:Pitch Deck
用户:「帮我做一个 8 页 pitch deck。」
确认节奏后(例如:Cover → Problem → Big Stat → Three Points → Dark → Quote → Before/After → Ask),读取 DESIGN.md token,复制种子模板,填入真实 pitch 内容。
例子 2:产品概述
用户:「做一个 6 页产品概述 PPT。」
用 simple-deck 生成品牌风格一致嘅产品 deck。
注意事項
- 必须提供 DESIGN.md — simple-deck 依赖项目设计系统
- 必须预先阅读
template.html和layouts.md - 唔好改写 nav script — 已 proven 稳定
- 唔好用
scrollIntoView()— 会破坏 iframe data-screen-label每页必须有- 无 filler / 无 lorem — 所有内容必须真实