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): 优化工作流与规则手册的交叉引用与执行顺序

hugohe36528fe456f23
diff --git a/.agent/workflows/generate-ppt.md b/.agent/workflows/generate-ppt.md
index 0420175d..a14913b9 100644
--- a/.agent/workflows/generate-ppt.md
+++ b/.agent/workflows/generate-ppt.md
@@ -5,21 +5,48 @@ description: 从 Markdown 源文档生成 PPT 的完整流程(主入口)
# PPT 生成工作流
> 📌 **这是 PPT Master 系统的主执行流程**。所有 PPT 生成任务都应从此工作流开始。
->
-> 📖 **规则手册**:执行本流程时,**必须同时遵守 [AGENTS.md](../../AGENTS.md)** 中的所有规则与约束。
-本工作流用于从 Markdown 源文档生成 PowerPoint 演示文稿。
+---
+
+## ⚠️ 阶段零:强制前置检查(不可跳过)
+
+**在执行任何步骤之前,必须完成以下检查:**
+
+### 检查项 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/)** | 角色定义 | "谁来做"(专业能力、职责范围) |
-> ⚠️ **强制要求**:执行任何步骤前,必须先阅读 [AGENTS.md](../../AGENTS.md) 中的「角色切换协议」章节。
-
---
## 工作流概览
diff --git a/AGENTS.md b/AGENTS.md
index edc072a5..9c2df53c 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,8 +1,20 @@
-# AGENTS.md — 规则手册
+# AGENTS.md — 规则手册(必读)
-> 📋 **本文件定位**:AI 代理协作的**规则与约束**,不包含具体流程和角色详情。
+> ⚠️ **AI 代理注意**:本文件是 PPT Master 系统的**规则总纲**,执行任何工作流之前必须先阅读本文件。
>
-> 🚀 **执行入口**:开始生成 PPT 请使用 **[/generate-ppt 工作流](.agent/workflows/generate-ppt.md)**(主入口)
+> 如果你是通过 `/generate-ppt` 或 `/create-template` 进入的,请确认已阅读本文件后再继续。
+
+---
+
+## 🚀 快速入口
+
+| 任务 | 工作流 |
+|------|--------|
+| **生成 PPT** | [/generate-ppt](.agent/workflows/generate-ppt.md) |
+
+> 📋 **执行顺序**:阅读本文件 → 阅读工作流 → 开始执行
+
+---
## 三层架构导航