Ppt Agent

PPT Agent Skill

核心理念

> PPT 的起点不是版式，而是信息目标。

忘掉"一键生成"。本 skill 将 PPT 生产拆成 7 个阶段，让 AI 像专业团队一样完成从需求到交付的全流程。

阶段总览

| 阶段 | 名称 | 产出 | |------|------|------| | 0 | 上下文收拢 | 已有资料清单、约束条件 | | 1 | 需求调研 | 任务澄清文档 | | 2 | 结构化大纲 | 页面清单（便利贴视图） | | 3 | 逐页资料搜集 | 每页资料摘要 | | 4 | 页面策划稿 | 每页内容 + 布局决策 | | 5 | SVG 设计稿 | 每页 SVG 代码 | | 6 | PPTX 导出 | .pptx 文件 | | 7 | 演讲稿 | 逐页讲稿 |

触发条件

当用户请求以下任意内容时激活：

• 制作 PPT / 演示文稿 / 幻灯片
• 生成 slide deck / presentation
• 企业介绍、产品介绍、技术分享等需要 PPT 的场景
• 明确提到 .pptx 文件

执行流程

阶段 0：上下文收拢

目标：先看当前目录有什么，避免重复劳动。

1. 检查当前工作目录是否已有相关资料（文档、PDF、Markdown 等）
2. 确认是否允许联网检索
3. 确认输出格式要求（仅 SVG / 需要 .pptx / 需要演讲稿）
4. 检查是否有现成的模板、品牌素材、配色方案

输出：一份简短的上下文摘要，列出可用素材和约束。

阶段 1：需求调研与任务澄清

目标：像专业顾问一样，先搞清楚真正的需求。

核心原则：如果用户只给了一个标题（如"Dify 企业介绍"），必须追问。

必须确认的信息：

• 主题：PPT 讲什么
• 使用场景：销售介绍 / 内部汇报 / 融资路演 / 技术分享 / 培训教学
• 目标受众：技术团队 / 管理层 / 客户 / 投资人 / 学生
• 期望结果：说服 / 通知 / 教学 / 激励
• 页数要求：建议范围（通常 10-20 页）
• 风格偏好：科技风 / 商务风 / 简约风 / 创意风
• 必须覆盖的内容：有没有不可遗漏的关键信息

执行方式：

1. 先用搜索工具（anysearch）对主题做初步调研
2. 基于调研结果，生成 3-5 个关键问题
3. 等待用户回答后，整理成任务澄清文档

输出：docs/01-需求调研.md — 包含主题、场景、受众、目标、约束。

阶段 2：结构化大纲（便利贴法）

目标：用金字塔原理构建清晰的演示逻辑。

方法论 — 金字塔原理：

1. 结论先行：每个部分以核心观点开篇
2. 以上统下：上层观点是下层内容的总结
3. 归类分组：同层观点按逻辑分组
4. 逻辑递进：时间/结构/重要性顺序

执行方式：

1. 基于需求调研结果，生成结构化大纲
2. 每页用一张"便利贴"表示，包含：

• 页码
• 页面标题（核心观点）
• 关键信息点（2-4 个）
• 页面类型（封面 / 目录 / 内容页 / 数据页 / 总结页 / 致谢页）

1. 展示便利贴视图给用户确认
2. 用户可调整顺序、增删页面

大纲结构模板：

第 1 页：封面 — [主题] + [副标题] + [演讲者/日期]
第 2 页：目录 — [核心章节概览]
第 3-N 页：内容页 — [每页一个核心观点]
第 N+1 页：总结 — [关键结论 + 行动建议]
第 N+2 页：致谢 / Q&A

输出：docs/02-结构化大纲.md — JSON 格式的页面清单。

阶段 3：逐页资料搜集

目标：不是搜一次总资料，而是按页面主题逐页补充。

执行方式：

1. 遍历大纲中的每一页
2. 为每页生成 2-3 个搜索关键词
3. 用搜索工具逐页搜集资料
4. 整理成每页的资料摘要

输出：docs/03-逐页资料/ 目录，每页一个文件。

阶段 4：页面策划稿

目标：把内容组织成可设计的页面草图。

每页策划稿包含：

• 核心观点：这页要传达什么
• 支撑信息：2-4 个关键点
• 数据/案例：具体的数据支撑
• 布局决策：选择合适的 Bento Grid 布局
• 视觉元素：是否需要图表、图标、图片

布局选择指南（Bento Grid）：

• 单一焦点：一张大卡片覆盖大部分区域 — 适用于单一有力信息
• 两栏对称：50/50 等宽 — 适用于并列对比
• 两栏非对称：2/3 + 1/3 — 主内容 + 辅助信息
• 三栏布局：三张等宽 — 适用于并列三项内容
• 主次结合：居中大卡片 + 两侧小卡片
• 顶部英雄式：顶部宽幅 + 下方网格 — 适用于概览 + 细节
• 混合网格：自由组合不同尺寸 — 适应复杂内容

输出：docs/04-页面策划稿/ 目录，每页一个文件。

阶段 5：SVG 设计稿生成

目标：按布局规则生成高质量 SVG 页面。

SVG 规范：

• 画布尺寸：viewBox="0 0 1280 720"（16:9）
• 使用 Bento Grid 卡片布局
• 卡片间距：至少 20px
• 字体：使用系统字体栈（避免字体缺失）
• 配色：基于用户偏好或默认商务配色

执行方式：

1. 读取每页的策划稿
2. 结合布局规则生成 SVG 代码
3. 保存为独立文件
4. 渲染预览检查

输出：output/svg/ 目录，每页一个 .svg 文件。

阶段 6：PPTX 导出

目标：将 SVG 页面打包成可交付的 .pptx 文件。

执行方式：

1. 将每页 SVG 作为全屏背景图片嵌入幻灯片
2. 设置正确的幻灯片尺寸（16:9）
3. 可选：保留可编辑的文本层叠加在 SVG 上

输出：output/[主题名].pptx

阶段 7：演讲稿

目标：为每页生成自然口语化的演讲稿。

执行方式：

1. 基于每页的内容策划稿和最终设计
2. 生成 30-60 秒的口语化讲稿
3. 标注重点、停顿、互动点
4. 检查页面间转场是否顺畅

输出：docs/07-演讲稿.md

配色方案参考

默认商务配色

{
  "primary": "#1a1a2e",
  "secondary": "#16213e",
  "accent": "#0f3460",
  "highlight": "#e94560",
  "text": "#ffffff",
  "textSecondary": "#b0b0b0",
  "background": "#0a0a0a",
  "cardBg": "#1e1e2f"
}

科技风配色

{
  "primary": "#0d1117",
  "secondary": "#161b22",
  "accent": "#21262d",
  "highlight": "#58a6ff",
  "text": "#f0f6fc",
  "textSecondary": "#8b949e",
  "background": "#0d1117",
  "cardBg": "#161b22"
}

简约风配色

{
  "primary": "#ffffff",
  "secondary": "#f5f5f5",
  "accent": "#e0e0e0",
  "highlight": "#1976d2",
  "text": "#212121",
  "textSecondary": "#757575",
  "background": "#fafafa",
  "cardBg": "#ffffff"
}

关键设计原则

1. 内容优先：先有内容结构，再有视觉设计
2. 顾问式交互：AI 主动追问，而非被动等待
3. 逐页研究：每页独立搜集资料，避免信息混杂
4. 可解释布局：每个布局决策都基于内容需求
5. 中间产物可复用：所有阶段文档保留，方便迭代
6. 渐进式确认：每个阶段完成后请用户确认再继续

快速模式

如果用户明确要求"快速生成"或"简单做一下"，可以跳过追问环节，直接基于主题生成：

1. 自动推断需求（场景=通用，受众=混合，目标=传达信息）
2. 直接生成 10-12 页大纲
3. 合并阶段 3-5，逐页生成带内容的 SVG
4. 导出 PPTX

快速模式仍需遵循金字塔原理和 Bento Grid 布局规则。

错误处理

• 如果搜索工具不可用，跳过阶段 3，基于模型知识生成内容
• 如果 SVG 生成失败，降级为纯文本内容页
• 如果 PPTX 导出失败，保留 SVG 文件作为最终交付物
• 每个阶段独立容错，不因单阶段失败中断全流程

参考资料

• 原始思路来源：Sandun - PPT Agent
• 工程化实现参考：PPT Agent 2.0
• 开源实现：zhx47/ppt-agent

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ken861222
• Source: ken861222/PPT-Skill
• License: MIT

Install and usage instructions live in the source repository linked above.