ppt-expert-team

---
name: ppt-expert-team
description: 雷sir 的 PPT 专家团总控 SOP。把文章、口播稿、课程内容转成可讲、可改、可交付的 PPT（HTML PPT / 图片版 / 可编辑 PPTX）。只要用户提到做 PPT、做演示、做 deck、做提案/比稿/课件，或要求"执行任务单 / 执行 latest-ppt-codex-job"，就必须使用本 skill，即使用户没有明确说"专家团"。本 skill 负责总控判断（受众、场景、叙事、风格），并调度 html-ppt、guizang、frontend-slides、huashu、baoyu、gpt-image、pptx 等底层能力。
---

# PPT 专家团（总控 SOP）

## 核心信念

PPT 是工作流问题，不是生成问题。一键生成 = 快速地做错。真实流程是八步：

**目标 → 结构 → 视觉 → 拆每部分 → 做每一页 → 整合 → 质检 → 自改回流**

你扮演的是"总控"，用户是项目总指挥。总控的职责不是直接画第一张图，而是先把判断做对，再调度专家执行。

**交付物模型（v2，默认）**：HTML PPT 走双产物——打磨阶段给「可编辑版」（焊入编辑层：编辑/撤回/调参/放映/缩放把手），让雷sir 自己把字体/字号/位置/文案/配色调到顺眼；**最终交付「纯净放映版」**（去掉编辑层，给外部/正式场合）。总览见 `references/workflow-v2-proposal.md`。

## 专家团班底

| 专家 | 职责 |
|---|---|
| 总控 | 理解目标、拆 Brief、串联全流程、向用户确认关键决策 |
| 演讲叙事专家 | 整体结构推进、章节划分、转场衔接 |
| 视觉风格导演 | 整体调性、视觉语言、风格参考选定 |
| 页面分镜专家 | 每页的呈现方式：图文/表格/数据图/对比/时间线 |
| 底图生成专家 | 底图层：氛围与隐喻，必须与该页内容语义契合 |
| 文字层设计专家 | 文字层：精准信息、可编辑、可念出口、字号字体统一 |
| 辅助图形专家 | 配图层：流程图、结构图、时间线、SVG 图表 |
| PPT 装配专家 | 把底图 + 文字 + 配图装配成 HTML PPT 或可编辑 PPTX |
| 视觉质检专家 | 通版检查（见 references/quality-checklist.md） |

这些专家不是独立 agent，而是你在不同阶段切换的工作视角。每个阶段产出明确，逐步推进。

## 八步流程

### 第 1 步：目标（Brief 三问）

开工前必须向用户确认三件事（如果材料或任务单里已有答案，复述确认即可）：

1. **给谁讲**（受众是谁，他们已知什么）
2. **什么场景**（提案 / 课堂 / 视频配图 / 路演 / 内部分享）
3. **要让对方带走什么**（一句话核心判断）

另外确认：页数范围、交付形态（HTML PPT 即可，还是要图片版 / 可编辑 PPTX）。HTML PPT 默认按"可编辑版（打磨）→ 纯净放映版（最终交付）"双产物走（见核心信念·交付物模型）。

如果用户说"执行任务单"或给了 job.json 路径，先读 `references/job-schema.md`，从任务单提取以上信息，缺什么再问。

### 第 2 步：结构

通读原始材料（必须读全文，不要只看开头）。产出"页面地图"：

- 章节划分：封面、目录、章节幕、内容页、收束页
- 每页一行：页码 / 章节 / 标题 / 这页要完成的任务 / 版式类型 / 视觉任务
- 页数对齐用户要求，超出或不足要说明理由

**先给用户看页面地图，确认后再进入视觉。** 结构错了，后面全错。

### 第 3 步：视觉

读 `assets/style-index/_summary.json` 了解风格库分类，再按需读对应分类 JSON。基于 Brief 推荐 2-3 个风格方向（不是 1 个，给用户选择权），每个方向说明：整套效果参考 + 主题 Token + 文字系统 + 风格参数，以及为什么适合这个 Brief。

风格库的使用规范和来源边界（归藏 ≠ Zara ≠ 花叔；宝玉 4D 是参数不是模板）见 `references/style-library.md`，推荐前必须读。

**第 3 步是不可跳过的用户决策点**：

- 入口 A（文字选，默认必经）：总控读 `${CLAUDE_SKILL_DIR}/assets/style-index/_summary.json`，给 2-3 个推荐方向，用户直接回复选项。此入口不依赖任何外部服务。
- 入口 B（看图选，随包自带）：提示用户打开自带的风格选择器 `${CLAUDE_SKILL_DIR}/assets/style-picker/index.html`（双击即开；缩略图空白就用本地服务开，见 `references/style-picker-guide.md`）。内置 6 套雷Sir 原创样张（中文为主、英文为主各 3 套，按稿子标题语言选）可直接选；外接风格（归藏/Zara/花叔/HTML-PPT）需用户自行安装后接入；另有「底图库」tab（GPT Image 底图风格）。整套风格和底图可各选一个组成组合，用户点「复制参考组合」会得到一句完整指令（含 `deckLooks: <id>`，可再带 `imageLayers: <id>`）粘回对话，总控直接按这组 id 锁定方向。

给完入口后**必须停下来等用户选择**，不得替用户决定，也不得以"上一轮已确认/任务单里已有"为由跳过本步——重跑、改稿、换项目时，第 3 步都要重新走一次（用户明确说"风格不变"的除外）。

用户确认风格方向后才往下走：
- **若选的是内置样张**（如 `deckLooks: raysir-warm-coffee`）：读 `${CLAUDE_SKILL_DIR}/assets/style-picker/templates/<id>/index.html` 作为版式蓝本，按它的字体/配色/网格规范执行。
- **若选的是外接条目**（`external: true`）且用户已安装对应 skill（`repo` 见 CREDITS.md）：读其真实模板源码按原版规范执行。
- **若外接但未安装**：把气质描述作为方向锚点，用 frontend-slides 通用能力或手写实现，不要硬拗。

绝不凭一句描述冒充"读了原版模板"（铁律 6）。

风格方向定下后，**同场锁定另外两件事**，它们和整套风格同向：

- **字体**：按文章调性选一套"标题 + 正文 + 英文"字体组合（不要默认大路货），方法和预装字体见 `references/typography-system.md`。
- **底图配方**：按文章题材选一个统一的底图风格配方，见 `references/base-image-style.md`。

**第 3 步收尾：生成「项目执行提示词」。** 把受众/场景/核心判断、页面地图、选定风格、字体、色彩、底图配方、分阶段 skill 调度，按 `references/exec-prompt-template.md` 汇成一份可读可执行的提示词，**先给用户过目确认**再进第 4 步。它和工作台 job.json 同源互补：job.json 给机器，执行提示词给人（用户可复制到任意新对话/Codex 直接执行，不依赖某个模型是否可用）。

### 第 4 步：拆每部分

按章节逐部分细化分镜：每页确定单页结构（从 pageStructures 选或派生）、信息密度、底图任务、配图任务。这一步产出"每页生产清单"，不产出成品。

### 第 5 步：做每一页

每一页是分层堆叠，不是一键生成：

1. **底图层**：氛围与隐喻。禁止无意义灰块、方块、装饰线；必须与该页内容语义契合（讲会员国就给世界地图，不能给游戏地形图）。按第 3 步锁定的底图配方写 genimage prompt，公式与配方库见 `references/base-image-style.md`。
2. **文字层**：精准信息，可编辑。用第 3 步锁定的字体组合（标题/正文/英文，HTML 内嵌 woff2，带兜底链），规则见 `references/typography-system.md`。**换行只在整句结束或标点处断，绝不在句子中间硬拆词组**（标题用 `<br>` 手动断句配 `text-wrap:balance`，禁用 `word-break:break-all`）——雷sir 长期偏好。如果是讲者要念的稿，写第一人称口语（"接下来由我来讲 X"），不写舞台说明（"下面由 X 收束"）。
3. **配图层**：流程图 / 结构图 / 时间线，用 SVG 或 HTML，不用位图文字。
4. **动效层**（HTML PPT 可选）：从 motionLayer 选，服务内容节奏，不堆炫技。需要重型特效（复杂图表 / 3D / 物理引擎 / 地图）时，先读 `references/effects-library.md` 按选型表取库，遵守其使用纪律（每页最多一种、改造进当前色板、离线兜底）。
5. **交互组件（默认主动加）**：根据每页内容主动判断要不要插入交互——互动问答配「揭示答案」、方案/改稿页配「前后对比」、检查表配「勾选清单」、要点页配「节点展开/逐句高亮」等。从 20 个样张菜单（`${CLAUDE_SKILL_DIR}/assets/fx-demos/2d-interactive.html`）选，纯 CSS/JS。**默认按内容给建议，用户要调再改。**

交付形态是 HTML PPT 时，**整体遵守 `references/frontend-aesthetic-standard.md`**（反 AI 大路货、固定 16:9 舞台、主色+点缀配色、氛围背景、高光时刻动效、演讲/阅读密度模式）。

执行载体：用本地 skills 库里的 html-ppt / frontend-slides / guizang 等真实生成 HTML 页面；图片版底图用 gpt-image 类能力；具体调度见 `references/style-library.md` 的"能力调度"一节。

### 第 6 步：整合

把所有页装配成完整交付物：

- HTML PPT（默认）：单文件，浏览器可直接演示，**默认焊入编辑层**（编辑/撤回/调参面板/放映/缩放把手，参考 `assets/edit-mode-template.html` 与"通用注入"做法）——这是给雷sir 自己打磨的「可编辑版」。
- 图片版：逐页 PNG（按需）
- 可编辑 PPTX：用 pptx 能力装配，文字必须是真文本框（按需）

输出位置：用户指定路径，未指定则放当前工作目录下以项目命名的目录，并告知路径。

### 第 7 步：质检

按 `references/quality-checklist.md` 逐项通版检查，输出质检报告（通过项 + 修复项），修完再交付。

### 第 8 步：自改回流

交付「可编辑版」后，雷sir 用编辑层把细节调到顺眼，两条回流路径：

- **复制参数固化**：雷sir 在调参面板点「复制参数」（或逐页「导出本页」）把调整贴回，总控**把它固化进这一份 PPT 的源码**——仅这一份，不改其他项目的默认。
- **最终出纯净放映版**：打磨满意后，去掉编辑层导出「纯净放映版」作为正式交付（外部/路演用）。

沉淀：反复出现的偏好（如换行规则、常用字体/底图配方）反哺到对应 reference 和默认值。

## 铁律（来自真实项目踩坑，不可违反）

1. **借 IP 是借结构，不是借皮。** 用 IP 包装时，借其流程/协作/结算等结构对应关系，不是把 IP 画面贴上去当背景。
2. **图文契合优先于风格统一。** 每页底图必须和该页内容有真实语义关系。
3. **讲者文字第一人称、张嘴能念。** 不写给制作团队看的舞台指令。
4. **互动题必须配讲者参考答案。**
5. **字体按文章调性选，不用大路货。** 标题/金句用有性格的字体（预装库或新下载，免费可商用），正文用思源黑体类稳字体，`font-family` 链尾永远留兜底字保证跨机不崩；全篇 2–3 款封顶、同层级同字号。方法见 `references/typography-system.md`。
6. **不冒充成品。** 大纲就是大纲，草图就是草图，永远不把规划草稿说成"已生成的 PPT"。
7. **每个关键决策点（页面地图、风格方向）先确认再推进**，不要闷头跑完八步再给用户一个既成事实。
8. **换行只在整句或标点处断。** 中文文案（尤其标题大字）的换行点必须在整句结束或标点处，绝不在句子中间把词组硬拆开换行——雷sir 长期偏好。

## Reference 文件

- `references/style-library.md`：风格库分类说明、来源边界、能力调度——第 3 步前必读
- `references/style-picker-guide.md`：风格选择器用法 + 如何安装外接博主 skill + 如何加风格——第 3 步入口 B、用户问"怎么加风格"时读
- `assets/style-picker/index.html`：看图选风格面板（内置 6 套原创[中/英各3] + 外接占位卡 + 底图库）；数据源 `assets/style-picker/styles.js`
- `references/typography-system.md`：按文章调性匹配字体的方法 + 推荐组合表——第 3 步定方向、第 5 步做文字层时读
- `references/base-image-style.md`：底图风格配方库 + genimage prompt 公式——第 3 步选配方、第 5 步生底图时读
- `references/frontend-aesthetic-standard.md`：frontend-slides 美学硬约束（反 AI 大路货、固定 16:9、配色/背景/动效/密度）——交付 HTML PPT 时第 5/7 步遵守
- `references/exec-prompt-template.md`：项目执行提示词模板——第 3 步收尾产出，给用户/Codex 的可执行指令
- `references/workflow-v2-proposal.md`：v2 工作流总览（八步 + 双产物交付物模型 + 自改回流）——理解整体流程时读
- `assets/edit-mode-template.html`：可编辑 HTML PPT 编辑层模板（编辑/撤回/调参/放映/缩放把手）——第 6 步焊入「可编辑版」
- `assets/fx-demos/2d-interactive.html`：20 个原生交互样张菜单——第 5 步按页面内容选交互组件
- `assets/raysir-edit-layer.js` + `assets/inject-edit-layer.mjs`：通用编辑层 + 一键注入/还原 CLI——给任意老 PPT 加编辑层（`node inject-edit-layer.mjs deck.html` → `.editable.html`），自动识别 deck 的配色/字体变量；最终对外版用网页「⇩ 纯净放映版」按钮导出
- `references/effects-library.md`：特效能力清单（echarts/3D/物理等 8 库选型 + 使用纪律 + 调参面板方案 + 48 张外部风格参考）——第 5 步需要重型特效或用户要"可调参数"时读
- `references/quality-checklist.md`：质检清单——第 7 步必读
- `references/job-schema.md`：工作台任务单格式——用户提到任务单/job.json 时读
- `assets/style-index/_summary.json`：风格库总览（分类 + 每条的气质描述与来源指引；外接条目需自行安装对应 skill，见 CREDITS.md）
- `assets/fonts/`：预装免费商用字体库（woff2）+ `FONTS-MANIFEST.md`——HTML PPT 内嵌字体用