Back to search
ppt-agent
SkillGitHub
专业 PPT 演示文稿全流程 AI 生成助手。模拟顶级 PPT 设计公司的完整工作流(需求调研 -> 资料搜集 -> 大纲策划 -> 策划稿 -> 设计稿),输出高质量 HTML 格式演示文稿。当用户提到制作 PPT、做演示文稿、做 slides、做幻灯片、做汇报材料、做培训课件、做路演 deck、做产品介绍页面时触发此技能。即使用户只说"帮我做个关于 X 的介绍"或"我要给老板汇报 Y",只要暗示需要结构化的多页演示内容,都应该触发。也适用于用户说"帮我把这篇文档做成 PPT"、"把这个主题做成演示"等需要将内容转化为演示格式的场景。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked yesterday
Badge for your README
Markdown
[](/listings/akxan--ppt-agent-skill)HTML
<a href="/listings/akxan--ppt-agent-skill"><img src="/api/listings/akxan--ppt-agent-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 397 lines
- ---
- name: ppt-agent
- description: 专业 PPT 演示文稿全流程 AI 生成助手。模拟顶级 PPT 设计公司的完整工作流(需求调研 -> 资料搜集 -> 大纲策划 -> 策划稿 -> 设计稿),输出高质量 HTML 格式演示文稿。当用户提到制作 PPT、做演示文稿、做 slides、做幻灯片、做汇报材料、做培训课件、做路演 deck、做产品介绍页面时触发此技能。即使用户只说"帮我做个关于 X 的介绍"或"我要给老板汇报 Y",只要暗示需要结构化的多页演示内容,都应该触发。也适用于用户说"帮我把这篇文档做成 PPT"、"把这个主题做成演示"等需要将内容转化为演示格式的场景。
- ---
- # PPT Agent -- 专业演示文稿全流程生成
- ## 核心理念
- 模仿专业 PPT 设计公司(报价万元/页级别)的完整工作流,而非"给个大纲套模板":
- 1. **先调研后生成** -- 用真实数据填充内容,不凭空杜撰
- 2. **策划与设计分离** -- 先验证信息结构,再做视觉包装
- 3. **内容驱动版式** -- Bento Grid 卡片式布局,每页由内容决定版式
- 4. **全局风格一致** -- 先定风格再逐页生成,保证跨页统一
- 5. **智能配图** -- 利用图片生成能力为每页配插图(绝大多数环境都有此能力)
- ---
- ## 环境感知
- 开始工作前自省 agent 拥有的工具能力:
- | 能力 | 降级策略 |
- |------|---------|
- | **信息获取**(搜索/URL/文档/知识库) | 全部缺失 -> 依赖用户提供材料 |
- | **图片生成**(绝大多数环境都有) | 缺失 -> 纯 CSS 装饰替代 |
- | **文件输出** | 必须有 |
- | **脚本执行**(Python >= 3.9 / Node.js >= 18) | 缺失 -> 跳过 SVG 与 PPTX 导出,只交付 HTML |
- **原则**:检查实际可调用的工具列表,有什么用什么。
- ---
- ## 路径约定
- | 变量 | 含义 | 获取方式 |
- |------|------|---------|
- | `SKILL_DIR` | 本 SKILL.md 所在目录的绝对路径 | 即触发 Skill 时读取 SKILL.md 的目录 |
- | `OUTPUT_DIR` | 产物输出根目录 | 用户当前工作目录下的 `ppt-output/`(首次使用时 `mkdir -p` 创建) |
- 后续所有路径均基于这两个变量。
- ---
- ## 输入模式与复杂度判断
- ### 入口判断
- | 入口 | 示例 | 从哪步开始 |
- |------|------|-----------|
- | 纯主题 | "做一个 Dify 企业介绍 PPT" | Step 1 完整流程 |
- | 主题 + 需求 | "15 页 AI 安全 PPT,暗黑风" | Step 1(跳部分已知问题)|
- | 源材料 | "把这篇报告做成 PPT" | Step 1(材料为主)|
- | 已有大纲 | "我有大纲了,生成设计稿" | Step 4 或 5 |
- ### 跳步规则
- 跳过前置步骤时,必须补全对应依赖产物:
- | 起始步骤 | 缺失依赖 | 补全方式 |
- |---------|---------|---------|
- | Step 4 | 每页内容文本 | 先用 Prompt #3 为每页生成内容分配 |
- | Step 5 | 策划稿 JSON | 用户提供或先执行 Step 4 |
- ### 复杂度自适应
- | 规模 | 页数 | 调研 | 搜索 | 策划 | 生成 |
- |------|------|------|------|------|------|
- | **轻量** | <= 8 页 | 3 题精简版(场景+受众+补充信息) | 3-5 个查询 | Step 3 可与 Step 4 合并一步完成 | 逐页生成 |
- | **标准** | 9-18 页 | 完整 7 题 | 8-12 个查询 | 完整流程 | 按 Part 分批,每批 3-5 页 |
- | **大型** | > 18 页 | 完整 7 题 | 10-15 个查询 | 完整流程 | 按 Part 分批,每批 3-5 页,批间确认 |
- ---
- ## 6 步 Pipeline
- ### Step 1: 需求调研 [STOP -- 必须等用户回复]
- > **禁止跳过。** 无论主题多简单,都必须提问并等用户回复后才能继续。不替用户做决定。
- **执行**:使用 `references/prompts.md` Prompt #1
- 1. 搜索主题背景资料(3-5 条)
- 2. 根据复杂度选择完整 7 题或精简 3 题,一次性发给用户。环境提供结构化提问工具(如 `AskUserQuestion`)时优先使用,否则用分组清晰的文本问卷
- 3. **等待用户回复**(阻断点)
- 4. 整理为需求 JSON
- **7 题三层递进结构**(轻量模式只问第 1、2、7 题):
- | 层级 | 问题 | 决定什么 |
- |------|------|---------|
- | 场景层 | 1. 演示场景(现场/自阅/培训) | 信息密度和视觉风格 |
- | 场景层 | 2. 核心受众(动态生成画像) | 专业深度和说服策略 |
- | 场景层 | 3. 期望行动(决策/理解/执行/改变认知) | 内容编排的最终导向 |
- | 内容层 | 4. 叙事结构(问题->方案/科普/对比/时间线) | 大纲骨架逻辑 |
- | 内容层 | 5. 内容侧重(搜索结果动态生成,可多选) | 各 Part 主题权重 |
- | 内容层 | 6. 说服力要素(数据/案例/权威/方法,可多选) | 卡片内容类型偏好 |
- | 执行层 | 7. 补充信息(演讲人/品牌色/必含/必避/页数/配图偏好/**动画偏好**) | 具体执行细节 |
- **动画偏好**(第 7 题里问,默认 A):
- | 选项 | 含义 | Step 6 的参数 |
- |------|------|--------------|
- | A. 只要页间切换 | 翻页淡入,页内静态 | 默认,不加参数 |
- | B. 卡片逐张出现 | 每点一下出现一张卡片,适合现场讲解 | `--animate fade` |
- | C. 卡片自动依次出现 | 进入页面后自动播放,适合自动放映 | `--animate rise --animate-trigger auto` |
- | D. 不要任何动画 | 翻页也不要过渡 | `--transition none` |
- **产物**:需求 JSON(topic + requirements)-> `OUTPUT_DIR/requirements.json`
- ---
- ### Step 2: 资料搜集
- > 盘点所有信息获取能力,全部用上。
- **执行**:
- 1. 根据主题规划查询(数量参考复杂度表)
- 2. 用所有可用的信息获取工具并行搜索
- 3. 每组结果摘要总结
- **产物**:搜索结果集合 JSON
- ---
- ### Step 3: 大纲策划
- **执行**:使用 `references/prompts.md` Prompt #2(大纲架构师 v2.0)
- **方法论**:金字塔原理 -- 结论先行、以上统下、归类分组、逻辑递进
- **自检**:页数符合要求 / 每 part >= 2 页 / 要点有数据支撑
- **产物**:`[PPT_OUTLINE]` JSON -> `OUTPUT_DIR/outline.json`
- ---
- ### Step 4: 内容分配 + 策划稿 [建议等用户确认]
- > 将内容分配和策划稿生成合为一步。在思考每页应该放什么内容的同时,决定布局和卡片类型,更自然高效。
- **执行**:使用 `references/prompts.md` Prompt #3(内容分配与策划稿)
- **要点**:
- - 将搜索素材精准映射到每页
- - 为每页设计多层次内容结构(主卡片 40-100 字 + 数据亮点 + 辅助要点)
- - 同时确定 page_type / layout_hint / cards[] 结构
- - **内容页卡片数不少于版式容量**:单一焦点 >= 1、对称/非对称两栏 >= 2、其余版式 >= 3;卡片 >= 3 张时至少 2 种 card_type 且至少 1 张数据卡片
- - 布局选择参考 `references/bento-grid.md` 的决策矩阵;需要图表时在卡片上写 `chart_type`
- - 可用的版式、组件、图表、风格清单:`python3 SKILL_DIR/scripts/resource_loader.py menu`
- 向用户展示策划稿概览,建议等用户确认后再进入 Step 5。
- **产物**:每页策划卡 JSON 数组 -> `OUTPUT_DIR/planning.json`
- ---
- ### Step 5: 风格决策 + 设计稿生成
- 分三个子步骤,**顺序不可颠倒**:
- #### 5a. 风格决策
- **执行**:阅读 `references/styles/index.md`(含决策矩阵),按主题关键词匹配 26 种预置风格之一;都不合适时按同一 JSON 结构自定义(方法见 index.md "自定义风格")
- **26 风格按 5 板块分组**(完整 JSON 在板块文件中):
- | 板块 | 数量 | 风格 ID | 板块文件 |
- |------|------|--------|---------|
- | 暗色专业 | 7 | dark_tech / xiaomi_orange / luxury_purple / nocturne_violet / cyberpunk_neon / chrome_y2k / noir_film | `references/styles/dark.md` |
- | 浅色高级 | 8 | blue_white / fresh_green / minimal_gray / mocha_editorial / medical_pulse / earth_concrete / champagne_gold / liquid_glass | `references/styles/light.md` |
- | 活力鲜明 | 4 | vibrant_rainbow / kindergarten_pop / bauhaus_block / candy_pastel | `references/styles/vibrant.md` |
- | 东方文化 | 3 | royal_red / sakura_wabi / ink_jade | `references/styles/cultural.md` |
- | 自然/复古 | 4 | botanic_forest / safari_savanna / retro_70s / gov_authority | `references/styles/natural.md` |
- **风格预览**:`SKILL_DIR/ppt-output/style-gallery/index.html` 是 26 风格的卡片墙,用户拿不定主意时让其打开对比。
- **也必读**:`references/typography.md`(字距分级 / tabular-nums / OpenType / serif italic 混排 / 字体栈三层降级)
- **产物**:选定风格的完整 JSON -> `OUTPUT_DIR/style.json`
- #### 5b. 智能配图(根据用户偏好)
- > 在需求调研(Step 1 第 7 题)中确认用户的配图偏好后执行。如果用户选择"不需要配图"则跳过。
- 在生成每页 HTML **之前**,先为该页生成配图,保存到 `OUTPUT_DIR/images/`。封面页、章节封面必须有。
- **提示词构造公式**:`[内容主题] + [视觉风格] + [画面构图] + [技术约束]`
- | 维度 | 说明 | 示例 |
- |------|------|------|
- | 内容主题 | 从该页策划稿的核心概念提炼,具体到场景/对象 | "DMSO molecular purification process, crystallization flask with clear liquid" |
- | 视觉风格 | 与 style.json 的 `mood_keywords` 和配色对齐 | 暗黑科技 -> "deep blue dark tech background, subtle cyan glow, futuristic" |
- | 画面构图 | 根据图片在页面中的放置方式决定 | 右侧渐隐 -> "clean composition, main subject on left, fade to transparent on right" |
- | 技术约束 | 固定后缀 | "no text, no watermark, high quality, professional illustration" |
- **按页面类型追加关键词**:
- | 页面类型 | 图片特征 | 追加关键词 |
- |---------|---------|-----------|
- | 封面页 | 主题概览,视觉冲击 | "hero image, wide composition, dramatic lighting" |
- | 章节封面 | 该章主题的象征性视觉 | "symbolic, conceptual, centered composition" |
- | 内容页 | 辅助说明,不喧宾夺主 | "supporting illustration, subtle, background-suitable" |
- | 数据页 | 抽象数据可视化氛围 | "abstract data visualization, flowing lines, tech" |
- **禁止**:图片中出现文字 / 与页面配色冲突(暗色主题配暗色图,亮色主题配亮色图)/ 与内容无关的装饰图 / 多页重复使用同一 prompt。
- **产物**:`OUTPUT_DIR/images/` 下的配图文件
- #### 5c. 逐页 HTML 设计稿生成
- **执行**:使用 `references/prompts.md` Prompt #4 + `references/bento-grid.md`
- > **禁止跳过策划稿直接生成。** 每页必须先有 Step 4 的结构 JSON。
- **每页 Prompt 组装公式**:
- ```
- Prompt #4 模板
- + 风格定义 JSON(5a 产物)[必须]
- + 该页策划稿 JSON(Step 4 产物)[必须]
- + 该页用到的版式/组件/图表说明 [按需,见下方"资源路由"]
- + 配图路径(5b 产物)[可选 -- 无配图时省略 IMAGE_INFO 块]
- ```
- **核心设计约束**(完整清单见 Prompt #4 与 `references/pipeline-compat.md`):
- - 画布 1280x720px,`overflow:hidden`,静态 HTML(不写 `<script>`、不写 CSS 动画)
- - 颜色通过标准 CSS 变量引用(`--bg-primary` / `--text-primary` / `--accent-1` ...),图表模板依赖这些变量名
- - 每张卡片的根节点写 `class="card"` 和 `data-card-id`,导出时据此成组、做入场动画
- - 文字不要用渐变填充、text-shadow 承载关键信息(转 PPTX 后退化);径向渐变、模糊光晕、遮罩等装饰可以放心用,导出时自动转成图层
- **分批策略**:按 Part 为单位分批生成,每批 3-5 页,写入 `OUTPUT_DIR/slides/`(文件名用零填充或 `slide-N.html` 均可,导出按自然顺序排序)。
- **跨页视觉叙事**:
- | 策略 | 规则 | 原因 |
- |------|------|------|
- | **密度交替** | 高密度页(混合网格/英雄式)后面跟低密度页(章节封面/单一焦点) | 连续 3+ 页高密度内容会导致视觉疲劳 |
- | **章节色彩递进** | Part 1 卡片主用 accent-1,Part 2 用 accent-2,依次轮换 | 通过颜色让受众无意识感知章节切换 |
- | **封面-结尾呼应** | 结束页的视觉元素与封面页形成呼应 | 首尾呼应给出完整闭环感 |
- | **渐进揭示** | 同一概念跨多页展开时,视觉复杂度递增 | 引导观众逐步深入理解 |
- **产物**:每页一个 HTML 文件 -> `OUTPUT_DIR/slides/`
- ---
- ### Step 6: 后处理 [必做 -- HTML 生成完后立即执行]
- > **禁止跳过。** 不要停在 HTML 就结束。
- ```
- slides/*.html --> preview.html --> svg/*.svg --> presentation.pptx
- ```
- **依赖**(首次运行):
- ```bash
- pip install python-pptx lxml Pillow
- # Node.js >= 18;puppeteer 与 dom-to-svg 在首次运行 html2svg.py 时自动装到 SKILL_DIR/node_modules
- ```
- **依次执行**:
- 1. **合并预览**(做了卡片动画时加上与步骤 3 相同的 `--animate` / `--animate-trigger`,浏览器里就能预览动效,用户没有 PowerPoint 也能看)
- ```bash
- python3 SKILL_DIR/scripts/html_packager.py OUTPUT_DIR/slides/ -o OUTPUT_DIR/preview.html
- ```
- 2. **SVG 转换**(文字保留为可编辑 `<text>`;dom-to-svg 画不出的效果自动截成图层)
- ```bash
- python3 SKILL_DIR/scripts/html2svg.py OUTPUT_DIR/slides/ -o OUTPUT_DIR/svg/
- ```
- 3. **PPTX 生成**(原生形状 + 可编辑文字;按 Step 1 的动画偏好加参数)
- ```bash
- python3 SKILL_DIR/scripts/svg2pptx.py OUTPUT_DIR/svg/ -o OUTPUT_DIR/presentation.pptx
- # 默认:页间淡入切换,页内静态
- # 卡片逐张出现: --animate fade
- # 卡片自动依次出现:--animate rise --animate-trigger auto
- # 不要任何动画: --transition none
- # 换切换效果: --transition push|wipe|cover|split|zoom|dissolve
- ```
- 4. **(可选)像素级保真版**:用户更看重"和预览一模一样"而不需要编辑时追加
- ```bash
- python3 SKILL_DIR/scripts/html2png.py OUTPUT_DIR/slides/ -o OUTPUT_DIR/png/
- python3 SKILL_DIR/scripts/png2pptx.py OUTPUT_DIR/png/ -o OUTPUT_DIR/presentation-hd.pptx
- ```
- 5. **通知用户** -- 告知产物位置和使用方式:
- - `preview.html` -- 浏览器打开,方向键翻页;带动画预览时点击画面或按 → 逐张出现卡片
- - `presentation.pptx` -- 文字与形状可直接编辑;卡片是组合,可整体移动
- - 字体:PPTX 默认映射到 Office 自带字体(Arial / Georgia / 微软雅黑等)。机器上装了设计字体时可加 `--fonts design` 重新导出
- - 做了动画时说明触发方式(点击 / 自动)
- **降级**:Node.js 不可用或依赖安装失败时,步骤 2-4 无法执行,只交付 `preview.html`,并告知用户装好 Node.js 后可重新运行。
- **产物**:preview.html + svg/*.svg + presentation.pptx
- ---
- ## 输出目录结构
- ```
- ppt-output/
- requirements.json # 需求
- outline.json # 大纲
- planning.json # 策划稿
- style.json # 风格定义
- images/ # AI 配图
- slides/ # 每页 HTML
- preview.html # 可翻页预览
- svg/ # 矢量 SVG
- presentation.pptx # 可编辑 PPTX(含切换/动画)
- png/ # 截图(可选)
- presentation-hd.pptx # 像素级保真版(可选)
- ```
- ---
- ## 质量自检
- | 维度 | 检查项 |
- |------|-------|
- | 内容 | 每页 >= 2 信息卡片 / >= 60% 内容页含数据 / 章节有递进 |
- | 视觉 | 全局风格一致 / 配图风格统一 / 卡片不重叠 / 文字不溢出 |
- | 技术 | 使用标准 CSS 变量 / 卡片带 `data-card-id` / 无 `<script>` 与 CSS 动画 / PPTX 能正常打开 |
- 按 `references/principles/failure-modes.md` 的修复顺序处理问题:先补内容,再调版式,最后才动装饰。
- ---
- ## 严格模式(可选)
- 需要更高的交付确定性时(大型 deck、交给他人二次编辑、批量生成),在对应步骤后运行校验脚本,把自检变成硬门槛。不运行也不影响出稿。
- | 时机 | 命令 | 拦什么 |
- |------|------|-------|
- | Step 3 后 | `python3 SKILL_DIR/scripts/validate.py outline OUTPUT_DIR/outline.json --pages 10-15` | part 少于 2 页、缺标题、页数不符 |
- | Step 4 后 | `python3 SKILL_DIR/scripts/validate.py planning OUTPUT_DIR/planning.json` | 卡片不足、类型单一、无数据卡片、枚举值写错、版式连续重复 |
- | Step 5a 后 | `python3 SKILL_DIR/scripts/validate.py style OUTPUT_DIR/style.json` | 生成不出 CSS 变量的残缺风格 |
- | Step 5c 后 | `python3 SKILL_DIR/scripts/validate.py slides OUTPUT_DIR/slides --planning OUTPUT_DIR/planning.json` | 画布尺寸、`<script>`/动画、卡片缺失、会退化的 CSS |
- | Step 6 后 | `python3 SKILL_DIR/scripts/validate.py all OUTPUT_DIR` | 以上全部 + 截图空白页 + 产物数量 |
- 退出码 0 通过、1 有 ERROR;加 `--strict` 时 WARN 也算失败。规则与可选字段(`role` / `card_style` / `density_label`)见 `references/strict-mode.md`。
- ---
- ## 资源路由
- 策划稿字段决定 Step 5c 该读哪些参考文件。手动查表,或让脚本一次取齐:
- ```bash
- python3 SKILL_DIR/scripts/resource_loader.py resolve --planning OUTPUT_DIR/planning.json --page 3
- ```
- - 字段路由:`layout_hint→layouts/`、`page_type→page-templates/`、`card_type→blocks/`、`chart_type→charts/`
- | 字段 | 取值 | 路由到 |
- |------|------|-------|
- | `layout_hint` | single-focus / symmetric / asymmetric / three-column / primary-secondary / hero-top / mixed-grid / l-shape / t-shape / waterfall(也接受"主次结合"等中文叫法) | `references/layouts/<版式>.md` |
- | `page_type` | cover / toc / section / end(content 页没有模板) | `references/page-templates/<类型>.md` |
- | `card_type` | text / data / list / tag_cloud / process / data_highlight | `references/bento-grid.md` "6 种卡片内容类型" |
- | `card_type` | timeline / diagram / quote / comparison / people / image_hero / matrix_chart | `references/blocks/<组件>.md`(下划线换成连字符) |
- | `chart_type` | progress_bar / comparison_bar / ring / sparkline / waffle / kpi / metric_row / rating | `references/charts/basic.md` 对应小节 |
- | `chart_type` | radar / timeline / funnel / gauge / grouped_bar / simple_map | `references/charts/advanced.md` 对应小节 |
- | `chart_type` | world_choropleth / network_graph / sankey_flow / heatmap_calendar | `references/charts/complex.md` 对应小节 |
- | `card_style`(可选) | accent / elevated / filled / outline / glass / transparent | `references/blocks/card-styles.md` |
- ---
- ## Reference 文件索引
- | 文件 | 何时阅读 | 关键内容 |
- |------|---------|---------|
- | `references/prompts.md` | 每步生成前 | 5 套 Prompt 模板(调研/大纲/策划/设计/备注)|
- | `references/method.md` | 初次了解 | 核心理念与方法论 |
- | `references/bento-grid.md` | Step 4 / 5c | 7 种布局精确坐标 + 6 种卡片类型 + 决策矩阵 |
- | `references/styles/index.md` | **Step 5a** | 26 种预置风格索引 + 决策矩阵 + JSON 结构 + 自定义风格 |
- | `references/styles/{dark,light,vibrant,cultural,natural}.md` | Step 5a 选定风格后 | 该板块所有风格的完整 JSON |
- | `references/typography.md` | **Step 5c** | 排版铁律 14 条 |
- | `references/charts/index.md` | Step 4 / 5c 涉及数据可视化时 | 18 种图表索引 + 决策矩阵 |
- | `references/charts/{basic,advanced,complex}.md` | 选定图表后 | 完整 HTML 模板(基础 8 / 进阶 6 / 复杂 4)|
- | `references/layouts/*.md` | Step 5c,按 layout_hint | 10 种版式的重力结构与禁忌 |
- | `references/blocks/*.md` | Step 5c,按 card_type / card_style | 7 种组件原型 + card-styles |
- | `references/page-templates/*.md` | Step 5c,按 page_type | cover / toc / section / end |
- | `references/principles/*.md` | Step 4-5 自检 | 6 条设计原则 + failure-modes(8 种失败模式与修复顺序)|
- | `references/design-runtime/*.md` | Step 4 / 5c 进阶 | css-weapons(12 种 CSS 技法)/ data-type-visual-mapping(数据类型 -> 卡片/版式/图表)|
- | `references/pipeline-compat.md` | **Step 5c** | 哪些 CSS 保持矢量、哪些转图层、哪些会丢 |
- | `references/strict-mode.md` | 启用严格模式时 | 校验规则、可选字段、图审缺陷分级 |
- ## 维护
- 合同的单一真源是 `scripts/contracts.py`(页面类型、版式、卡片类型、图表注册表、风格字段、兼容规则)。新增风格、图表或改枚举后运行:
- ```bash
- python3 scripts/smoke_test.py # 风格 / mock / 图表 / 校验器 / 资源路由 / 文档引用
- python3 scripts/smoke_test.py --export # 追加真实导出管线(约 1 分钟,需 Node.js)
- ```
README.md · README · 352 lines
- <div align="center">
- <img src="assets/logo.svg" alt="PPT Agent Skill" width="120" />
- <h1>PPT Agent Skill</h1>
- <p><strong>世界级 AI 演示文稿生成系统</strong> · 把一句话变成 PPT 设计公司级别的成品</p>
- <p>
- <a href="README_EN.md">English</a> ·
- <a href="#-快速开始">快速开始</a> ·
- <a href="https://akxan.github.io/ppt-agent-skill/">在线画廊</a> ·
- <a href="#-26-风格预览画廊">风格画廊</a> ·
- <a href="#-工作流">工作流</a> ·
- <a href="#-架构">架构</a>
- </p>
- <p>
- <img src="https://img.shields.io/badge/styles-26-22D3EE?style=for-the-badge&labelColor=050b1f" alt="26 Styles" />
- <img src="https://img.shields.io/badge/charts-18-6366f1?style=for-the-badge&labelColor=050b1f" alt="18 Charts" />
- <img src="https://img.shields.io/badge/categories-5-FF9500?style=for-the-badge&labelColor=050b1f" alt="5 Categories" />
- <img src="https://img.shields.io/badge/pipeline-6_steps-22c55e?style=for-the-badge&labelColor=050b1f" alt="6-step Pipeline" />
- </p>
- <p>
- <a href="https://github.com/Akxan/ppt-agent-skill/stargazers"><img src="https://img.shields.io/github/stars/Akxan/ppt-agent-skill?style=for-the-badge&color=FFD700&labelColor=050b1f&logo=github&logoColor=white" alt="GitHub Stars" /></a>
- <a href="https://github.com/Akxan/ppt-agent-skill/network/members"><img src="https://img.shields.io/github/forks/Akxan/ppt-agent-skill?style=for-the-badge&color=22D3EE&labelColor=050b1f&logo=github&logoColor=white" alt="GitHub Forks" /></a>
- <a href="https://github.com/Akxan/ppt-agent-skill/watchers"><img src="https://img.shields.io/github/watchers/Akxan/ppt-agent-skill?style=for-the-badge&color=A855F7&labelColor=050b1f&logo=github&logoColor=white" alt="GitHub Watchers" /></a>
- <a href="https://github.com/Akxan/ppt-agent-skill/issues"><img src="https://img.shields.io/github/issues/Akxan/ppt-agent-skill?style=for-the-badge&color=22c55e&labelColor=050b1f&logo=github&logoColor=white" alt="Issues" /></a>
- </p>
- <p>
- <a href="LICENSE"><img src="https://img.shields.io/github/license/Akxan/ppt-agent-skill?style=flat-square&color=000" alt="MIT License" /></a>
- <img src="https://img.shields.io/github/last-commit/Akxan/ppt-agent-skill?style=flat-square&color=blue&logo=git&logoColor=white" alt="Last commit" />
- <img src="https://img.shields.io/github/repo-size/Akxan/ppt-agent-skill?style=flat-square&color=orange" alt="Repo size" />
- <img src="https://img.shields.io/github/languages/top/Akxan/ppt-agent-skill?style=flat-square&color=8b5cf6" alt="Top language" />
- <img src="https://img.shields.io/badge/python-≥3.9-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python" />
- <img src="https://img.shields.io/badge/node-≥18-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node" />
- <img src="https://img.shields.io/badge/PPTX-editable-D24726?style=flat-square&logo=microsoftpowerpoint&logoColor=white" alt="PPTX" />
- <img src="https://img.shields.io/badge/Claude%20Code-skill-D97757?style=flat-square" alt="Claude Code Skill" />
- </p>
- <p>
- <strong>对标</strong>
- <code>Linear</code> · <code>Anthropic</code> · <code>Stripe</code> · <code>Apple</code> · <code>NYT Magazine</code> · <code>Tom Ford</code> · <code>Pitch</code> · <code>Mercury</code> · <code>Vercel</code>
- </p>
- </div>
- ---
- <div align="center">
- <img src="assets/hero-all.png" alt="26 风格预览" width="100%" />
- <p><sub>26 个世界级风格 · 5 板块覆盖所有商业场景 · 真实 1280×720 标杆 mock</sub></p>
- </div>
- ---
- ## 💡 这是什么?
- 一个 **Claude Code Skill**,模拟万元/页 PPT 设计公司的完整工作流,把一句话变成专业级演示文稿(HTML 预览 + 带切换动画的可编辑 PPTX)。
- 不是"给个大纲套模板",而是**先调研后生成 / 内容驱动版式 / 全局风格一致 / 真实数据填充**的完整管线。
- 每个风格的视觉水准对标实际世界级品牌的官网/产品页排版做法(**不是参考截图,是参考实际 CSS 实现**):字距铁律 / tabular-nums / OpenType 特性 / serif italic 混排 / 字体栈三层降级。
- ## 🎨 核心特性
- | 特性 | 说明 |
- |------|------|
- | **6 步 Pipeline** | 需求调研 → 资料搜集 → 大纲策划 → 策划稿 → HTML 设计稿 → 后处理(SVG + PPTX)|
- | **26 种世界级风格** | 5 板块覆盖:暗色专业 7 / 浅色高级 8 / 活力鲜明 4 / 东方文化 3 / 自然复古 4 |
- | **18 种数据可视化** | 基础 8 + 进阶 6(雷达/时间线/漏斗/仪表盘)+ ECharts 级 4(世界地图/关系网络/桑基/热力日历)|
- | **Bento Grid 布局** | 7 种基础布局 + 3 种扩展版式,内容驱动版式 |
- | **世界级排版** | 7 级字号阶梯 · 字距铁律 · tabular-nums · OpenType 特性 · serif italic 混排 · 字体栈三层降级 |
- | **智能配图** | AI 生成配图 + 5 种视觉融入技法(渐隐融合/色调蒙版/氛围底图等)|
- | **失败模式目录** | 8 种 failure modes(underfill / decorative_substitution 等)+ 修复顺序铁律 |
- | **跨页叙事** | 密度交替节奏 / 章节色彩递进 / 封面-结尾呼应 / 渐进揭示 |
- | **风格预览画廊** | `gallery.py` 一键生成 26 风格卡片墙索引页,[在线查看](https://akxan.github.io/ppt-agent-skill/) |
- | **可编辑 PPTX** | 文字是文本框、图形是原生形状、卡片是组合;径向背景、光晕等复杂效果自动转成图层保真 |
- | **切换与动画** | 默认页间淡入;可选卡片逐张入场(点击或自动),在 PowerPoint 中实测可用,浏览器预览页也能播放同样的动效 |
- | **严格模式** | 可选:`validate.py` 在每步后校验大纲、策划稿、风格、设计稿与截图 |
- | **Smoke 测试** | `smoke_test.py` 覆盖风格、mock、图表、校验器、文档引用与真实导出 |
- ## 🚀 快速开始
- **安装**:把仓库克隆到 Claude Code 的 skills 目录,然后新开一个会话。
- ```bash
- # 个人级:所有项目可用
- git clone --depth 1 https://github.com/Akxan/ppt-agent-skill ~/.claude/skills/ppt-agent-skill
- # 或项目级:只在当前项目可用(在项目根目录执行)
- git clone --depth 1 https://github.com/Akxan/ppt-agent-skill .claude/skills/ppt-agent-skill
- ```
- **使用**:装好后直接说需求,Skill 会自动触发:
- ```
- 你:帮我做一个关于 X 的 PPT
- ↓
- Agent 提问调研需求(等你回复 7 题)
- ↓
- 自动搜索资料 → 生成大纲 → 策划稿 → 逐页设计 HTML
- ↓
- 自动后处理:HTML → SVG → PPTX
- ↓
- 全部产物保存到 ppt-output/
- ```
- **触发示例**:
- | 场景 | 说法 |
- |------|------|
- | 纯主题 | `做一个关于 X 的 PPT` / `做一个 Y 的演示` |
- | 带素材 | `把这篇文档做成 PPT` / `用这份报告做 slides` |
- | 带要求 | `做 15 页暗黑科技风的 AI 安全汇报材料` |
- | 隐式触发 | `我要给老板汇报 Y` / `做个培训课件` / `做路演 deck` |
- **环境依赖**(只有导出 SVG / PPTX 时需要;缺少时仍会交付 HTML 预览):
- ```bash
- # Python >= 3.9
- pip install python-pptx lxml Pillow
- # Node.js >= 18;puppeteer 在首次运行 html2svg.py 时自动安装(会下载 Chrome,约 600 MB)
- ```
- ## 🎨 26 风格预览画廊
- 5 个板块,覆盖所有典型商业场景。每个 mock 都是真实 1280×720 设计稿,可以在[在线画廊](https://akxan.github.io/ppt-agent-skill/)里逐个点开看:
- ### 暗色专业(7 风格 · `references/styles/dark.md`)
- <div align="center">
- <img src="assets/hero-dark-professional.png" alt="暗色专业 7 风格" width="100%" />
- </div>
- > Linear / Apple Hardware / Tom Ford / Cyberpunk 2077 / Y2K / Magnum 等品牌的实际排版做法
- | ID | 灵感 | 适用场景 |
- |----|------|---------|
- | `dark_tech` | Linear.app | AI / SaaS / 开发者工具 |
- | `xiaomi_orange` | Apple Keynote 硬件版 | 硬件 / IoT / 汽车发布 |
- | `luxury_purple` | Tom Ford | 奢侈品 / 高端品牌 |
- | `nocturne_violet` | Linear 紫光版 | 设计师 SaaS / 创业产品 |
- | `cyberpunk_neon` | Cyberpunk 2077 | 电竞 / 游戏 / Web3 |
- | `chrome_y2k` | Y2K / Vaporwave | Web3 / 千禧年复古 |
- | `noir_film` | Magnum / 黑白纪录片 | 纪录片 / 影像艺术 / 摄影 |
- ### 浅色高级(8 风格 · `references/styles/light.md`)
- <div align="center">
- <img src="assets/hero-light-premium.png" alt="浅色高级 8 风格" width="100%" />
- </div>
- > Apple / Anthropic / NYT Magazine / iOS 26 / Mayo Clinic / Suisse Int'l / 婚礼请柬
- | ID | 灵感 | 适用场景 |
- |----|------|---------|
- | `blue_white` | Apple 企业页面 | 企业 SaaS / 培训 / 金融医疗 |
- | `fresh_green` | Aesop | 护肤 / 养生 / 食品 / 美妆 |
- | `minimal_gray` | NYT Magazine | 学术 / 法务 / 咨询 / 白皮书 |
- | `mocha_editorial` | Anthropic / Pantone 2025 | AI 安全研究 / 出版 |
- | `medical_pulse` | Mayo Clinic | 医疗 / 医药 / 健康保险 |
- | `earth_concrete` | Suisse Int'l | 建筑 / 工业 / 咖啡品牌 |
- | `champagne_gold` | 婚礼请柬 | 婚庆 / 宴会 / 颁奖典礼 |
- | `liquid_glass` | iOS 26 / visionOS | XR / AR / 苹果生态发布 |
- ### 活力鲜明(4 风格 · `references/styles/vibrant.md`)
- <div align="center">
- <img src="assets/hero-vibrant.png" alt="活力鲜明 4 风格" width="100%" />
- </div>
- | ID | 灵感 | 适用场景 |
- |----|------|---------|
- | `vibrant_rainbow` | Stripe Sessions | 营销 / 创作者 / 大会 |
- | `kindergarten_pop` | 高质量儿童绘本 | 儿童教育 / 启蒙 / 亲子 |
- | `bauhaus_block` | Bauhaus / Swiss Design | 教育 / 创意品牌 / 独立设计 |
- | `candy_pastel` | Ladurée 糖果店 | 甜品 / 烘焙 / 零食 |
- ### 东方文化(3 风格 · `references/styles/cultural.md`)
- <div align="center">
- <img src="assets/hero-cultural-oriental.png" alt="东方文化 3 风格" width="80%" />
- </div>
- | ID | 灵感 | 适用场景 |
- |----|------|---------|
- | `royal_red` | 北京冬奥开幕式 | 中国风 / 政务 / 文化 |
- | `sakura_wabi` | 日本侘寂 | 日系 / 茶道 / 民宿 |
- | `ink_jade` | 新中式国潮 | 茶饮 / 古风文创 / 独立书店 |
- ### 自然/复古(4 风格 · `references/styles/natural.md`)
- <div align="center">
- <img src="assets/hero-natural-retro.png" alt="自然/复古 4 风格" width="100%" />
- </div>
- | ID | 灵感 | 适用场景 |
- |----|------|---------|
- | `botanic_forest` | Patagonia / Nat Geo | 户外 / 可持续 / 林产 |
- | `safari_savanna` | National Geographic | 旅行 / 探险 / 纪录片 |
- | `retro_70s` | Wes Anderson / 70s 海报 | 独立咖啡 / 唱片 / 复古 |
- | `gov_authority` | 人民日报 / 国宴 | 党政 / 重大会议 / 严肃汇报 |
- ## 📈 18 种数据可视化
- | 层级 | 数量 | 图表 | 文件 |
- |------|------|------|------|
- | **基础** | 8 | 进度条 · 对比柱 · 环形图 · 迷你折线 · 点阵图 · KPI 卡 · 指标行 · 评分 | [`charts/basic.md`](references/charts/basic.md) |
- | **进阶** | 6 | 雷达图 · 时间线 · 漏斗图 · 仪表盘 · 多组对比柱 · 简单地理 | [`charts/advanced.md`](references/charts/advanced.md) |
- | **ECharts 级** | 4 | 世界地图 choropleth · 关系网络 · 桑基图 · 热力日历 | [`charts/complex.md`](references/charts/complex.md) |
- 全部纯 HTML/CSS/SVG 实现,**无 JS 运行时**,进 PPTX 后图形与数字仍可编辑。所有图表通过标准 CSS 变量自动适配 26 风格。
- ## 🔧 工作流
- ```
- ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
- │ 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`](SKILL.md)。
- ## 🏗 系统架构
- <div align="center">
- <img src="assets/architecture.png" alt="系统架构图" width="100%" />
- <p><sub>3 层架构:用户入口 / 6 步 Pipeline / 输出产物 · 5 大 Reference Library 注入到各步</sub></p>
- </div>
- **3 层架构**:
- - **TIER 1 · 入口** — 用户一句话 prompt 触发 [SKILL.md](SKILL.md)(Agent 入口主流程指令);引用 `references/` 下的所有规则文件
- - **TIER 2 · 6 步 Pipeline** — 每步独立 STEP,前后用 JSON 合同传递;每步可见使用的 reference 文件
- - **TIER 3 · 输出** — 翻页 HTML / 矢量 SVG / 可编辑 PPTX(含切换与动画)/ 风格预览画廊
- **Reference Library**(注入到各步):
- | 模块 | 数量 | 位置 |
- |------|------|------|
- | 📐 Style Library | 26 风格 | `references/styles/` (5 板块) |
- | 📊 Chart Library | 18 图表 | `references/charts/` (3 层级) |
- | 🔤 Typography | 14 铁律 | `references/typography.md` |
- | ⚠ Failure Modes | 8 模式 | `references/principles/failure-modes.md` |
- | 🎨 Bento Grid | 7 布局 | `references/bento-grid.md` |
- ## 📂 文件树
- ```
- ppt-agent-skill/
- ├── .github/workflows/pages.yml # 把风格画廊自动发布到 GitHub Pages
- ├── SKILL.md # 主工作流指令(Agent 入口)
- ├── README.md / README_EN.md # 本文件 / English
- ├── ATTRIBUTIONS.md # 借鉴来源与致谢
- ├── assets/ # README 用图:logo、架构图、风格拼图
- ├── references/ # Skill 引用文档(索引见 references/README.md)
- │ ├── prompts.md # 5 套 Prompt 模板
- │ ├── bento-grid.md # 画布、7 种布局、6 种基础卡片
- │ ├── typography.md # 排版铁律 14 条
- │ ├── pipeline-compat.md # 哪些 CSS 保持矢量 / 转图层 / 会丢
- │ ├── strict-mode.md # 可选的脚本校验与图审清单
- │ ├── method.md # 核心方法论
- │ ├── styles/ # 26 风格:index.md + 5 个板块文件
- │ ├── charts/ # 18 图表:index.md + basic / advanced / complex
- │ ├── layouts/ # 10 种版式
- │ ├── blocks/ # 7 种组件原型 + card-styles
- │ ├── page-templates/ # cover / toc / section / end
- │ ├── principles/ # 6 条设计原则 + failure-modes
- │ └── design-runtime/ # CSS 技法库、数据类型映射
- ├── scripts/ # 脚本(索引见 scripts/README.md)
- │ ├── html_packager.py # 多页 HTML → 翻页预览
- │ ├── html2svg.py # HTML → SVG(文字可编辑,复杂效果转图层)
- │ ├── svg2pptx.py # SVG → PPTX(原生形状、切换、入场动画)
- │ ├── pptx_motion.py # 切换与动画的 OOXML 构造
- │ ├── html2png.py / png2pptx.py # 像素级保真版 PPTX
- │ ├── contracts.py # 数据合同的单一真源
- │ ├── validate.py # 严格模式校验
- │ ├── resource_loader.py # 按策划稿字段取参考资源
- │ ├── smoke_test.py # 冒烟测试
- │ └── gallery.py / build_hero.py# 风格画廊与 README 拼图
- └── ppt-output/style-gallery/ # 26 个 1280×720 mock + 截图 + index.html
- ```
- ## 🧪 质量保证
- ```bash
- # 快速套件:26 风格定义 / mock 合规 / 18 图表模板 / 校验器 / 资源路由 / 文档引用完整性
- python3 scripts/smoke_test.py
- # 追加真实导出:HTML → SVG → PPTX,并断言背景、卡片成组、页间切换、入场动画都已写入
- python3 scripts/smoke_test.py --export
- ```
- 导出质量用真实 PowerPoint 渲染对照浏览器截图验证过 26 个风格。生成 deck 时还可以启用[严格模式](references/strict-mode.md),在每一步后用 `scripts/validate.py` 校验产物。
- ## 🌟 世界级标杆参照系
- 排版做法参考的实际品牌(**不是看截图模仿,是阅读其官网 CSS**):
- | 类别 | 品牌 | 学到了什么 |
- |------|------|-----------|
- | 暗色 SaaS | [Linear](https://linear.app) | Inter Tight 紧凑字距 + 紫色辉光 + serif italic 关键词混排 |
- | AI 编辑器 | [Anthropic](https://anthropic.com) | Mocha Mousse 米色 + Source Serif italic + 砖红强调线 |
- | 渐变高级感 | [Stripe](https://stripe.com) | 多层 linear-gradient + 玻璃球(多层 radial-gradient + 内阴影)|
- | 极简白 | [Apple](https://apple.com) | SF Pro 字体栈 + 大留白 + 内框线条 |
- | 全息镭射 | [OpenAI](https://openai.com) | 纯黑底 + 全息球 + 极简留白 |
- | 极致黑白 | [Vercel](https://vercel.com) | Geist Sans + 几何分割 + monospace 终端语义 |
- | 杂志感 | NYT Magazine | masthead + 巨型 serif + 三栏分栏 + 首字下沉 |
- | 演示工具 | [Pitch](https://pitch.com) | 大胆排版 + 全屏色块 + 拼贴感 |
- | 金融 serif | [Mercury](https://mercury.com) | SangBleu serif 大标题 + 极简金融感 |
- | 浏览器渐变 | [Arc](https://arc.net) | 渐变彩色 + 圆角图标 + 创意拼贴 |
- | 时尚奢华 | Tom Ford | Didot italic + 黑金 + 居中对称 + 0.65em 字距 |
- | 友好编辑器 | [Notion](https://notion.so) | Lyon Display + 米白 + emoji 系统 |
- ## ⭐ Star History
- <div align="center">
- <a href="https://star-history.com/#Akxan/ppt-agent-skill&Date">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Akxan/ppt-agent-skill&type=Date&theme=dark" />
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Akxan/ppt-agent-skill&type=Date" />
- <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=Akxan/ppt-agent-skill&type=Date&theme=dark" width="100%" />
- </picture>
- </a>
- <p><sub>实时生成 · 由 <a href="https://star-history.com">star-history.com</a> 提供 · 自动适配深色/浅色主题</sub></p>
- </div>
- ## 🤝 贡献
- 欢迎提 Issue / PR:
- - **新增风格**:在对应 `references/styles/<category>.md` 追加 JSON 定义 + 在 `ppt-output/style-gallery/<id>.html` 写 1280×720 mock
- - **新增图表**:在 `references/charts/<level>.md` 追加 HTML 模板,并在 `scripts/contracts.py` 的 `CHARTS` 登记
- - **改进文档**:欢迎 typo 修复、用法说明补充
- 提交前跑一下 `python3 scripts/smoke_test.py` 确保通过。
- ## 📜 许可证
- [MIT](LICENSE)
- ---
- <div align="center">
- <sub>Built with ❤️ for <a href="https://claude.com/claude-code">Claude Code</a> · MMXXVI</sub>
- </div>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.