mcpField
P
presentation-creator

presentation-creator

github.com/mblode文档处理169893 次安装2 天前更新
代码仓库

关于 presentation-creator

presentation-creator 是用于端到端构建演示文稿的技能,面向需要规划叙事、幻灯片内容与视觉系统的人。它覆盖从故事主线到质量检查,并输出 Marp、Slidev、reveal.js 格式或 Next.js 演示应用;不直接制作 PPTX 文件。

主要功能

  1. 01规划故事主线与幻灯片顺序
  2. 02撰写幻灯片文案与演讲者备注
  3. 03设计色彩、字体和版式
  4. 04输出 Marp、Slidev 或 reveal.js 文档
  5. 05构建 Next.js 演示应用
  6. 06渲染检查版面与对比度

适用场景

  1. 01为现场演讲搭建有叙事结构的演示文稿
  2. 02制作供投资者异步阅读的路演稿
  3. 03将幻灯片内容输出为 Web 演示应用
  4. 04检查幻灯片信息密度和视觉缺陷

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mblode/agent-skills --skill presentation-creator

安装后在 Claude Code 中输入/presentation-creator确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

evals/
evals.json
references/
outline-structure.md
output-formats.md
pitch-decks.md
speaker-notes.md
story-structure.md
visual-design.md
web-deck.md
writing-slides.md

详细介绍

演示文稿创作

简洁大胆的幻灯片,讲述完整故事:从故事主线到最终质检。

  • **适用范围:**端到端创建演示文稿:故事主线、幻灯片顺序、幻灯片文案、视觉系统、演讲者备注、投资者路演演示文稿,以及以 Web 应用形式构建的演示文稿;默认输出为 Marp Markdown,也可输出 Slidev 或 reveal.js Markdown,或 Next.js 演示文稿应用。
  • **不适用范围:**制作或编辑 .pptx/.potx 文件本身(可使用现有的演示文稿/PPTX 技能或工具;将本技能生成的完整大纲、文案和备注交给它),制作幻灯片中的图表(已安装时使用外部 dataviz),撰写长篇文章、营销文案或幻灯片之外的演讲稿(使用 ghostwriter),以及设计产品 UI(使用 ui-design)。

工作流

跟踪此清单:

Presentation progress:
- [ ] Step 1: Gather context (audience, setting, venue, three messages, output format)
- [ ] Step 2: Write the story spine and the ending (references/story-structure.md)
- [ ] Step 3: Outline the slide sequence (references/outline-structure.md)
- [ ] Step 4: Write slide copy (references/writing-slides.md; pitch decks: references/pitch-decks.md instead)
- [ ] Step 5: Design colour, type, and layout (references/visual-design.md)
- [ ] Step 6: Write speaker notes (references/speaker-notes.md); skip for a deck sent without a presenter
- [ ] Step 7: Emit the deck in the chosen format (references/output-formats.md or references/web-deck.md)
- [ ] Step 8: QA pass, output the slide-by-slide review table
步骤 1:收集背景信息

确认以下事项,只询问简报中未说明的内容:

  • **受众:**内部受众(背景信息相同,表达直接)或外部受众(建立可信度,解释术语)。
  • **场合:**现场演讲、录制/异步演示,或发送给投资者、供其自行阅读的路演演示文稿。
  • **场地:**昏暗的房间或大型礼堂适合深色系统;明亮的会议室、日光环境,或需要兼作讲义的演示文稿适合浅色调。未知时请询问,因为这会影响步骤 5。
  • **三个关键信息:**演示结束后受众必须记住什么。
  • **输出格式:**除非有其他理由,使用 Marp Markdown。如果演示文稿需要运行现场演示或通过 URL 访问,则使用 Web 应用。如果用户指定了 .pptx 文件或公司的模板,则将本技能生成的大纲、文案和备注交给外部 pptx 技能制作。现在就决定,而不要等到步骤 7:格式会决定步骤 5 和步骤 6 中的类型与备注处理方式。

按场合选择流程:

  • 现场演讲、内部演示或录制演示文稿 → 按顺序执行步骤 2–8。
  • 发送给投资者阅读的路演演示文稿 → 首先查看 references/pitch-decks.md。其中的 10 页框架取代步骤 3 的大纲;其异步文案规则取代步骤 4 的 writing-slides.md(不要同时加载两者:它们的内容密度规则相互矛盾)。步骤 2 仍适用,但可简化;故事主线能避免路演演示沦为功能列表。如果同一家公司是在演示日舞台上进行现场路演,则属于现场演示文稿:采用标准流程,并以路演框架作为大纲。
步骤 2–7:构建演示文稿

到达每个步骤时,阅读对应的参考资料:

步骤参考资料涵盖内容
2. 故事references/story-structure.md故事主线模板、先写结尾、明确立场、利害关系、破局之道
3. 大纲references/outline-structure.md叙事脉络、12 种幻灯片类型、章节颜色、大纲输出格式
4. 撰写references/writing-slides.md,路演流程中由 references/pitch-decks.md 取代标题模式、正文规则、各类幻灯片的文案、前后对比示例
5. 设计references/visual-design.md两种配色系统、对比度阈值、流体与固定字号比例、版式模式、幻灯片类型与版式的对应关系
6. 备注references/speaker-notes.md单页备注结构、演讲提示、各类幻灯片的备注
7. 输出references/output-formats.mdMarp 语法和导出、Slidev 与 reveal.js 的对应方案、pptx 交接方式、各格式中备注的位置
7. 输出(Web)references/web-deck.md每页对应路由的结构、导航、布局原语、动效、现场演示
修改此技能evals/evals.json带断言的行为场景,以及 should-trigger 和 near-miss 路由提示。不会在用户任务期间加载

仅当文案完成后,才阅读 web-deck.md。在大纲之前设计布局原语,会导致它们围绕第 3 页成形,并与后续每一页产生冲突。

第 8 步:QA 检查(生成证据)

渲染交付格式并检查每张幻灯片。记录版式缺陷和测得的对比度;自行打分的快速浏览感受属于编辑判断。如有用,请将详细表格与成品一并保留,并在聊天中概述重要结果:

| # | Slide | 3-sec test | One message | Spine beat | Layout | Colour | Contrast |
|---|-------|-----------|-------------|------------|--------|--------|----------|
| 1 | Title | pass | pass | once upon a time | full statement | teal | 12.6:1 |
  • **3 秒测试:**在手臂长度的距离快速浏览,能在 3 秒内读懂(Duarte 的快速浏览测试)。任何一项未通过,都要删减文案,直到通过。路演演示文稿需要仔细阅读,而非快速浏览:改用“转发时无需上下文也能看懂”这一标准。
  • **一个要点:**每张幻灯片恰好表达一个想法;若一张幻灯片承载了两个想法,就拆分。
  • **主线节拍:**指出这张幻灯片服务于第 2 步主线中的哪个节拍。若不服务于任何节拍,它只是一个你觉得有趣的事实;删掉它。
  • **版式:**幻灯片的任务改变时,版式也应改变。若连续 3 张或更多幻灯片使用相同版式,应标记出来;只有当该部分有意采用列表形式时,才保留这种安排。
  • **颜色:**应使用所属章节的强调色,或全出血配色,并与第 5 步指定的方案一致。
  • **对比度:**检查幻灯片上最小文字与背景之间的对比度。正文和说明文字需达到 4.5:1;只有文字大小为 24px(18pt)或更大时,才可采用 3:1。记录具体比例,不要只写“合格”。

表格下方的整套演示文稿检查项:

  • 每个主线节拍至少对应一张幻灯片,且结尾与最初撰写的结尾一致
  • 演示文稿明确表达一个合理的人可能会不同意的立场
  • 全文使用同一套配色体系:按章节使用强调色,或使用全出血配色,不可两者兼用
  • 总结幻灯片每个核心部分恰好对应一行
  • 演讲者备注放在输出格式会读取的位置(Marp 和 Slidev:幻灯片末尾的 HTML 注释;reveal.js:Note: 行;.pptx:备注窗格)
  • 仅适用于路演演示文稿:最多 10 张幻灯片,另加附录;包含明确的请求页(金额及资金用途);标题通过可转发性测试

修复发现的缺陷,并再次检查受影响的幻灯片。如果无法渲染,请标注未运行视觉验证。

注意事项

  • **明亮房间里的深色演示文稿:**默认的深色系统依赖房间环境。日光下或投影仪亮度不足时,黑色背景会变灰,白色正文也会褪色。请在步骤 1 询问场地情况;如果环境明亮,就采用浅色“纸张”配色或白色背景,并在投影仪上测试,而不是只在笔记本电脑上测试。
  • **只在标题字号下检查对比度:**一组饱和的全出血配色在 100px 下清晰可读,在 20px 的说明文字字号下却可能不合格。根据实际十六进制色值,测量幻灯片上最小字号文本的对比度,并对照步骤 8 的阈值。
  • **从 Marp 或 Slidev 导出“PPTX”就算完成:**两者都会将每张幻灯片栅格化为 .pptx 中的图像。文本无法选择或编辑,因此客户想要编辑的演示文稿最终只是一摞图片。如果交付物是可编辑的 PowerPoint,请转用 pptx 技能。
  • 在 Marp 中,备注和指令都放在 HTML 注释里: 是指令, 是演讲者备注。若备注以一行 key: value 开头,它会悄无声息地变成指令。
  • **网页演示文稿使用固定像素字号:**为演讲者笔记本电脑设计的演示文稿,在投影仪上会变成另一种尺寸,在转发后用手机查看时则会难以阅读。请使用 clamp() 设置字号;Marp 和 .pptx 演示文稿使用固定画布,应改用 pt 字号。
  • **通过电子邮件发送的路演演示文稿却采用现场演示的内容密度:**每张幻灯片只有 3 个词的演示文稿,转发后没有演讲者讲解就难以理解。应在步骤 1 转用 pitch-decks.md,而不是等演示文稿做好后再改。反过来也不行:在演示日现场展示一张有 60 个词的幻灯片。
  • **跳过主线:**直接开始制作幻灯片,会产出一份缺乏叙事脉络的事实清单,等发现叙事缺失时又得重写。先确定主线和结尾。
  • **把演讲者备注写成讲稿:**逐字讲稿会被照着念,听起来平淡无味。备注应作为提示:要点、演讲提纲,以及过渡语。
  • **在章节配色系统之外使用强调色:**章节颜色用于指引方向;在章节中随机使用强调色,会让人误以为主题变了。全出血演示文稿中,幻灯片本身就是强调色;颜色应在幻灯片边界处变化,而不是在幻灯片内部变化。
  • **在幻灯片上放段落:**观众会低头阅读而不是听讲,演讲者也就显得多余。删减内容,直到通过 3 秒测试。

相关技能

  • 如已安装,可使用外部 pptx 技能(anthropics/skills)创建、编辑和 QA .pptx 文件。本技能负责故事、提纲、文案和备注;如果 .pptx 内部出现视觉冲突,以本技能的配色系统和字体层级为准,而字体、边距和备注的实现方式则以 pptx 技能为准。
  • 如已安装,可使用外部 dataviz 技能制作幻灯片中的任何图表或指标卡片。
  • ghostwriter:用于演示文稿以外的营销文案,以及当 blog 配置的输出为长篇文章而非幻灯片时撰写文章。
  • ui-design:用于产品 UI 和落地页的视觉系统;演示文稿的视觉规则则见 references/visual-design.md。

评论

支持 Markdown