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

docs(roles): 重构执行师工作流规范,引入分阶段批量生成模式 - 重构 Executor (General/Consultant/Top) 执行准则,确立'先视觉后逻辑'的标准作业程序 - 废弃逐页生成模式,推荐分阶段批量生成:先完成所有 SVG 视觉构建,再批量生成演讲备注,以确保设计一致性与叙事连贯性 - 修正文档中关于后处理工具'自动执行'的描述,明确要求 Agent 主动调用 CLI 工具

hugohe35ab90fc28396
diff --git a/roles/Executor_Consultant.md b/roles/Executor_Consultant.md
index 6bbc6e13..0b392159 100644
--- a/roles/Executor_Consultant.md
+++ b/roles/Executor_Consultant.md
@@ -43,18 +43,31 @@
```markdown
## 页面生成:03\_关键发现.svg
-📝 **模板对应**: 无(自由生成)
-🎯 **布局策略**: KPI 卡片 + 图表组合
+ 📝 **模板对应**: 无(自由生成)
+ 🎯 **布局策略**: KPI 卡片 + 图表组合
+
+ [生成的 SVG 代码]
+ ```
+
+ **内容页特别说明**:
+
+ - 咨询风格内容页模板包含:页眉(标题)、核心观点区、页脚(来源、页码)
+ - 内容区域由你根据实际内容自由布局(KPI卡片、图表、对比分析等)
+
+ **如果没有模板文件**,则完全按照《设计规范与内容大纲》自由生成。
+
+ ## 执行准则
+
+ - **绝对遵循规范**: 严格按照规范中的色彩、布局、画布格式、排版参数设计
+ - **遵循模板结构**: 如有模板,继承模板的视觉框架
+ - **分阶段批量生成**(推荐):
+ 1. **视觉构建阶段**: 连续生成所有 SVG 页面,确保设计风格和布局坐标的高度一致性(Visual Consistency)
+ 2. **逻辑构建阶段**: SVG 全部定稿后,再批量生成演讲备注,确保叙事逻辑连贯(Narrative Continuity)
+ - **技术规范**:
+ - viewBox 必须与画布尺寸一致
+ - **严禁使用 `<foreignObject>`**,用 `<tspan>` 手动换行
+ - 使用 `<rect>` 定义背景色
-[生成的 SVG 代码]
-```
-
-**内容页特别说明**:
-
-- 咨询风格内容页模板包含:页眉(标题)、核心观点区、页脚(来源、页码)
-- 内容区域由你根据实际内容自由布局(KPI卡片、图表、对比分析等)
-
-**如果没有模板文件**,则完全按照《设计规范与内容大纲》自由生成。
## SVG 文件命名规范
@@ -206,9 +219,11 @@
## 演讲备注生成
-生成每页 SVG 后,**同步创建**对应的演讲备注文件,为演讲者提供讲稿参考。
+建议在**所有 SVG 页面生成完成并定稿后**,进入“逻辑构建阶段”,批量创建演讲备注文件。
-生成每页 SVG 后,**同步创建**对应的演讲备注文件。
+**为什么不一页 SVG 一页 Note?**
+- **视觉一致性**: 连续生成 SVG 能保持 AI 对坐标和样式的“上下文记忆”,避免风格漂移
+- **叙事连贯性**: 批量写备注能像写剧本一样规划转场语(Transition),确保演讲逻辑通顺
**文件命名规范**:
diff --git a/roles/Executor_Consultant_Top.md b/roles/Executor_Consultant_Top.md
index 61d2698c..511b84b3 100644
--- a/roles/Executor_Consultant_Top.md
+++ b/roles/Executor_Consultant_Top.md
@@ -94,6 +94,19 @@
---
+## 执行准则
+
+- **绝对遵循规范**: 严格按照规范中的色彩、布局、画布格式、排版参数设计
+- **遵循模板结构**: 如有模板,继承模板的视觉框架
+- **分阶段批量生成**(推荐):
+ 1. **视觉构建阶段**: 连续生成所有 SVG 页面,确保设计风格和布局坐标的高度一致性(Visual Consistency)
+ 2. **逻辑构建阶段**: SVG 全部定稿后,再批量生成演讲备注,确保叙事逻辑连贯(Narrative Continuity)
+- **技术规范**:
+ - viewBox 必须与画布尺寸一致
+ - **严禁使用 `<foreignObject>`**,用 `<tspan>` 手动换行
+ - 使用 `<rect>` 定义背景色
+
+
## 咨询级表达核心技巧
### 1. 数据情境化(永不孤立呈现)
@@ -313,7 +326,11 @@
## 演讲备注生成
-生成每页 SVG 后,**同步创建**对应的演讲备注文件,为高管演示提供精准讲稿支持。
+建议在**所有 SVG 页面生成完成并定稿后**,进入“逻辑构建阶段”,批量创建演讲备注文件。
+
+**为什么不一页 SVG 一页 Note?**
+- **视觉一致性**: 连续生成 SVG 能保持 AI 对坐标和样式的“上下文记忆”,避免风格漂移
+- **叙事连贯性**: 批量写备注能像写剧本一样规划转场语(Transition),确保演讲逻辑通顺
**文件命名规范**:
@@ -359,7 +376,7 @@
## 完成后的下一步
-所有 SVG 页面生成完成后,系统将**自动执行以下步骤**:
+所有 SVG 页面和演讲备注生成完成后,**你需要主动调用以下工具**进行后处理和导出:
### 1. 后处理(自动)
@@ -420,4 +437,4 @@ python3 tools/svg_to_pptx.py <项目路径> -s final
- [ ] 数据口语化表达自然
- [ ] 备选内容标记明确(应对时间调整)
-💡 **提示**:后处理和导出步骤由 AI 自动执行,无需手动干预。MBB 级演示建议在正式使用前进行完整的预演。
+💡 **提示**:后处理和导出步骤由你(Executor)主动调用工具执行。MBB 级演示建议在正式使用前进行完整的预演。
diff --git a/roles/Executor_General.md b/roles/Executor_General.md
index fd4d13bc..049ec226 100644
--- a/roles/Executor_General.md
+++ b/roles/Executor_General.md
@@ -61,7 +61,9 @@
- **绝对遵循规范**: 严格按照规范中的色彩、布局、画布格式、排版参数设计
- **遵循模板结构**: 如有模板,继承模板的视觉框架
-- **逐页生成**: 每次只生成一页 SVG 代码,直接提供代码块
+- **分阶段批量生成**(推荐):
+ 1. **视觉构建阶段**: 连续生成所有 SVG 页面,确保设计风格和布局坐标的高度一致性(Visual Consistency)
+ 2. **逻辑构建阶段**: SVG 全部定稿后,再批量生成演讲备注,确保叙事逻辑连贯(Narrative Continuity)
- **技术规范**:
- viewBox 必须与画布尺寸一致
- **严禁使用 `<foreignObject>`**,用 `<tspan>` 手动换行
@@ -215,7 +217,11 @@
## 演讲备注生成
-生成每页 SVG 后,**同步创建**对应的演讲备注文件,为演讲者提供讲稿参考。
+建议在**所有 SVG 页面生成完成并定稿后**,进入“逻辑构建阶段”,批量创建演讲备注文件。
+
+**为什么不一页 SVG 一页 Note?**
+- **视觉一致性**: 连续生成 SVG 能保持 AI 对坐标和样式的“上下文记忆”,避免风格漂移
+- **叙事连贯性**: 批量写备注能像写剧本一样规划转场语(Transition),确保演讲逻辑通顺
**文件命名规范**:
@@ -249,7 +255,7 @@
## 完成后的下一步
-所有 SVG 页面生成完成后,系统将**自动执行以下步骤**:
+所有 SVG 页面和演讲备注生成完成后,**你需要主动调用以下工具**进行后处理和导出:
### 1. 后处理(自动)
@@ -290,4 +296,4 @@ python3 tools/svg_to_pptx.py <项目路径> -s final
- 验证图片和图标显示正常
- 查看演讲备注是否正确嵌入
-💡 **提示**:后处理和导出步骤由 AI 自动执行,无需手动干预。
+💡 **提示**:后处理和导出步骤由你(Executor)主动调用工具执行。