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 阶段完成检查点与后处理指令

hugohe3b534d7239b0a
diff --git a/roles/Executor_Consultant.md b/roles/Executor_Consultant.md
index 812d6c85..0ef7cec7 100644
--- a/roles/Executor_Consultant.md
+++ b/roles/Executor_Consultant.md
@@ -139,7 +139,7 @@
<use data-icon="chart-bar" x="100" y="200" width="48" height="48" fill="#005587"/>
```
-生成后运行 `python3 tools/embed_icons.py` 一次性替换为实际代码。
+> ⚠️ **无需手动运行** `embed_icons.py`!`finalize_svg.py` 后处理工具会自动嵌入图标。
**咨询常用图标**:`chart-bar` `arrow-trend-up` `arrow-trend-down` `target` `users` `dollar` `calendar` `circle-checkmark` `shield-check` `lightbulb`
@@ -302,9 +302,32 @@
## 完成后的下一步
-> 📖 **后处理与导出流程**:参见 [generate-ppt.md](../.agent/workflows/generate-ppt.md) 阶段七、八
+> ⚠️ **强制检查点**:在进入后处理之前,**必须输出以下检查点**确认两个阶段都已完成:
+
+```markdown
+## ✅ Executor 阶段完成
+
+### 视觉构建阶段
+- [x] 所有 SVG 页面已生成到 svg_output/
+- [x] 共 XX 页
+
+### 逻辑构建阶段
+- [x] 已生成完整演讲备注 notes/total.md
+- [x] 共 XX 页备注
+```
+
+> ❌ **禁止**:未输出检查点就进入后处理!如果"逻辑构建阶段"未完成,必须先生成备注。
+
+**后处理与导出**(参见 [generate-ppt.md](../.agent/workflows/generate-ppt.md) 阶段八):
+
+```bash
+# 1. 拆分讲稿
+python3 tools/total_md_split.py <项目路径>
+
+# 2. SVG 后处理(自动嵌入图标、图片等)
+python3 tools/finalize_svg.py <项目路径>
+
+# 3. 导出 PPTX
+python3 tools/svg_to_pptx.py <项目路径> -s final
+```
-**执行师完成 SVG 和演讲备注后,需主动调用**:
-1. `python3 tools/total_md_split.py` — 拆分讲稿
-2. `python3 tools/finalize_svg.py` — 后处理
-3. `python3 tools/svg_to_pptx.py -s final` — 导出 PPTX
diff --git a/roles/Executor_Consultant_Top.md b/roles/Executor_Consultant_Top.md
index 44faaefa..02a273b6 100644
--- a/roles/Executor_Consultant_Top.md
+++ b/roles/Executor_Consultant_Top.md
@@ -223,7 +223,7 @@
<use data-icon="chart-bar" x="100" y="200" width="48" height="48" fill="#005587"/>
```
-生成后运行 `python3 tools/embed_icons.py` 一次性替换为实际代码。
+> ⚠️ **无需手动运行** `embed_icons.py`!`finalize_svg.py` 后处理工具会自动嵌入图标。
**咨询常用图标**:`chart-bar` `arrow-trend-up` `arrow-trend-down` `target` `users` `dollar` `calendar` `circle-checkmark` `shield-check` `lightbulb`
@@ -418,12 +418,34 @@
## 完成后的下一步
-> 📖 **后处理与导出流程**:参见 [generate-ppt.md](../.agent/workflows/generate-ppt.md) 阶段七、八
+> ⚠️ **强制检查点**:在进入后处理之前,**必须输出以下检查点**确认两个阶段都已完成:
-**执行师完成 SVG 和演讲备注后,需主动调用**:
-1. `python3 tools/total_md_split.py` — 拆分讲稿
-2. `python3 tools/finalize_svg.py` — 后处理
-3. `python3 tools/svg_to_pptx.py -s final` — 导出 PPTX
+```markdown
+## ✅ Executor 阶段完成
+
+### 视觉构建阶段
+- [x] 所有 SVG 页面已生成到 svg_output/
+- [x] 共 XX 页
+
+### 逻辑构建阶段
+- [x] 已生成完整演讲备注 notes/total.md
+- [x] 共 XX 页备注
+```
+
+> ❌ **禁止**:未输出检查点就进入后处理!如果"逻辑构建阶段"未完成,必须先生成备注。
+
+**后处理与导出**(参见 [generate-ppt.md](../.agent/workflows/generate-ppt.md) 阶段八):
+
+```bash
+# 1. 拆分讲稿
+python3 tools/total_md_split.py <项目路径>
+
+# 2. SVG 后处理(自动嵌入图标、图片等)
+python3 tools/finalize_svg.py <项目路径>
+
+# 3. 导出 PPTX
+python3 tools/svg_to_pptx.py <项目路径> -s final
+```
### MBB 级质量检查清单
diff --git a/roles/Executor_General.md b/roles/Executor_General.md
index 48b58532..8203db74 100644
--- a/roles/Executor_General.md
+++ b/roles/Executor_General.md
@@ -167,7 +167,7 @@
<use data-icon="rocket" x="100" y="200" width="48" height="48" fill="#0076A8"/>
```
-生成后运行 `python3 tools/embed_icons.py` 一次性替换为实际代码。
+> ⚠️ **无需手动运行** `embed_icons.py`!`finalize_svg.py` 后处理工具会自动嵌入图标。
**常用图标**:`chart-bar` `arrow-trend-up` `users` `cog` `circle-checkmark` `target` `clock` `file`
@@ -299,9 +299,32 @@
## 完成后的下一步
-> 📖 **后处理与导出流程**:参见 [generate-ppt.md](../.agent/workflows/generate-ppt.md) 阶段七、八
+> ⚠️ **强制检查点**:在进入后处理之前,**必须输出以下检查点**确认两个阶段都已完成:
+
+```markdown
+## ✅ Executor 阶段完成
+
+### 视觉构建阶段
+- [x] 所有 SVG 页面已生成到 svg_output/
+- [x] 共 XX 页
+
+### 逻辑构建阶段
+- [x] 已生成完整演讲备注 notes/total.md
+- [x] 共 XX 页备注
+```
+
+> ❌ **禁止**:未输出检查点就进入后处理!如果"逻辑构建阶段"未完成,必须先生成备注。
+
+**后处理与导出**(参见 [generate-ppt.md](../.agent/workflows/generate-ppt.md) 阶段八):
+
+```bash
+# 1. 拆分讲稿
+python3 tools/total_md_split.py <项目路径>
+
+# 2. SVG 后处理(自动嵌入图标、图片等)
+python3 tools/finalize_svg.py <项目路径>
+
+# 3. 导出 PPTX
+python3 tools/svg_to_pptx.py <项目路径> -s final
+```
-**执行师完成 SVG 和演讲备注后,需主动调用**:
-1. `python3 tools/total_md_split.py` — 拆分讲稿
-2. `python3 tools/finalize_svg.py` — 后处理
-3. `python3 tools/svg_to_pptx.py -s final` — 导出 PPTX