Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

refactor: 流程与规则分离,generate-ppt.md为主入口

hugohe3df2efb2fcebe
diff --git a/.agent/workflows/generate-ppt.md b/.agent/workflows/generate-ppt.md
index ace7d15e..77691b40 100644
--- a/.agent/workflows/generate-ppt.md
+++ b/.agent/workflows/generate-ppt.md
@@ -1,11 +1,27 @@
---
-description: 从 Markdown 源文档生成 PPT 的完整流程
+description: 从 Markdown 源文档生成 PPT 的完整流程(主入口)
---
# PPT 生成工作流
+> 📌 **这是 PPT Master 系统的主执行流程**。所有 PPT 生成任务都应从此工作流开始。
+
本工作流用于从 Markdown 源文档生成 PowerPoint 演示文稿。
+**相关文档**:
+- [AGENTS.md](../../AGENTS.md) — 规则手册(角色切换协议、技术约束、AI 提示)
+- [roles/](../../roles/) — 各角色详细定义和知识库
+
+---
+
+## 工作流概览
+
+```
+源文档 → 创建项目 → 模板选项 → Strategist → [Template_Designer] → [Image_Generator] → Executor → 后处理 → 导出
+```
+
+---
+
## 前置条件
- 用户已提供源文档(Markdown、PDF 或 URL)
diff --git a/AGENTS.md b/AGENTS.md
index db7b9154..39f37e3f 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -18,110 +18,19 @@ PPT Master 是一个 AI 驱动的多格式 SVG 内容生成系统,通过多角
| **Executor_Consultant_Top** | `roles/Executor_Consultant_Top.md` | 顶级咨询风格 SVG 生成(MBB 级) |
| **Optimizer_CRAP** | `roles/Optimizer_CRAP.md` | CRAP 原则视觉优化(可选) |
-### 工作流程
+### 主工作流程
+
+> 📖 **详细执行步骤**:请参阅 [generate-ppt.md](.agent/workflows/generate-ppt.md)
```
-用户提供源文档(PDF/URL/Markdown)
- │
- ▼
-源内容转换工具(如需要)
- │
- ▼
-【创建项目文件夹】← ← ← ← ← 获取原始材料后立即执行
- python3 tools/project_manager.py init <名称> --format <格式>
- │
- ▼
-┌─────────────────────────────────────────┐
-│ 询问模板选项(三选一) │
-└─────────────────────────────────────────┘
- │
- ├─────────────────────────────────────────┐
- │ │
- A) 使用已有模板 │
- │ │
- ├→ 用户提供模板或从示例库选择 │
- │ 图片 → images/,其他 → templates/ │
- │ (来源:用户自备/其他项目/示例库等) │
- │ │
- │ B) 不使用模板
- │ │
- │ │
- │ │
- C) 生成新模板 │
- │ │
- │ │
- │ │
- ├─────────────────────────────────────────┘
- │
- ▼
-┌─────────────────────────────────────────┐
-│ Strategist(策略规划)← 必须,不可跳过 │
-│ • 八项确认 │
-│ • 生成《设计规范与内容大纲》 │
-│ • 保存设计规范到项目文件夹 │
-└─────────────────────────────────────────┘
- │
- ├─ 模板选项 = C(生成新模板)?
- │ │
- │ YES ────────────────────────────┐
- │ │
- │ ┌──────────────────────────────────┐
- │ │ Template_Designer(选项 C) │
- │ │ • 生成页面模板到 templates/ │
- │ │ • 用户确认后继续 │
- │ └──────────────────────────────────┘
- │ │
- │ ┌──────────────────────────────────┘
- │ │
- ├───────┘
- │
- ├─ 图片方式包含「C) AI 生成」?
- │ │
- │ YES → Image_Generator → 保存到 images/
- │ │
- │ NO ──────────────────────────────┐
- │ │
- ▼ ▼
-┌──────────────────────────────────────────────────┐
-│ Executor (General/Consultant/Consultant_Top) │
-│ │
-│ 【视觉构建阶段】 │
-│ • 逐页生成 SVG(可基于模板)→ svg_output/ │
-│ │
-│ 【逻辑构建阶段】← ← ← ← 必须 │
-│ • 生成完整讲稿 → notes/total.md │
-│ │
-└──────────────────────────────────────────────────┘
- │
- ▼
-【后处理】← ← ← ← ← 默认由 AI 自动执行
- python3 tools/total_md_split.py # 拆分讲稿
- python3 tools/finalize_svg.py
- │
- ▼
-SVG 文件保存到 svg_final/
- │
- ▼
-【导出 PPTX】← ← ← ← ← 默认由 AI 自动执行
- python3 tools/svg_to_pptx.py
- │
- ▼
-Optimizer_CRAP (可选优化,**在完整初版后**不满意时才考虑)
- │
- ▼
-如执行优化:重新运行【后处理】与【导出 PPTX】
+源文档 → 创建项目 → 模板选项 → Strategist → [Template_Designer] → [Image_Generator] → Executor → 后处理 → 导出
```
-> **注意**:
->
-> - **项目文件夹必须在源材料转换完成后立即创建**
-> - **模板选项必须在策略师开始之前确认**,策略师需要根据模板选项调整设计方案
-> - 如选择 A(使用已有模板),策略师需参考模板的配色、布局、风格进行设计
-> - 如选择 C(生成新模板),策略师完成大纲后再调用模板设计师
-> - **策略师的「八项确认」是强制要求,无论模板选项如何都不可跳过**
-> - Image_Generator 是串行环节,图片归集完成后才进入 Executor 阶段
-> - 后处理和导出步骤以 **AI 自动执行为主**(需要时可手动运行命令)
-> - Optimizer_CRAP 仅在质量不足时使用;**须在完整初版产出后再考虑,优化后需重新运行后处理与导出**
+**关键节点**:
+1. **源内容处理**:PDF/URL 立即转换,不等待确认
+2. **模板选项**:必须在策略师之前确认(A 使用已有 / B 不使用 / C 生成新模板)
+3. **八项确认**:策略师必须完成,不可跳过
+4. **后处理与导出**:AI 自动执行
---