# Ppt Forge

> PPT 制作全链路流水线：内容规划 → 风格定调 → Slide 制作 → 视觉审查 → 导出验证 → 交付。 Use when: 做 PPT、做演示文稿、做 slide、做海报、PPT review、视觉审查。 Not for: 纯代码开发（用 worktree/tdd）、纯文档写作（直接写）。 Output: 高密度 HTML slide + 视觉审查通过 + 导出验证 + PPTX/PDF 可选。

- Skill: `ttttstc/ppt-forge` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add ttttstc/ppt-forge`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ttttstc/ppt-forge/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: ttttstc (https://skillmd.com/u/ttttstc)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ttttstc/ppt-forge

---


# PPT Forge — 演示文稿生产线

## 核心原则

**PPT 制作是一个结构化流水线，每个阶段有明确的输入、输出和验收标准。**

| 阶段 | 主导 | 职责 |
|------|------|------|
| Planning | **Author** | 内容规划、页型选择、证据源整理 |
| Style | **Author** + **Review** | 风格定调、核心页 CSS 基线 |
| Authoring | **Author** | HTML slide 批量制作 |
| Review | **Layout Review** + **Brand Review** | 布局/信息审查 + 品牌/审美审查 |
| Export | **Author** | 导出验证、格式检查 |
| Delivery | **Author** | 预览交付、文件归档 |

## 开局参数（必须声明）

制作前必须先锁定以下参数，作为后续所有阶段的标准依据：

| 参数 | 说明 | 示例 |
|------|------|------|
| **输出格式** | 单文件完整版还是分页 | **HTML 单文件** / **PPTX 单文件** / 分页 HTML |
| 页型（archetype） | 决定密度、字号矩阵和信息组织方式 | 战略总览 / 数据洞察 / 方案对比 / 汇报页 |
| 品牌 | 对标公司的视觉基因 | 华为 / Apple / 阿里 / 通用 |
| 受众 | 谁看这个 PPT | CTO / 投资人 / 技术团队 / 客户 |
| 场景 | PPT 用在哪 | 年会汇报 / 客户提案 / 内部分享 / 产品发布 |
| 主观看模式 | 影响字号/密度/留白标准 | presentation（大屏投影）/ document（PDF 阅读） |

**没有开局参数 = 开工和审查都没有标准。开局前必须先锁这 6 项。**

## 场景路由

| 触发 | 场景 | 主导 | 详细文档 |
|------|------|------|---------|
| 用户说"做个 PPT" | **P: 内容规划** | Author | refs/ppt-slide-authoring.md（规划部分） |
| 大纲确认 | **S: 风格定调** | Author 做 + Review 审 | refs/ppt-style-tile.md |
| 风格确认 | **A: Slide 批量制作** | Author | refs/ppt-slide-authoring.md |
| Slide 做完 | **R: 视觉审查** | Layout Review (D1) + Brand Review (D2) | refs/ppt-visual-review.md |
| 审查通过 | **E: 导出/组装** | Author | refs/ppt-delivery.md |
| 导出验证通过 | **D: 交付** | Author | refs/ppt-delivery.md |
| 需要对比竞品 | **B: Benchmark 对拍** | Author | refs/ppt-visual-review.md |
| 用户不满意 / 连续 2 轮 P1>0 | **Reset: 翻盘重来** | — | 回到 P 阶段重新规划 |

## 场景详解

### P: 内容规划

- 先锁：`archetype / 品牌 / 受众 / 场景 / 主观看模式`
- 至少产出：`本次 PPT 的一句话目标 + 证据源列表 + 页面结构草图`
- 没说清"这页让人看完要得出什么结论" → 不进 A 阶段

### S: 风格定调

- 先做 1-2 张核心页（封面 + 最复杂内容页）
- 提取 CSS 变量（品牌色/字号/间距/圆角）
- Review 确认风格后，Author 按 CSS 变量批量制作

### A: Slide 批量制作

- 按 archetype 选模板
- 密度驱动：每页至少 3 种填充手段
- 完成后自检截图 + 密度数据

### R: 视觉审查

详见 refs/ppt-visual-review.md

- D1 Layout Review：布局/信息审查（P1 级问题）
- D2 Brand Review：审美/品牌审查（P2 级问题）
- 必须有 6 件套输入包才能提审

### E: 导出验证

- 检查：native text / native chart / native table / screenshot fallback / repair dialog
- 任何一项有问题 → 不进 D

### D: 交付

详见 refs/ppt-delivery.md

- 必须用 browser-preview 打开预览
- 交付物：HTML 预览 + 截图 + PPTX/PDF（如需要）
- 等用户确认后才能结束

## 视觉审查 6 件套

每次发起视觉审查，必须附带：

1. **品牌+受众 brief** — "华为风格，受众 CTO，1 页讲清 moat"
2. **页型（archetype）+ 主观看模式** — 防止 reviewer 把页面改型
3. **本页目的** — 一句话说清这页要达成什么
4. **截图/预览 URL** — 渲染结果
5. **HTML/CSS 源码** — 定位布局 bug 用
6. **密度数据** — whitespace%、element count、overflow

> 没有 6 件套 = 观感点评；有 6 件套 = P1/P2 级审查。

## 审查维度速查

### D1: 布局/信息审查（Layout Review）

| 级别 | 维度 | 判定 |
|------|------|------|
| P1 | 布局 bug | 真实 CSS/HTML 错误 |
| P1 | 信息失败 | 没讲清重点 / 层级错 / 受众看不懂 |
| P1 | 密度失衡 | 该密不密 / 该疏不疏 |

### D2: 品牌/审美审查（Brand Review）

| 级别 | 维度 | 判定 |
|------|------|------|
| P2 | 品牌偏移 | 不像目标公司的设计语言 |
| P2 | 视觉一致性 | 字号/卡片/边框/图标语言不统一 |

审美五维：色彩体系 · 字体排印 · 空间网格 · 视觉元素 · 密度平衡

## 密度填充手法

详见 refs/ppt-density-playbook.md

## 交付物清单

根据开局参数的**输出格式**，生成对应单文件：

| 格式 | 说明 | 文件特征 |
|------|------|---------|
| **HTML 单文件** | 完整 PPT，所有 slide 内嵌在一个 HTML 中 | `*.html`，可用浏览器直接打开，支持翻页 |
| **PPTX 单文件** | 完整 PPT，所有 slide 内嵌在一个 PPTX 中 | `*.pptx`，可用 PowerPoint/WPS 直接打开 |
| 分页 HTML | 每个 slide 一个文件 | `01.html`, `02.html`...（仅用于审查阶段） |

**默认输出：HTML 单文件**。用户明确要求 .pptx 时生成 PPTX 版本。

## Common Mistakes

| 错误 | 后果 | 修复 |
|------|------|------|
| 没声明开局参数 | 开工和审查没有标准 | 开工前锁 6 参数（含输出格式） |
| 20 页全做完才审 | 返工成本爆炸 | S 阶段：先做 1-2 页核心页定调 |
| 自己说"没问题"不截图 | 布局 bug 漏检 | 自检必须截图看一遍再交活 |
| 审查只给截图没给 HTML | 只能说"这里怪" | 必须带 6 件套 |
| 生成多个 HTML 而非单文件 | 用户需要逐个打开 | E 阶段必须组装为 reveal.js 单文件 |
| PPTX 字号没换算 | 文字太小不可读 | CSS_px × 0.75 = PPTX_pt |
| 跳过 Export Gate | 导出后不可编辑/乱码 | 独立验证导出质量 |

## 品牌模板

品牌模板是特定公司的视觉规范预设，选择品牌后自动应用对应规范：

| 品牌 | 模板路径 | 特征 |
|------|---------|------|
| 华为 | refs/huawei/template.md | 红/黑/灰、直角体系、高密度 |
| Apple | （待扩展） | 极简、大量留白 |
| 阿里 | （待扩展） | 橙/科技蓝、Dashboard |
| 通用 | — | 可配置，根据 brief 调整 |

**使用**：开局参数选择品牌后 → S 阶段风格定调时使用对应模板的 CSS 变量

## 参考文档

| 文档 | 内容 |
|------|------|
| refs/ppt-style-tile.md | 风格定调详细流程 |
| refs/ppt-slide-authoring.md | HTML 制作规范 |
| refs/ppt-visual-review.md | 视觉审查 Gate |
| refs/ppt-delivery.md | 交付流程 |
| refs/ppt-density-playbook.md | 密度填充手册 |
| refs/huawei/template.md | 华为品牌模板 |
| refs/huawei/huawei-brand.md | 华为视觉规范 |
| refs/huawei/huawei-archetypes.md | 华为页型模板 |
| refs/huawei/huawei-density-rules.md | 华为密度标准 |