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.mdindex 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.mdindex 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) |++> 📋 **执行顺序**:阅读本文件 → 阅读工作流 → 开始执行++---## 三层架构导航