Marp Slides Creator

Marp Slides 制作助手

技能概述

本技能提供系统性多阶段Marp演示文稿制作流程，从工作空间初始化到终稿输出。对于中文演示文稿，额外包含中文语言规范审阅阶段。所有分析报告、初稿、审阅文档、PNG导出和终稿统一保存在项目工作文件夹中，便于管理和追溯。

支持多种主题风格：内置 14 款精选主题，涵盖学术、商务、创意等场景。详见 themes/README.md。

核心原则

Slides设计原则

内容密度控制

• 标题页：主标题 + 副标题 + 作者信息
• 内容页：标题 + 3-5个要点（每点1-2行）
• 对比页：两栏对比，每栏不超过4点
• 总结页：3-5个核心要点

七阶段工作流程

严格按照以下流程执行，每阶段结束后询问用户确认：

阶段零：工作空间初始化与主题选择（预处理）

触发：用户请求制作slides时立即执行

执行步骤：

1. 确定项目名称：

   • 根据用户提供的主题/文件名确定项目名称
   • 使用简短的英文或拼音命名，用连字符连接
   • 示例：academic-writing、ai-introduction、product-launch

2. 创建工作文件夹结构：

   # 创建主工作文件夹和子目录
   mkdir -p slides_[项目名]/{01_analysis,02_drafts,03_reviews,04_exports,05_final}
   

3. 文件夹结构说明：

   slides_[项目名]/
   ├── 01_analysis/           # 阶段一：分析报告
   │   ├── content-analysis.md   # 内容分析报告
   │   └── outline.md            # Slides大纲
   ├── 02_drafts/             # 阶段二：初稿
   │   └── presentation.md       # Slides初稿
   ├── 03_reviews/            # 阶段三：审阅报告
   │   ├── content-review.md     # 内容审阅
   │   ├── format-review.md      # 格式审阅
   │   ├── density-review.md     # 密度审阅
   │   ├── visual-review.md      # 视觉审阅
   │   ├── chinese-review.md     # 中文规范审阅（仅中文）
   │   └── summary.md            # 综合审阅报告
   ├── 04_exports/            # 阶段四：PNG/HTML导出
   │   ├── slide_001.png
   │   ├── slide_002.png
   │   └── slides.html
   ├── 05_final/              # 阶段五：终稿
   │   ├── presentation.md       # 最终Markdown
   │   ├── slides.html           # HTML版本
   │   └── slides.pdf            # PDF版本（可选）
   └── README.md              # 项目说明文件
   

4. 主题选择：

   使用 AskUserQuestion 工具让用户选择主题风格：

   questions:
     - question: "请选择演示文稿的主题风格"
       header: "主题风格"
       multiSelect: false
       options:
         - label: "academic (学术风格)"
           description: "适合学术报告、论文答辩，maroon红色标题栏"
         - label: "beam (Beamer风格)"
           description: "仿LaTeX Beamer，适合学术演讲、技术研讨"
         - label: "jobs (乔布斯风格)"
           description: "Apple发布会风格，适合产品发布、商业演示"
         - label: "graph_paper (方格纸风格)"
           description: "技术分享、教学演示，手写笔记感"
   

   可用主题列表（按场景分类）：

   场景	主题选项
   学术答辩	academic, beam, zju
   技术分享	graph_paper, beam, turing
   产品发布	jobs, gradient
   企业汇报	companyLightBlue, companySZ
   教学演示	simple, graph_paper, academic
   创意展示	gradient, jobs, socrates

   主题文件位置：themes/ 目录下所有 .css 文件

5. 创建README.md：

   # [项目名] Slides
   
   ## 项目信息
   - 创建时间：[日期]
   - 输入材料：[原始文件名]
   - 主题：[主题描述]
   - **使用主题**：[选择的主题名称，如 academic/beam/jobs 等]
   
   ## 文件夹说明
   - `01_analysis/` - 内容分析和大纲
   - `02_drafts/` - Slides初稿
   - `03_reviews/` - 审阅报告
   - `04_exports/` - PNG和HTML导出
   - `05_final/` - 最终版本
   
   ## 制作进度
   - [ ] 阶段零：工作空间初始化
   - [ ] 阶段一：内容分析
   - [ ] 阶段二：初稿制作
   - [ ] 阶段三：多维度审阅
   - [ ] 阶段三B：中文语言规范审阅（仅中文演示文稿）
   - [ ] 阶段四：PNG转换检查
   - [ ] 阶段五：问题修复与终稿
   

输出：工作文件夹路径、选择的主题名称，告知用户所有产出物将保存在此文件夹中

阶段一：内容分析与消化

触发：工作空间创建完成后，用户提供输入文件（PDF、论文、文档、笔记等）

执行步骤：

1. 初步阅读：使用 Read 工具读取输入文件，了解整体结构
2. 深度分析：
   • 提取核心论点和关键信息
   • 识别逻辑结构（问题-方案-结论 / 现状-分析-建议 等）
   • 标记重要数据、引用、案例
3. 内容分类：
   • 核心观点（必须包含）
   • 支撑证据（选择性包含）
   • 背景信息（简化或省略）
4. 大纲生成：
   • 确定slides数量（建议10-20页）
   • 规划每页主题和内容密度
   • 设计叙事流程

文件保存：

• 内容分析报告：slides_[项目名]/01_analysis/content-analysis.md
• Slides大纲：slides_[项目名]/01_analysis/outline.md

输出模板：

01_analysis/content-analysis.md:

## 内容分析报告

### 文档概述
- 主题：[主题]
- 类型：[论文/报告/教程/...]
- 核心论点：[1-2句话]

### 关键内容提取
1. [关键点1]
2. [关键点2]
...

01_analysis/outline.md:

## Slides大纲（预计X页）

1. 标题页
2. [内容页标题]
3. ...

阶段二：Slides初稿制作

触发：用户确认内容分析和大纲

执行步骤：

1. 读取模板：使用 Read 工具读取 marp-template.md

2. 应用主题：

   • 在 YAML frontmatter 中设置用户选择的主题：

     ---
     marp: true
     theme: [用户选择的主题名]
     ---
     

   • 不同主题可能支持特殊的 class，参考 themes/README.md

3. 主题适配（自动调整）：

   不同主题对标题格式有不同要求，制作 slides 时必须根据主题自动调整：

   主题	内容页标题格式	说明
   beam	# (h1)	h1 显示在顶部蓝色条中
   academic	# (h1)	h1 用于页面标题
   jobs	# (h1)	h1 有特殊下划线样式
   graph_paper	## (h2)	标准 h2 标题
   simple	## (h2)	标准 h2 标题
   其他主题	## (h2)	默认使用 h2

   beam 主题特殊处理：

   • 每页第一个 # (h1) 会自动显示在顶部蓝色装饰条中
   • 标题页使用 <!-- _class: title --> 指令
   • 内容页直接使用 # 标题（不是 ##）
   • 示例：

     ---
     # 页面标题在蓝色条中
     
     正文内容...
     

   academic/jobs 主题特殊处理：

   • 同样使用 # (h1) 作为页面标题
   • 支持 class: lead 用于特殊页面

4. 修改Header/Footer：根据演讲主题调整

5. 逐页制作：

   • 遵循模板中的页面类型和格式
   • 每页严格控制内容量
   • 使用适当的Markdown格式（粗体、引用、列表）

页面类型选择（参考 references/slide-types.md）：

• 标题页：开场
• 目录页：内容预告
• 单点页：核心观点展示
• 列表页：多要点展示
• 对比页：两种观点/方案对比
• 引用页：重要引用展示
• 分隔页：章节过渡
• 总结页：要点回顾

文件保存：

• 保存初稿：slides_[项目名]/02_drafts/presentation.md
• 更新README.md中的进度状态

阶段三：多维度并行审阅

触发：初稿完成后自动进入

执行方式：使用 Task 工具并行派遣4个专业agent，每个负责一个审阅维度

并行Agent部署：

在单个消息中同时发起4个Task调用，设置 run_in_background=true：

Agent 1：内容审阅专家

Task 工具参数：
- subagent_type: "general-purpose"
- run_in_background: true
- prompt:

你是一个内容审阅专家。请对比审阅slides内容。

## 输入材料

### 用户原始输入文件
[插入用户提供的原始文件内容]

### 用户的具体要求
[插入用户提出的要求和偏好]

### 制作的Slides初稿
[插入presentation.md内容]

## 审阅任务

1. **完整性检查**：
   - 原始材料中的核心论点是否都已体现？
   - 是否有重要信息被遗漏？
   - 列出遗漏的关键内容

2. **准确性检查**：
   - slides内容是否准确反映原始材料？
   - 是否有曲解或过度简化？
   - 数据和事实是否正确转述？

3. **用户要求符合度**：
   - 是否满足用户提出的具体要求？
   - 风格和重点是否符合用户期望？
   - 列出未满足的要求

4. **逻辑流检查**：
   - 叙事顺序是否合理？
   - 各页之间过渡是否自然？
   - 整体结构是否清晰？

## 输出格式

### 内容审阅报告

#### 完整性评估
- 评分：[A/B/C/D]
- 遗漏内容：[列表]

#### 准确性评估
- 评分：[A/B/C/D]
- 问题页面：[页码和问题描述]

#### 用户要求符合度
- 评分：[A/B/C/D]
- 未满足要求：[列表]

#### 逻辑流评估
- 评分：[A/B/C/D]
- 建议调整：[具体建议]

#### 需修改页面清单
| 页码 | 问题类型 | 问题描述 | 修改建议 |
|------|----------|----------|----------|
| ... | ... | ... | ... |

Agent 2：格式审阅专家

Task 工具参数：
- subagent_type: "general-purpose"
- run_in_background: true
- prompt:

你是一个Marp格式审阅专家。请检查slides的格式规范性。

## Slides内容
[插入presentation.md内容]

## 审阅任务

1. **YAML Frontmatter检查**：
   - marp: true 是否存在？
   - theme 是否正确设置？
   - header/footer 是否配置？
   - style 块语法是否正确？

2. **分页符检查**：
   - `---` 分页符是否正确使用？
   - 是否有多余或缺失的分页符？
   - 分页符前后是否有空行？

3. **Markdown语法检查**：
   - 标题层级是否正确（#, ##, ###）？
   - 列表格式是否统一？
   - 粗体、斜体语法是否正确？
   - 引用块语法是否正确？
   - 代码块是否正确闭合？

4. **缩进和空行检查**：
   - 缩进是否一致？
   - 空行使用是否规范？
   - 是否有多余的空白字符？

## 输出格式

### 格式审阅报告

#### 语法正确性
- 评分：[A/B/C/D]
- 语法错误：[列表，含行号]

#### 格式一致性
- 评分：[A/B/C/D]
- 不一致处：[列表]

#### 需修正项
| 行号 | 问题类型 | 原内容 | 建议修正 |
|------|----------|--------|----------|
| ... | ... | ... | ... |

Agent 3：密度审阅专家

Task 工具参数：
- subagent_type: "general-purpose"
- run_in_background: true
- prompt:

你是一个slides内容密度审阅专家。请逐页检查内容密度。

## Slides内容
[插入presentation.md内容]

## 密度标准

| 指标 | 安全值 | 警告值 | 危险值 |
|------|--------|--------|--------|
| 每页文字行数 | ≤6行 | 7-8行 | >8行 |
| 每行字符数 | ≤35字符 | 36-45字符 | >45字符 |
| 列表项数量 | ≤5项 | 6项 | >6项 |
| 嵌套列表深度 | 1层 | 2层 | >2层 |
| 段落长度 | ≤2行 | 3行 | >3行 |

## 审阅任务

逐页分析：
1. 统计每页的文字行数
2. 检查最长行的字符数
3. 统计列表项数量
4. 检查是否有过长段落
5. 评估整体视觉密度

## 输出格式

### 密度审阅报告

#### 逐页密度分析

| 页码 | 行数 | 最长行 | 列表项 | 密度评级 | 状态 |
|------|------|--------|--------|----------|------|
| 1 | X | X字符 | X项 | 低/中/高 | ✓/⚠/✗ |
| 2 | ... | ... | ... | ... | ... |

#### 高密度页面（需处理）
- 第X页：[问题描述]，建议：[拆分/精简/重组]
- ...

#### 拆分建议
对于需要拆分的页面，提供具体拆分方案：
- 第X页 → 拆分为 X-1 和 X-2
  - X-1 内容：...
  - X-2 内容：...

Agent 4：视觉审阅专家

Task 工具参数：
- subagent_type: "general-purpose"
- run_in_background: true
- prompt:

你是一个slides视觉设计审阅专家。请检查视觉层次和设计规范。

## Slides内容
[插入presentation.md内容]

## 审阅任务

1. **标题层次检查**：
   - 每页是否有清晰的标题？
   - 标题层级使用是否合理？
   - h1用于分隔页，h2用于内容页？

2. **强调元素检查**：
   - 粗体是否用于关键词/要点？
   - 引用块是否用于重要引语？
   - 强调是否过度（全篇都是粗体）？

3. **视觉焦点检查**：
   - 每页是否有明确的视觉焦点？
   - 信息层次是否清晰？
   - 是否有页面过于平淡或过于杂乱？

4. **一致性检查**：
   - 相似内容的页面格式是否统一？
   - 列表符号是否一致？
   - 整体风格是否协调？

## 输出格式

### 视觉审阅报告

#### 标题层次
- 评分：[A/B/C/D]
- 问题页面：[列表]

#### 强调使用
- 评分：[A/B/C/D]
- 改进建议：[列表]

#### 视觉焦点
- 评分：[A/B/C/D]
- 需优化页面：[列表]

#### 一致性
- 评分：[A/B/C/D]
- 不一致处：[列表]

#### 需修改页面清单
| 页码 | 问题 | 建议 |
|------|------|------|
| ... | ... | ... |

汇总审阅结果：

使用 TaskOutput 工具收集4个agent的报告，整合为统一的审阅报告。

文件保存：

• 内容审阅报告：slides_[项目名]/03_reviews/content-review.md
• 格式审阅报告：slides_[项目名]/03_reviews/format-review.md
• 密度审阅报告：slides_[项目名]/03_reviews/density-review.md
• 视觉审阅报告：slides_[项目名]/03_reviews/visual-review.md
• 综合审阅报告：slides_[项目名]/03_reviews/summary.md

综合审阅报告模板 (03_reviews/summary.md):

## 综合审阅报告

### 各维度评分

| 维度 | 评分 | 主要问题 |
|------|------|----------|
| 内容 | [A-D] | [概述] |
| 格式 | [A-D] | [概述] |
| 密度 | [A-D] | [概述] |
| 视觉 | [A-D] | [概述] |

### 需修改页面汇总

[按页码整合所有agent的修改建议]

### 优先处理项

1. [最重要的问题]
2. [次重要的问题]
...

输出：综合审阅报告，按优先级排列的修改清单

阶段三B：中文语言规范审阅（仅中文演示文稿）

触发：多维度审阅完成后，如果是中文演示文稿则执行此阶段

执行方式：使用 Task 工具派遣 subagent 执行

Subagent 调用指令：

使用 Task 工具，设置 subagent_type="general-purpose"，prompt 内容如下：

你是一个中文语言规范专家。请对以下Marp Slides进行逐页审阅，确保符合中文书写规范和演示文稿语言习惯：

[插入 slides_[项目名]/02_drafts/presentation.md 的内容]

审阅要求：

1. **标点符号检查**：
   - 必须使用中文标点：。，？！：；“” ‘’（）……——
   - 禁止使用英文标点：. , ? ! : ; ""'' () ... --
   - 列表项末尾可省略句号
   - 标题末尾不加标点

2. **引号使用规范**（重要）：
   - 原则：Slides中能不用引号就不用，让文字更简洁
   - 删除不必要的引号，例如：
     - ✗ 这就是所谓的"核心概念" → ✓ 这就是核心概念
     - ✗ AI的"智能"表现 → ✓ AI的智能表现
   - 仅在以下情况保留引号：
     - 直接引语（如：他说："……"）
     - 表示反讽或特殊含义
     - 专有名词首次出现且需要解释

3. **语言习惯检查**：
   - 避免欧化句式（如"被"字句滥用）
   - 避免翻译腔
   - 删除冗余表达（Slides需要极简文字）
   - 使用自然的中文表达顺序
   - 避免长句，每个要点保持简短

4. **中英文混排规范**：
   - 中文与英文/数字之间加空格（如：Claude Code 是工具）
   - 全角标点与英文之间不加空格
   - 技术术语保持一致（如：API、SDK 等全文统一）

5. **Slides特有检查**：
   - 标题是否简洁有力
   - 要点是否用词精准
   - 是否避免了口语化表达
   - 专业术语是否一致

输出格式：

## 中文规范审阅报告

### 标点符号修正
| 页码 | 原文 | 修正后 |
|------|------|--------|
| ... | ... | ... |

### 引号精简
| 页码 | 修改内容 |
|------|----------|
| ... | 删除"xxx"的引号 |

### 表达优化
| 页码 | 原表达 | 优化后 |
|------|--------|--------|
| ... | ... | ... |

### 中英文混排修正
| 页码 | 原文 | 修正后 |
|------|------|--------|
| ... | ... | ... |

### 修正后的完整Slides
[输出完成所有修正的Slides内容]

文件保存：

• 中文规范审阅报告：slides_[项目名]/03_reviews/chinese-review.md

后续处理：

• 收到 subagent 返回的审阅报告后，使用 Edit 工具将修正应用到 slides_[项目名]/02_drafts/presentation.md
• 将修正后的Slides传递给阶段四

阶段四：PNG转换与并行检查

触发：审阅修改完成后

执行步骤：

1. 转换为PNG：

   # 从02_drafts读取初稿，导出到04_exports
   marp slides_[项目名]/02_drafts/presentation.md -o slides_[项目名]/04_exports/slides.html --html
   marp slides_[项目名]/02_drafts/presentation.md --images png -o slides_[项目名]/04_exports/
   

2. 并行部署Agents检查： 使用 Task 工具并行派遣多个 subagent，每个检查一组页面：

   使用 Task 工具，设置 subagent_type="general-purpose"，run_in_background=true
   
   派遣多个agents（根据总页数，每个agent检查3-5页）：
   
   Agent 1: 检查第1-5页
   Agent 2: 检查第6-10页
   Agent 3: 检查第11-15页
   ...
   
   每个Agent的prompt：
   
   你是一个slides视觉质量检查专家。请检查以下PNG图片：
   
   [使用Read工具读取 slides_[项目名]/04_exports/ 中对应的PNG文件]
   
   检查要点：
   1. 文字是否超出页面边界？
   2. 内容是否过于拥挤？
   3. 文字是否过小难以阅读？
   4. 布局是否平衡？
   5. 是否有明显的格式问题？
   
   输出格式：
   ## 页面检查报告
   
   ### 第X页
   - 状态：通过 / 需修改
   - 问题：[问题描述]
   - 建议：[修改建议，如"拆分为两页"或"精简第3个要点"]
   

3. 汇总检查结果：使用 TaskOutput 工具收集所有agent的报告

文件保存位置：

• HTML预览：slides_[项目名]/04_exports/slides.html
• PNG图片：slides_[项目名]/04_exports/presentation.001.png, presentation.002.png, ...

阶段五：问题修复与终稿确定

触发：收到所有页面检查报告

执行步骤：

1. 问题分类：

   • 溢出问题：文字超出页面 → 拆分页面或精简内容
   • 密度问题：内容过多 → 删减或重组
   • 格式问题：排版错误 → 修正Markdown
   • 可读性问题：字太小/太密 → 调整层次

2. 逐一修复： 使用 Edit 工具修改 slides_[项目名]/02_drafts/presentation.md，针对每个问题：

   • 拆页策略：将一页拆为"概述页"+"详情页"
   • 精简策略：删除次要信息，保留核心
   • 重组策略：调整信息层次，使用更合适的页面类型

3. 重新验证：

   • 再次转换为PNG到 04_exports/
   • 快速检查修改后的页面
   • 确认问题已解决

4. 生成终稿： 将修复后的文件复制到 05_final/ 并导出最终版本：

   # 复制终稿Markdown
   cp slides_[项目名]/02_drafts/presentation.md slides_[项目名]/05_final/presentation.md
   
   # 导出最终HTML（带自定义主题）
   npx @marp-team/marp-cli slides_[项目名]/05_final/presentation.md -o slides_[项目名]/05_final/slides.html --html --theme-set ./themes/
   

5. 导出多格式版本：

   使用 marp-cli 导出 PDF 和 PowerPoint 格式：

   # 导出 PDF 版本
   npx @marp-team/marp-cli slides_[项目名]/05_final/presentation.md -o slides_[项目名]/05_final/slides.pdf --theme-set ./themes/ --allow-local-files
   
   # 导出可编辑的 PowerPoint (PPTX) 版本
   npx @marp-team/marp-cli slides_[项目名]/05_final/presentation.md -o slides_[项目名]/05_final/slides.pptx --pptx-editable --theme-set ./themes/ --allow-local-files
   

   导出说明：

   • --allow-local-files：允许加载本地图片和资源
   • --theme-set ./themes/：加载自定义主题目录
   • --pptx-editable：导出可编辑的 PPTX（需要系统安装 LibreOffice）
   • PDF 适合打印和分发
   • PPTX 适合在 PowerPoint/Keynote 中进一步编辑

   注意：--pptx-editable 需要系统安装 LibreOffice Impress。如未安装，可使用 Homebrew 安装：

   brew install --cask libreoffice
   

6. 更新项目README： 更新 slides_[项目名]/README.md 中的进度，标记所有阶段为完成。

终稿文件位置：

• 最终Markdown：slides_[项目名]/05_final/presentation.md
• HTML版本：slides_[项目名]/05_final/slides.html
• PDF版本：slides_[项目名]/05_final/slides.pdf
• PowerPoint版本：slides_[项目名]/05_final/slides.pptx

输出：终稿文件路径（包含 HTML、PDF、PPTX 三种格式）和制作摘要

常见问题处理

文字溢出

原因：单页内容过多

解决方案：

1. 拆分法：将内容拆分为多页

   ## 原始页面：五个要点
   
   拆分为：
   
   ## 要点概览（1/2）
   1. 要点一
   2. 要点二
   3. 要点三
   
   ---
   
   ## 要点概览（2/2）
   4. 要点四
   5. 要点五
   

2. 精简法：删除次要信息

3. 层次法：使用子列表缩短主列表

代码块过长

解决方案：

• 只展示关键代码片段
• 使用伪代码替代完整代码
• 分多页展示，每页一个逻辑单元

表格过大

解决方案：

• 拆分为多个小表格
• 转换为列表形式
• 只展示关键数据行

模板使用说明

模板文件 marp-template.md 包含：

• graph_paper主题配置
• 中文字体支持
• 蓝色引用块样式
• 多种页面类型示例

修改Header/Footer：

header: '你的课程/演讲标题'
footer: "讲座标题 | 机构名称"

资源引用

参考文件

• marp-template.md - Marp模板文件
• references/slide-types.md - 页面类型详解
• references/review-checklist.md - 审阅检查清单
• themes/README.md - 主题说明文档
• themes/*.css - 14款精选主题文件

Marp-CLI 命令参考

# 预览初稿（启动本地服务器，加载自定义主题）
npx @marp-team/marp-cli -s slides_[项目名]/02_drafts/presentation.md --theme-set ./themes/

# 导出初稿到04_exports（使用自定义主题）
npx @marp-team/marp-cli slides_[项目名]/02_drafts/presentation.md -o slides_[项目名]/04_exports/slides.html --html --theme-set ./themes/
npx @marp-team/marp-cli slides_[项目名]/02_drafts/presentation.md --images png -o slides_[项目名]/04_exports/ --theme-set ./themes/

# 导出终稿到05_final（HTML）
npx @marp-team/marp-cli slides_[项目名]/05_final/presentation.md -o slides_[项目名]/05_final/slides.html --html --theme-set ./themes/

# 导出终稿 PDF 版本
npx @marp-team/marp-cli slides_[项目名]/05_final/presentation.md -o slides_[项目名]/05_final/slides.pdf --theme-set ./themes/ --allow-local-files

# 导出终稿可编辑 PowerPoint (PPTX) 版本
npx @marp-team/marp-cli slides_[项目名]/05_final/presentation.md -o slides_[项目名]/05_final/slides.pptx --pptx-editable --theme-set ./themes/ --allow-local-files

参数说明：

导出格式说明：

交互规范

1. 每阶段结束后询问用户是否继续
2. 内容分析后让用户确认大纲再继续
3. 检查发现问题时，说明问题和建议的修复方案
4. 提供选择时给出推荐选项和理由

禁止事项

• 不跳过内容分析直接制作slides
• 不在单页放置过多内容
• 不使用过小的字体或过密的排版
• 不忽略PNG检查结果
• 不输出未经验证的终稿