PPT Agent Skill

世界级 AI 演示文稿生成系统 · 把一句话变成 PPT 设计公司级别的成品

English · 快速开始 · 风格画廊 · 工作流 · 架构

对标 Linear · Anthropic · Stripe · Apple · NYT Magazine · Tom Ford · Pitch · Mercury · Vercel

_{26 个世界级风格 · 5 板块覆盖所有商业场景 · 真实 1280×720 标杆 mock}

💡 这是什么？

一个 Claude Code Skill，模拟万元/页 PPT 设计公司的完整工作流，把一句话变成专业级演示文稿（HTML + 可编辑矢量 PPTX）。

不是"给个大纲套模板"，而是先调研后生成 / 内容驱动版式 / 全局风格一致 / 真实数据填充的完整管线。

每个风格的视觉水准对标实际世界级品牌的官网/产品页排版做法（不是参考截图，是参考实际 CSS 实现）：字距铁律 / tabular-nums / OpenType 特性 / serif italic 混排 / 字体栈三层降级。

🎨 核心特性

🚀 快速开始

作为 Claude Code Skill 调用（推荐）：

你：帮我做一个关于 X 的 PPT
  ↓
Agent 提问调研需求（等你回复 7 题）
  ↓
自动搜索资料 → 生成大纲 → 策划稿 → 逐页设计 HTML
  ↓
自动后处理：HTML → SVG → PPTX
  ↓
全部产物保存到 ppt-output/

触发示例：

环境依赖：

# Python 依赖
pip install python-pptx lxml Pillow

# Node.js >= 18，puppeteer 在首次 html2svg.py 运行时自动安装

🎨 26 风格预览画廊

5 个板块，覆盖所有典型商业场景。每个 mock 都是真实 1280×720 设计稿：

暗色专业（7 风格 · references/styles/dark.md）

Linear / Apple Hardware / Tom Ford / Cyberpunk 2077 / Y2K / Magnum 等品牌的实际排版做法

浅色高级（8 风格 · references/styles/light.md）

Apple / Anthropic / NYT Magazine / iOS 26 / Mayo Clinic / Suisse Int'l / 婚礼请柬

活力鲜明（4 风格 · references/styles/vibrant.md）

东方文化（3 风格 · references/styles/cultural.md）

自然/复古（4 风格 · references/styles/natural.md）

📈 18 种数据可视化

全部纯 HTML/CSS/SVG 实现，无 JS 运行时（保证 svg2pptx 管线兼容）。所有图表自动适配 26 风格的 CSS 变量。

🔧 工作流

┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐
│  Step 1      │  │  Step 2      │  │  Step 3      │  │  Step 4      │  │  Step 5      │  │  Step 6      │
│  需求调研    │→ │  资料搜集    │→ │  大纲策划    │→ │  策划稿      │→ │  风格+设计稿 │→ │  后处理      │
│              │  │              │  │              │  │              │  │              │  │              │
│  7 题三层    │  │  3-15 查询   │  │  金字塔原理  │  │  Bento Grid  │  │  26 风格选 1 │  │  HTML→SVG    │
│  递进访谈    │  │  自适应      │  │  + 自检      │  │  策划卡      │  │  + 智能配图  │  │  →PPTX       │
└──────────────┘  └──────────────┘  └──────────────┘  └──────────────┘  └──────────────┘  └──────────────┘
   STOP 等回复                                            建议等确认           按 Part 分批         自动执行

详细流程见 SKILL.md。

🏗 系统架构

_{3 层架构：用户入口 / 6 步 Pipeline / 输出产物 · 5 大 Reference Library 注入到各步}

3 层架构：

• TIER 1 · 入口 — 用户一句话 prompt 触发 SKILL.md（Agent 入口主流程指令）；引用 references/ 下的所有规则文件
• TIER 2 · 6 步 Pipeline — 每步独立 STEP，前后用 JSON 合同传递；每步可见使用的 reference 文件
• TIER 3 · 输出 — 4 种最终产物：翻页 HTML / 矢量 SVG / 可编辑 PPTX / 风格预览画廊

Reference Library（注入到各步）：

📂 文件树

ppt-agent-skill/
├── SKILL.md                      # 主工作流指令（Agent 入口）
├── README.md / README_EN.md      # 本文件 / English
├── assets/                       # 视觉资产
│   ├── logo.svg                  # Logo
│   ├── banner.svg                # README 横幅
│   ├── hero-all.png              # 26 风格全景拼图
│   └── hero-<category>.png       # 5 板块单独拼图
├── references/                   # Skill 引用文档
│   ├── prompts.md                # 5 套 Prompt 模板（调研/大纲/策划/设计/备注）
│   ├── typography.md             # 世界级排版铁律 14 条
│   ├── bento-grid.md             # 7 种布局规格 + 卡片类型
│   ├── pipeline-compat.md        # HTML→SVG→PPTX 管线兼容规则
│   ├── method.md                 # 核心方法论
│   ├── style-system.md           # 引导文件（兼容旧引用）
│   ├── styles/                   # 26 风格按 5 板块分目录
│   │   ├── index.md              # 索引 + 决策矩阵 + JSON Schema
│   │   ├── dark.md               # 7 暗色专业
│   │   ├── light.md              # 8 浅色高级
│   │   ├── vibrant.md            # 4 活力鲜明
│   │   ├── cultural.md           # 3 东方文化
│   │   └── natural.md            # 4 自然/复古
│   ├── charts/                   # 18 种图表
│   │   ├── index.md              # 决策矩阵
│   │   ├── basic.md              # 8 种基础
│   │   ├── advanced.md           # 6 种进阶
│   │   └── complex.md            # 4 种 ECharts 级
│   └── principles/
│       └── failure-modes.md      # 8 种 failure modes + 修复顺序
├── scripts/                      # 后处理 + 工具
│   ├── html_packager.py          # 多页 HTML → 翻页预览
│   ├── html2svg.py               # HTML → SVG（dom-to-svg, 文字可编辑）
│   ├── svg2pptx.py               # SVG → PPTX（OOXML 原生）
│   ├── gallery.py                # 生成 26 风格预览画廊 + 截图
│   ├── build_hero.py             # 生成 README hero 拼图
│   └── smoke_test.py             # 端到端测试 + pipeline-compat 扫描
├── ppt-output/
│   └── style-gallery/            # 26 个 1280×720 mock + 26 PNG + index.html
├── docs/superpowers/specs/       # 设计文档归档
└── tests/smoke-results/          # 测试报告归档

🧪 质量保证

# 风格 JSON 校验 + pipeline-compat 扫描 + 排版自检（26 风格）
python3 scripts/smoke_test.py --phase 1
# → 52 pass / 0 fail / 0 warn

# 端到端管线（HTML→SVG→PPTX，3 风格代表性测试）
python3 scripts/smoke_test.py --phase 5
# → 6 pass / 0 fail（preview.html + svg/*.svg + presentation.pptx 三种产物全部生成）

🌟 世界级标杆参照系

排版做法参考的实际品牌（不是看截图模仿，是阅读其官网 CSS）：

📄 设计文档

完整的世界级重做设计文档：docs/superpowers/specs/2026-05-10-world-class-redesign-design.md

包含：目标与动机 / 26 风格列表 / JSON Schema 升级 / 字体栈策略 / 排版铁律 / 图表系统设计 / 风格预览画廊 / 文件组织架构 / 向后兼容保证 / 5 阶段实施路线 / 成功标准 / 决策日志。

⭐ Star History

_{实时生成 · 由 star-history.com 提供 · 自动适配深色/浅色主题}

🤝 贡献

欢迎提 Issue / PR：

• 新增风格：在对应 references/styles/<category>.md 追加 JSON 定义 + 在 ppt-output/style-gallery/<id>.html 写 1280×720 mock
• 新增图表：在 references/charts/<level>.md 追加 HTML 模板
• 改进文档：欢迎 typo 修复、用法说明补充

提交前跑一下 python3 scripts/smoke_test.py 确保通过。

📜 许可证

MIT