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(docs): 将生成流程合并至 AGENTS.md 并解耦模板创建工作流

hugohe32fcd3340c3fc
diff --git a/.agent/workflows/create-template.md b/.agent/workflows/create-template.md
index 56dc9e9f..42e7429f 100644
--- a/.agent/workflows/create-template.md
+++ b/.agent/workflows/create-template.md
@@ -111,7 +111,7 @@ ls -la "templates/layouts/<新模板名称>"
## 注意事项
-1. **SVG 技术约束**:遵守 [AGENTS.md](../../AGENTS.md) 规则
+1. **SVG 技术约束**:参见 [Template_Designer.md](../roles/Template_Designer.md) 技术约束章节
2. **配色一致性**:所有 SVG 文件使用相同配色
3. **占位符规范**:使用 `{{}}` 格式
diff --git a/.agent/workflows/generate-ppt.md b/.agent/workflows/generate-ppt.md
index a14913b9..9ad70539 100644
--- a/.agent/workflows/generate-ppt.md
+++ b/.agent/workflows/generate-ppt.md
@@ -4,335 +4,10 @@ description: 从 Markdown 源文档生成 PPT 的完整流程(主入口)
# PPT 生成工作流
-> 📌 **这是 PPT Master 系统的主执行流程**。所有 PPT 生成任务都应从此工作流开始。
+> ⚠️ **本工作流已合并到 [AGENTS.md](../../AGENTS.md)**
+>
+> 请直接阅读 [AGENTS.md](../../AGENTS.md),该文件包含完整的工作流程和规则手册。
----
-
-## ⚠️ 阶段零:强制前置检查(不可跳过)
-
-**在执行任何步骤之前,必须完成以下检查:**
-
-### 检查项 1:阅读规则手册
-
-如果本次会话**尚未阅读** `AGENTS.md`,请立即执行:
-
-```
-view_file: AGENTS.md
-```
-
-> 💡 **判断方法**:如果你不确定本次会话是否已读过 AGENTS.md,就重新读一次。
-
-### 检查项 2:确认已理解核心规则
-
-- [ ] 角色切换协议(切换角色前必须阅读角色定义文件)
-- [ ] SVG 技术约束(禁用功能黑名单、PPT 兼容性规则)
-- [ ] 源内容自动处理(PDF/URL 必须立即转换)
-
-**确认完成后,输出以下标记:**
-
-```markdown
-## ✅ 阶段零检查完成
-- [x] 已阅读 AGENTS.md
-- [x] 已理解核心规则
-- [ ] 开始执行阶段一
-```
-
----
-
-## 核心文档关系
-
-| 文档 | 定位 | 内容 |
-|------|------|------|
-| **[AGENTS.md](../../AGENTS.md)** | 规则手册 | "怎么做"(约束边界、技术规范) |
-| **本工作流** | 执行流程 | "做什么"(步骤顺序) |
-| **[roles/](../../roles/)** | 角色定义 | "谁来做"(专业能力、职责范围) |
-
----
-
-## 工作流概览
-
-```
-源文档 → 创建项目 → 模板选项 → Strategist → [Image_Generator] → Executor → 后处理 → 导出
-```
-
----
-
-## 前置条件
-
-- 用户已提供源文档(Markdown、PDF 或 URL)
-- 如果是 PDF/URL,需先转换为 Markdown
-
----
-
-## 阶段一:源内容处理(如需要)
-
-当用户提供 PDF 或 URL 时,**必须立即调用对应工具**:
-
-| 用户提供内容 | 必须调用的工具 | 命令 |
-|--------------|----------------|------|
-| **PDF 文件** | `pdf_to_md.py` | `python3 tools/pdf_to_md.py <文件路径>` |
-| **网页链接** | `web_to_md.py` | `python3 tools/web_to_md.py <URL>` |
-| **微信/高防站** | `web_to_md.cjs` | `node tools/web_to_md.cjs <URL>` |
-| **Markdown** | - | 直接 `view_file` 读取 |
-
----
-
-## 阶段二:创建项目文件夹
-
-> ⚠️ **第一步!** 用户输入内容后必须立即创建
-
-// turbo
-```bash
-python3 tools/project_manager.py init <项目名称> --format <格式>
-```
-
-格式选项:`ppt169`(默认)、`ppt43`、`xhs`、`story` 等
-
----
-
-## 阶段三:模板选项确认
-
-> ⚠️ **必须在策略师开始之前确认**,策略师需根据模板选项调整设计方案
-
-向用户询问模板选项(二选一):
-
-### A) 使用已有模板
-
-**情况 1:模板在 repo 内**(如 `templates/layouts/` 下)
-
-检查模板目录内容,按类型分别复制:
-// turbo
-```bash
-# 复制模板文件(.svg, .md)到 templates/
-cp templates/layouts/<模板名>/*.svg <项目路径>/templates/
-cp templates/layouts/<模板名>/design_spec.md <项目路径>/templates/
-
-# 复制图片资源(.png, .jpg 等)到 images/
-# 注意:图片直接在模板目录下,不是在 images/ 子目录
-cp templates/layouts/<模板名>/*.png <项目路径>/images/ 2>/dev/null || true
-cp templates/layouts/<模板名>/*.jpg <项目路径>/images/ 2>/dev/null || true
-cp templates/layouts/<模板名>/*.jpeg <项目路径>/images/ 2>/dev/null || true
-```
-
-**情况 2:模板在 repo 外**(用户自备/其他项目)
-
-告知用户按以下规则手动复制:
-
-| 文件类型 | 目标目录 | 示例 |
-|----------|----------|------|
-| 模板 SVG 文件 | `<项目路径>/templates/` | `01_cover.svg`, `02_toc.svg` |
-| 设计规范文件 | `<项目路径>/templates/` | `design_spec.md` |
-| 图片资源 | `<项目路径>/images/` | `cover_bg.png`, `logo.svg` |
-
-等待用户确认文件已复制就绪后再继续。
-
-**模板内容检查**:
-```
-<项目路径>/
-├── templates/ # 模板文件
-│ ├── design_spec.md # 设计规范(必须)
-│ ├── 01_cover.svg # 封面模板
-│ ├── 02_toc.svg # 目录模板
-│ ├── 03_chapter.svg # 章节页模板
-│ ├── 04_content.svg # 内容页模板
-│ └── 05_ending.svg # 结尾页模板
-└── images/ # 图片资源(如有)
- ├── cover_bg.png
- └── ...
-```
-
-> 📌 策略师需参考模板的配色、布局、风格进行设计
-
-### B) 不使用模板
-
-→ 自由生成,策略师完全自主设计
-
-> 💡 **需要创建新模板?** 请使用 `/create-template` 工作流单独创建模板,完成后再回到此流程选择 A。
-
----
-
-## 阶段四:Strategist 角色(必须,不可跳过)
-
-1. **阅读角色定义**:
- ```
- view_file: roles/Strategist.md
- ```
-
-2. **完成八项确认**(强制要求):
- - 画布格式、页数范围、目标受众、风格目标
- - 配色方案、图标使用、图片使用、排版方案
-
-3. **如果用户提供了图片**,运行图片分析:
- // turbo
- ```bash
- python3 tools/analyze_images.py <项目路径>/images
- ```
-
-4. **生成《设计规范与内容大纲》**:
- - 参考模板:`templates/design_spec_reference.md`
- - 保存到:`<项目路径>/设计规范与内容大纲.md`
-
-5. **阶段检查点**:
- ```markdown
- ## ✅ Strategist 阶段完成
- - [x] 已完成八项确认
- - [x] 已生成《设计规范与内容大纲》
- - [x] 设计规范已保存到项目文件夹
- - [ ] **下一步**: [Image_Generator / Executor_xxx]
- ```
-
----
-
-## 阶段六:Image_Generator 角色(条件触发)
-
-> **触发条件**:图片方式包含「C) AI 生成」(如 C、B+C、C+D)
-
-1. **阅读角色定义**:
- ```
- view_file: roles/Image_Generator.md
- ```
-
-2. **分析图片资源清单**:
- - 从《设计规范与内容大纲》中提取所有「状态=待生成」的图片
- - 判断每张图片的类型(背景图/实景照片/插画/图表/装饰图案)
-
-3. **生成提示词文档**(必须保存为文件):
- - 保存到 `<项目路径>/images/image_prompts.md`
- - 格式:主体描述 + 风格指令 + 色彩指令 + 构图指令 + 负面提示词 + Alt Text
-
-4. **生成图片**(三种方式):
-
- **方式一:直接生成**(如支持 generate_image 工具)
- - 使用 `generate_image` 工具生成图片
-
- **方式二:用户自行生成**
- - 告知用户提示词文件位置
- - 推荐平台:Gemini、Midjourney、DALL-E 3、Stable Diffusion
-
- **方式三:Gemini 生成**(推荐高分辨率)
- - 下载 Full Size 版本
- - 去除水印:
- // turbo
- ```bash
- python3 tools/gemini_watermark_remover.py <图片路径>
- ```
-
-5. **验证图片就绪**:确认所有图片已保存到 `images/` 目录
-
-6. **阶段检查点**:
- ```markdown
- ## ✅ Image_Generator 阶段完成
- - [x] 已创建提示词文档 `images/image_prompts.md`
- - [x] 所有图片已保存到 images/ 目录
- - [ ] **下一步**: Executor_xxx
- ```
-
----
-
-## 阶段七:Executor 角色
-
-1. **阅读角色定义**(根据风格选择):
- ```
- view_file: roles/Executor_General.md # 通用灵活风格
- view_file: roles/Executor_Consultant.md # 一般咨询风格
- view_file: roles/Executor_Consultant_Top.md # 顶级咨询风格
- ```
-
-2. **【视觉构建阶段】**:
- - 批量生成 SVG 页面
- - 保存到 `<项目路径>/svg_output/`
-
-3. **【逻辑构建阶段】**(必须):
- - 生成完整演讲备注文稿
- - 保存到 `<项目路径>/notes/total.md`
-
-4. **阶段检查点**:
- ```markdown
- ## ✅ Executor 阶段完成
- ### 视觉构建阶段
- - [x] 所有 SVG 页面已生成到 svg_output/
-
- ### 逻辑构建阶段
- - [x] 已生成完整演讲备注 notes/total.md
- ```
-
----
-
-## 阶段八:后处理与导出(自动执行)
-
-> ⚠️ **必须按顺序执行以下三个命令,不可省略或替换!**
-
-### 步骤 1:拆分演讲备注
-// turbo
-```bash
-python3 tools/total_md_split.py <项目路径>
-```
-
-### 步骤 2:SVG 后处理
-// turbo
-```bash
-python3 tools/finalize_svg.py <项目路径>
-```
-
-**此步骤执行以下处理**:
-- 嵌入图标(将占位符替换为实际图标代码)
-- 智能裁剪图片
-- 修复图片宽高比
-- 嵌入图片(Base64 编码,避免外部引用)
-- 文本扁平化
-- 圆角矩形转 Path(提高 PPT 兼容性)
-
-> ❌ **禁止**:使用 `cp` 命令替代此步骤!
-
-### 步骤 3:导出 PPTX
-// turbo
-```bash
-python3 tools/svg_to_pptx.py <项目路径> -s final
-```
-
-- `-s final` 参数指定从 `svg_final/` 目录读取
-- 默认会嵌入演讲备注
-
----
-
-## 阶段九:Optimizer_CRAP(可选)
-
-> **触发条件**:用户要求优化 或 质量不足时主动建议
-
-1. **阅读角色定义**:
- ```
- view_file: roles/Optimizer_CRAP.md
- ```
-
-2. **执行 CRAP 原则优化**
-
-3. **重新执行后处理与导出**(如有修改)
-
----
-
-## 完成检查清单
-
-- [ ] 源内容已转换为 Markdown
-- [ ] 项目文件夹已创建
-- [ ] 模板选项已确认
-- [ ] 八项确认已完成
-- [ ] 设计规范已保存
-- [ ] 图片已就绪(如需要)
-- [ ] SVG 文件已生成到 `svg_output/`
-- [ ] 演讲备注已生成 `notes/total.md`
-- [ ] 后处理已执行(`finalize_svg.py`)
-- [ ] SVG 文件已复制到 `svg_final/`
-- [ ] PPTX 已导出
-
----
-
-## 常见错误提醒
-
-| 错误 | 正确做法 |
-|------|----------|
-| 用 `cp` 复制 SVG 到 svg_final | 使用 `finalize_svg.py` |
-| 直接从 `svg_output` 导出 | 使用 `-s final` 从 `svg_final` 导出 |
-| 忘记拆分备注 | 先运行 `total_md_split.py` |
-| 忘记后处理 | 先运行 `finalize_svg.py` |
-| 跳过 Strategist 八项确认 | 必须完成,无论模板选项如何 |
-| 模板选项后才创建项目 | 先创建项目,再询问模板选项 |
+**快速跳转**:
+- [工作流程](../../AGENTS.md#工作流程) — 从源文档到 PPT 的完整执行步骤
+- [规则手册](../../AGENTS.md#规则手册) — 约束边界、技术规范、角色切换协议
diff --git a/AGENTS.md b/AGENTS.md
index 9c2df53c..ad24ecdf 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,28 +1,333 @@
-# AGENTS.md — 规则手册(必读)
+# AGENTS.md — PPT Master 完整指南
-> ⚠️ **AI 代理注意**:本文件是 PPT Master 系统的**规则总纲**,执行任何工作流之前必须先阅读本文件。
+> ⚠️ **AI 代理注意**:本文件是 PPT 生成流程的完整指南,包含工作流程和规则手册。
>
-> 如果你是通过 `/generate-ppt` 或 `/create-template` 进入的,请确认已阅读本文件后再继续。
+> 执行 `/generate-ppt` 前必须阅读本文件。
---
-## 🚀 快速入口
+## 📚 目录导航
-| 任务 | 工作流 |
-|------|--------|
-| **生成 PPT** | [/generate-ppt](.agent/workflows/generate-ppt.md) |
+| 部分 | 内容 |
+|------|------|
+| [工作流程](#工作流程) | 从源文档到 PPT 的完整执行步骤 |
+| [规则手册](#规则手册) | 约束边界、技术规范、角色切换协议 |
+| [常用命令](#常用命令) | 工具命令快速参考 |
+| [重要资源](#重要资源) | 模板、图标、文档链接 |
-> 📋 **执行顺序**:阅读本文件 → 阅读工作流 → 开始执行
+---
+
+# 工作流程
+
+> 📌 **这是 PPT Master 系统的主执行流程**。所有 PPT 生成任务都应从此工作流开始。
+
+## 工作流概览
+
+```
+源文档 → 创建项目 → 模板选项 → Strategist → [Image_Generator] → Executor → 后处理 → 导出
+```
+
+---
+
+## ⚠️ 阶段零:强制前置检查(不可跳过)
+
+**在执行任何步骤之前,必须完成以下检查:**
+
+### 检查项 1:确认已理解核心规则
+
+- [ ] 角色切换协议(切换角色前必须阅读角色定义文件)
+- [ ] SVG 技术约束(禁用功能黑名单、PPT 兼容性规则)
+- [ ] 源内容自动处理(PDF/URL 必须立即转换)
+
+**确认完成后,输出以下标记:**
+
+```markdown
+## ✅ 阶段零检查完成
+- [x] 已阅读 AGENTS.md
+- [x] 已理解核心规则
+- [ ] 开始执行阶段一
+```
+
+---
+
+## 阶段一:源内容处理(如需要)
+
+当用户提供 PDF 或 URL 时,**必须立即调用对应工具**:
+
+| 用户提供内容 | 必须调用的工具 | 命令 |
+|--------------|----------------|------|
+| **PDF 文件** | `pdf_to_md.py` | `python3 tools/pdf_to_md.py <文件路径>` |
+| **网页链接** | `web_to_md.py` | `python3 tools/web_to_md.py <URL>` |
+| **微信/高防站** | `web_to_md.cjs` | `node tools/web_to_md.cjs <URL>` |
+| **Markdown** | - | 直接 `view_file` 读取 |
+
+---
+
+## 阶段二:创建项目文件夹
+
+> ⚠️ **第一步!** 用户输入内容后必须立即创建
+
+// turbo
+```bash
+python3 tools/project_manager.py init <项目名称> --format <格式>
+```
+
+格式选项:`ppt169`(默认)、`ppt43`、`xhs`、`story` 等
+
+---
+
+## 阶段三:模板选项确认
+
+> ⚠️ **必须在策略师开始之前确认**,策略师需根据模板选项调整设计方案
+
+向用户询问模板选项(二选一):
+
+### A) 使用已有模板
+
+**情况 1:模板在 repo 内**(如 `templates/layouts/` 下)
+
+检查模板目录内容,按类型分别复制:
+// turbo
+```bash
+# 复制模板文件(.svg, .md)到 templates/
+cp templates/layouts/<模板名>/*.svg <项目路径>/templates/
+cp templates/layouts/<模板名>/design_spec.md <项目路径>/templates/
+
+# 复制图片资源(.png, .jpg 等)到 images/
+# 注意:图片直接在模板目录下,不是在 images/ 子目录
+cp templates/layouts/<模板名>/*.png <项目路径>/images/ 2>/dev/null || true
+cp templates/layouts/<模板名>/*.jpg <项目路径>/images/ 2>/dev/null || true
+cp templates/layouts/<模板名>/*.jpeg <项目路径>/images/ 2>/dev/null || true
+```
+
+**情况 2:模板在 repo 外**(用户自备/其他项目)
+
+告知用户按以下规则手动复制:
+
+| 文件类型 | 目标目录 | 示例 |
+|----------|----------|------|
+| 模板 SVG 文件 | `<项目路径>/templates/` | `01_cover.svg`, `02_toc.svg` |
+| 设计规范文件 | `<项目路径>/templates/` | `design_spec.md` |
+| 图片资源 | `<项目路径>/images/` | `cover_bg.png`, `logo.svg` |
+
+等待用户确认文件已复制就绪后再继续。
+
+**模板内容检查**:
+```
+<项目路径>/
+├── templates/ # 模板文件
+│ ├── design_spec.md # 设计规范(必须)
+│ ├── 01_cover.svg # 封面模板
+│ ├── 02_toc.svg # 目录模板
+│ ├── 03_chapter.svg # 章节页模板
+│ ├── 04_content.svg # 内容页模板
+│ └── 05_ending.svg # 结尾页模板
+└── images/ # 图片资源(如有)
+ ├── cover_bg.png
+ └── ...
+```
+
+> 📌 策略师需参考模板的配色、布局、风格进行设计
+
+### B) 不使用模板
+
+→ 自由生成,策略师完全自主设计
+
+
+
+---
+
+## 阶段四:Strategist 角色(必须,不可跳过)
+
+1. **阅读角色定义**:
+ ```
+ view_file: roles/Strategist.md
+ ```
+
+2. **完成八项确认**(强制要求):
+ - 画布格式、页数范围、目标受众、风格目标
+ - 配色方案、图标使用、图片使用、排版方案
+
+3. **如果用户提供了图片**,运行图片分析:
+ // turbo
+ ```bash
+ python3 tools/analyze_images.py <项目路径>/images
+ ```
+
+4. **生成《设计规范与内容大纲》**:
+ - 参考模板:`templates/design_spec_reference.md`
+ - 保存到:`<项目路径>/设计规范与内容大纲.md`
+
+5. **阶段检查点**:
+ ```markdown
+ ## ✅ Strategist 阶段完成
+ - [x] 已完成八项确认
+ - [x] 已生成《设计规范与内容大纲》
+ - [x] 设计规范已保存到项目文件夹
+ - [ ] **下一步**: [Image_Generator / Executor_xxx]
+ ```
+
+---
+
+## 阶段五:Image_Generator 角色(条件触发)
+
+> **触发条件**:图片方式包含「C) AI 生成」(如 C、B+C、C+D)
+
+1. **阅读角色定义**:
+ ```
+ view_file: roles/Image_Generator.md
+ ```
+
+2. **分析图片资源清单**:
+ - 从《设计规范与内容大纲》中提取所有「状态=待生成」的图片
+ - 判断每张图片的类型(背景图/实景照片/插画/图表/装饰图案)
+
+3. **生成提示词文档**(必须保存为文件):
+ - 保存到 `<项目路径>/images/image_prompts.md`
+ - 格式:主体描述 + 风格指令 + 色彩指令 + 构图指令 + 负面提示词 + Alt Text
+
+4. **生成图片**(三种方式):
+
+ **方式一:直接生成**(如支持 generate_image 工具)
+ - 使用 `generate_image` 工具生成图片
+
+ **方式二:用户自行生成**
+ - 告知用户提示词文件位置
+ - 推荐平台:Gemini、Midjourney、DALL-E 3、Stable Diffusion
+
+ **方式三:Gemini 生成**(推荐高分辨率)
+ - 下载 Full Size 版本
+ - 去除水印:
+ // turbo
+ ```bash
+ python3 tools/gemini_watermark_remover.py <图片路径>
+ ```
+
+5. **验证图片就绪**:确认所有图片已保存到 `images/` 目录
+
+6. **阶段检查点**:
+ ```markdown
+ ## ✅ Image_Generator 阶段完成
+ - [x] 已创建提示词文档 `images/image_prompts.md`
+ - [x] 所有图片已保存到 images/ 目录
+ - [ ] **下一步**: Executor_xxx
+ ```
+
+---
+
+## 阶段六:Executor 角色
+
+1. **阅读角色定义**(根据风格选择):
+ ```
+ view_file: roles/Executor_General.md # 通用灵活风格
+ view_file: roles/Executor_Consultant.md # 一般咨询风格
+ view_file: roles/Executor_Consultant_Top.md # 顶级咨询风格
+ ```
+
+2. **【视觉构建阶段】**:
+ - 批量生成 SVG 页面
+ - 保存到 `<项目路径>/svg_output/`
+
+3. **【逻辑构建阶段】**(必须):
+ - 生成完整演讲备注文稿
+ - 保存到 `<项目路径>/notes/total.md`
+
+4. **阶段检查点**:
+ ```markdown
+ ## ✅ Executor 阶段完成
+ ### 视觉构建阶段
+ - [x] 所有 SVG 页面已生成到 svg_output/
+
+ ### 逻辑构建阶段
+ - [x] 已生成完整演讲备注 notes/total.md
+ ```
+
+---
+
+## 阶段七:后处理与导出(自动执行)
+
+> ⚠️ **必须按顺序执行以下三个命令,不可省略或替换!**
+
+### 步骤 1:拆分演讲备注
+// turbo
+```bash
+python3 tools/total_md_split.py <项目路径>
+```
+
+### 步骤 2:SVG 后处理
+// turbo
+```bash
+python3 tools/finalize_svg.py <项目路径>
+```
+
+**此步骤执行以下处理**:
+- 嵌入图标(将占位符替换为实际图标代码)
+- 智能裁剪图片
+- 修复图片宽高比
+- 嵌入图片(Base64 编码,避免外部引用)
+- 文本扁平化
+- 圆角矩形转 Path(提高 PPT 兼容性)
+
+> ❌ **禁止**:使用 `cp` 命令替代此步骤!
+
+### 步骤 3:导出 PPTX
+// turbo
+```bash
+python3 tools/svg_to_pptx.py <项目路径> -s final
+```
+
+- `-s final` 参数指定从 `svg_final/` 目录读取
+- 默认会嵌入演讲备注
+
+---
+
+## 阶段八:Optimizer_CRAP(可选)
+
+> **触发条件**:用户要求优化 或 质量不足时主动建议
+
+1. **阅读角色定义**:
+ ```
+ view_file: roles/Optimizer_CRAP.md
+ ```
+
+2. **执行 CRAP 原则优化**
+
+3. **重新执行后处理与导出**(如有修改)
+
+---
+
+## 完成检查清单
+
+- [ ] 源内容已转换为 Markdown
+- [ ] 项目文件夹已创建
+- [ ] 模板选项已确认
+- [ ] 八项确认已完成
+- [ ] 设计规范已保存
+- [ ] 图片已就绪(如需要)
+- [ ] SVG 文件已生成到 `svg_output/`
+- [ ] 演讲备注已生成 `notes/total.md`
+- [ ] 后处理已执行(`finalize_svg.py`)
+- [ ] SVG 文件已复制到 `svg_final/`
+- [ ] PPTX 已导出
---
-## 三层架构导航
+## 常见错误提醒
-| 层级 | 文档 | 职责 |
-|------|------|------|
-| **流程** | [generate-ppt.md](.agent/workflows/generate-ppt.md) | "做什么"(步骤顺序) |
-| **角色** | [roles/README.md](roles/README.md) | "谁来做"(专业能力) |
-| **规则** | 本文件 | "怎么做"(约束边界) |
+| 错误 | 正确做法 |
+|------|----------|
+| 用 `cp` 复制 SVG 到 svg_final | 使用 `finalize_svg.py` |
+| 直接从 `svg_output` 导出 | 使用 `-s final` 从 `svg_final` 导出 |
+| 忘记拆分备注 | 先运行 `total_md_split.py` |
+| 忘记后处理 | 先运行 `finalize_svg.py` |
+| 跳过 Strategist 八项确认 | 必须完成,无论模板选项如何 |
+| 模板选项后才创建项目 | 先创建项目,再询问模板选项 |
+
+---
+
+# 规则手册
+
+> 以下是 PPT Master 系统的约束边界和技术规范,执行工作流时必须遵守。
---
@@ -41,7 +346,7 @@ PPT Master 是一个 AI 驱动的多格式 SVG 内容生成系统,通过多角
| 阶段 | 必须阅读的文件 | 触发条件 |
| ------------ | ---------------------------------- | -------------------------------------------- |
| 策略规划 | `roles/Strategist.md` | 用户提出新的 PPT/内容生成需求 |
-| 模板设计 | `roles/Template_Designer.md` | 使用 `/create-template` 工作流时触发(独立流程) |
+
| 图片生成 | `roles/Image_Generator.md` | 图片方式包含「C) AI 生成」(如 C、B+C、C+D) |
| 通用风格执行 | `roles/Executor_General.md` | 用户选择「A) 通用灵活」设计风格 |
| 咨询风格执行 | `roles/Executor_Consultant.md` | 用户选择「B) 一般咨询」设计风格 |
@@ -132,9 +437,8 @@ python3 tools/svg_to_pptx.py <项目路径> -s final
> ⚠️ **优化提示**:仅在完整初版产出后考虑 Optimizer;若优化过,请重新运行后处理与导出以保持产物一致。
---
-## 源内容自动处理(强制触发)
-> 📖 **详细工作流程**:参见 `.agent/workflows/generate-ppt.md`
+## 源内容自动处理(强制触发)
### 强制规则
@@ -200,7 +504,7 @@ python3 tools/svg_to_pptx.py <项目路径> -s final
> 📖 **详细代码示例**:参见 `roles/Executor_*.md` 对应章节
-### 4. 画布格式
+### 3. 画布格式
| 格式 | 尺寸 | viewBox |
| ---------- | --------- | --------------- |
@@ -213,6 +517,8 @@ python3 tools/svg_to_pptx.py <项目路径> -s final
完整格式列表: [docs/canvas_formats.md](./docs/canvas_formats.md)
+---
+
## 常用命令
```bash
@@ -267,6 +573,8 @@ project/
└── *.pptx # 导出的 PPT 文件
```
+---
+
## 质量检查清单
生成 SVG 时确保:
@@ -281,6 +589,8 @@ project/
- [ ] **重复**: 同类元素风格一致
- [ ] **亲密性**: 相关内容空间聚合
+---
+
## 源文档转换工具选择
### PDF 转 Markdown
@@ -310,6 +620,8 @@ project/
> **策略**: 静态网页用 `web_to_md.py`,动态渲染或需登录的页面需手动处理。
+---
+
## 重要资源
| 资源 | 路径 |
@@ -325,6 +637,8 @@ project/
| 示例项目 | `examples/` |
| 工具说明 | `tools/README.md` |
+---
+
## AI 代理重要提示
### 核心原则
@@ -355,7 +669,7 @@ project/
- **创建项目后立即询问模板选项**(A 使用已有 / B 不使用)— 这是流程步骤,非策略师职责
- **模板选项必须在策略师开始之前确认完成**,策略师需根据模板选项调整设计方案
- 如用户选择 A(使用已有模板),需**分别复制**:图片资源拷贝到项目 `images/` 目录,其他文件(SVG、design_spec 等)拷贝到项目 `templates/` 目录(来源:用户自备/其他项目/示例库等)
-- 如需创建新模板,请使用 `/create-template` 工作流(独立流程)
+
- **策略师的「八项确认」是强制要求,无论模板选项如何都不可跳过**
- 策略师必须对八项确认问题**均给出专业建议**
- 如选择 A(使用已有模板),策略师需参考模板的配色、布局、风格进行设计