Marp 幻灯片演示/幻灯片组生成器

概述

从原始素材自动生成专业级 Marp 幻灯片组，并按用户需求渲染为指定格式。重点在于将笔记、数据及混合输入转化为具备明确核心观点（takeaway）的演示文稿，而非简单堆砌原始记录。

若用户未指定输出格式，则默认渲染为 .html 格式的幻灯片，并同时保留源文件 .slides.md。

输入范围

本能力可处理几乎任何可归纳为演示内容的信息，包括：

• 笔记、文档、报告、备忘录
• 表格、CSV、JSON、YAML 及各类指标数据
• 日志、会议记录、时间线、研究笔记
• 架构文档、设计文档、规划方案、RFC 文档
• 代码片段、API 描述、技术变更摘要
• 截图、图片，以及结构化与非结构化混合输入

工作流程

1. 识别目标受众、演示目的与核心观点（takeaway）。
2. 根据用户提示、目标文件名或显式扩展名，确定所请求的输出格式。
3. 若未指定格式，则默认使用 .html。
4. 对输入进行分类：数值型数据、表格型数据、文本笔记、日志、时间线、对比分析、截图、代码摘要，或混合类型。
5. 提炼出最关键的若干事实。
6. 选择幻灯片逻辑结构（slide arc）：标题页 → 背景页 → 关键洞见页 → 支持性可视化页 → 建议页 → 结束页。
7. 以 Marp Markdown 格式构建源幻灯片文件，通常命名为 *.slides.md。
8. 在必要处添加图表、示意图、时间线、强调框（callout）及分节页等视觉结构元素。
9. 调用已安装的 marp CLI 工具，将幻灯片源文件渲染为目标格式。
10. 在目标宽高比下验证渲染结果，确保无幻灯片内容被裁剪或底部内容被垂直截断。

输出规则

• 接受所有可整合为逻辑连贯演示文稿的源材料。
• 支持的渲染输出格式包括：.html（默认）、.pdf、.pptx、纯文本讲稿（notes text）、单页 .png / .jpeg，以及多页图像导出。
• 除非用户明确要求仅输出 Markdown 源文件，否则必须生成渲染后的产物（rendered artifact）。
• 若用户未指定格式，则默认渲染为 .html。
• 当渲染为其他格式时，须保留 Marp 源文件 *.slides.md。
• 若用户请求多种格式，应基于同一份 *.slides.md 源文件生成全部所需格式。
• 若用户请求不支持的格式，仅提出一个简短问题，或提供最接近的支持选项。
• 渲染过程须直接调用 marp CLI 命令完成。
• 默认采用强视觉冲击力的标题页，随后安排 4 至 8 张内容页。
• 每张幻灯片聚焦一个核心观点。
• 尽可能将表格转换为简洁要点或聚焦型对比页。
• 优先使用具体数字、百分比、趋势变化与差值（delta），避免模糊笼统的总结性描述。
• 偏好简短标题、精炼要点及有目的性的留白。
• 若用户需要讲稿（notes），需嵌入便于演讲者使用的结构化信息。
• 若某张幻灯片内容接近溢出边界，应将其拆分为两张幻灯片，而非缩小字号或元素尺寸导致难以阅读。
• 除非已确认最终渲染效果仍能完整显示，否则避免在同一张幻灯片上叠加大型表格、多卡片布局与大型强调框（callout）。

视觉模式

• 使用 mermaid 绘制流程图、时间线、漏斗图及简易系统架构图。
• 仅当能提升可读性时，才使用对比表格。
• 使用强调框（callout）突出关键结论（takeaway）。
• 对于长篇幻灯片组，使用分节页（section divider slide）提升导航性。
• 保持配色方案统一，避免视觉杂乱。
• 优先选用简洁、高对比度的版式，而非密集装饰性设计。

幻灯片组结构

• 标题页
• 背景页
• 洞见页（Insight slides）
• 可视化佐证页（Visual proof slides）
• 建议页或总结页
• 可选附录页

质量检查

• 该幻灯片组能否快速回应用户的核心问题？
• 每张幻灯片是否具备良好的视觉可扫读性（visually scannable）？
• 关键数据与结论是否一目了然？
• 整体观感是否呈现“精心设计”而非“机器生成”？
• 每张渲染后的幻灯片是否完全适配视口，无底部内容被裁剪或溢出隐藏？

参考资料

详见 references/slide-patterns.md，内含幻灯片典型模板、视觉规范及内容映射指引。

详见 references/output-formats.md，内含支持的输出格式列表、默认行为说明及渲染命令参考。

references/

该目录用于存放关于幻灯片结构与视觉决策的可复用指导原则。

assets/

本能力无需内置任何资源文件（assets）。

请保持幻灯片组简洁、可视化程度高且内容具体明确。