mcpField
S
slide-wright

slide-wright

github.com/arifszn文档处理65115 次安装4 天前更新
代码仓库

关于 slide-wright

slide-wright 是将主题或粗略笔记制作成独立 HTML 演示文稿的技能,适用于需要策略或产品汇报材料的人。新建时先提交主题和两页预览,获得批准后再完成整套幻灯片。

主要功能

  1. 01从主题或笔记生成演示文稿
  2. 02先提供主题方案与两页预览
  3. 03批准后制作完整幻灯片
  4. 04在现有演示文稿中直接编辑
  5. 05支持导出 PDF 或 PowerPoint

适用场景

  1. 01把研究笔记整理成汇报演示文稿
  2. 02先确认视觉方向再制作整套幻灯片
  3. 03修改已有的 reveal.js HTML 演示文稿

安装

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

$npx skills add https://github.com/arifszn/slide-wright --skill slide-wright

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

包含的文件

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

README.md
INSTALL.md
package.json
LICENSE
.claude-plugin/
marketplace.json
.github/workflows/
test.yml
slide-wright/.claude-plugin/
plugin.json
slide-wright/references/
code-slides.md
deck-template.md
design-aesthetics.md
deploy.md
motion-recipes.md
export-pdf.md
media.md
export-pptx.md
theme-generation.md
exhibits.md
new-deck.md
slide-wright/scripts/
export-pptx.mjs
check-deck.mjs
slide-wright/scripts/lib/
deps.mjs
extract.mjs
package.mjs
tests/
export-pptx.test.mjs
tests/fixtures/
webfonts.html
edge.html
code.html
basic.html
tests/lib/
offline.mjs
pixels.mjs

详细介绍

slide-wright

将主题或粗略笔记转化为适合董事会展示的演示文稿:幻灯片应达到优秀战略或产品团队制作的演示文稿水准,并以一个可在任何浏览器中运行的独立 HTML 文件交付。

定义此技能的规则

先提出设计方向,再制作演示文稿。首次处理时,绝不直接生成完整的演示文稿。你要先设计一个主题,用它制作两张幻灯片的预览,然后暂停,等待用户批准方向。只有获得批准后,才能制作其余内容。

一次只提出一个方案,不要给出选项菜单。如果用户不同意,就舍弃这个方向,尝试一个明显不同的方案。每个主题都要为当前演示文稿专门设计;不使用预设主题库。

**新建演示文稿:先阅读 slide-wright/references/new-deck.md。**其中包含步骤 1-4(构思演示文稿、提出设计方向、获得同意、制作演示文稿)以及确切的审批门槛。

引擎(仅供内部使用)

演示文稿使用从 CDN 加载的 reveal.js 渲染,但这是实现细节,用户无需知晓。只讨论幻灯片、主题和设计;库的名称只出现在生成的 <link> 和 <script> 标签中。slide-wright/references/deck-template.md 包含确切的设置方法。

编辑已有演示文稿

如果用户提供了现有的 HTML 演示文稿,检查它是否基于 reveal.js 构建(查找来自 CDN 的 reveal.js <link>/<script> 标签)。如果是——无论这个技能是否制作了它——都不要从头开始:阅读并保留其主题,直接在原文档中进行修改。其设计方向已获批准,因此跳过提案和审批环节。编辑后,运行 node <skill-dir>/scripts/check-deck.mjs <deck.html>,并修复它打印的所有问题(详情见 slide-wright/references/new-deck.md)。

除非要添加新的展示类型(阅读 slide-wright/references/exhibits.md)、代码(阅读 slide-wright/references/code-slides.md)或动画(阅读 slide-wright/references/motion-recipes.md),否则编辑不需要参考文件。

如果 HTML 演示文稿使用的不是 reveal.js(例如其他引擎、纯幻灯片等),则不属于此技能的编辑范围——请说明这一点,不要强行改用其他引擎重写。本文其余内容均适用于新建演示文稿。

步骤 5 — 交付

  1. 打开制作完成的演示文稿。
  2. 告知用户文件位置、主题名称和幻灯片数量。
  3. 告诉用户如何操作:使用方向键、空格键或滑动切换;按 F 进入全屏,按 Esc 或 O 查看幻灯片总览,按 S 打开含备注的演讲者视图;在 URL 后添加 ?print-pdf 并打印即可保存为 PDF(步骤见 slide-wright/references/export-pdf.md);主题颜色位于 :root 变量中,字体位于 <link> 中。
  4. 提供接下来的常见选项:修改内容、更换主题、导出 PDF、导出 PowerPoint 文件(slide-wright/references/export-pptx.md),或部署到线上 URL以便分享。如果用户想部署,请阅读 slide-wright/references/deploy.md,并让他们选择托管服务(Surge、Vercel 或 Netlify)——不要自行假定。

参考文件

按需查阅这些文件,不要一次性全部阅读:

  • slide-wright/references/new-deck.md — 新建演示文稿的步骤 1-4:梳理演示文稿、提出视觉风格方案、征求确认、制作演示文稿
  • slide-wright/references/design-aesthetics.md — 让演示文稿看起来经过设计的要素(步骤 2)
  • slide-wright/references/theme-generation.md — 创建主题的流程(步骤 2)
  • slide-wright/references/deck-template.md — HTML 框架、布局和引擎设置(步骤 2 和 4)
  • slide-wright/references/exhibits.md — 为每张内容页选择并构建视觉元素(步骤 2 和 4)
  • slide-wright/references/code-slides.md — 代码页及其标记规范(步骤 4)
  • slide-wright/references/motion-recipes.md — 动画,仅在用户提出需求时使用(步骤 4)
  • slide-wright/references/media.md — 幻灯片中的图像和视频(步骤 4)
  • slide-wright/references/export-pdf.md — 将演示文稿保存为 PDF(步骤 5)
  • slide-wright/references/export-pptx.md — 将演示文稿导出为 PowerPoint,同时保留可编辑文本(步骤 5)
  • slide-wright/references/deploy.md — 将演示文稿发布到在线 URL(步骤 5)

评论

支持 Markdown