Communitygithub.com

sharonzhang98/editorial-pptx-deck

Cursor Agent 技能:从 HTML 幻灯片构建可编辑、简约风格的商务 PPTX 演示文稿。

editorial-pptx-deck 是什么?

该技能(Skill)可从一组结构化的 HTML 幻灯片文件生成精美的、符合编辑风格的 PPTX 演示文稿。它特别适合需要确保最终输出的 `.pptx` 文件完全可编辑(文本、图片均可直接在 PowerPoint 中双击修改)的场景,而无需依赖 HTML 或 PDF 查看器。技能支持在 Cursor 等 AI 编程助手中使用,通过一个严格的构建流程:计划叙事 → 编写 HTML 幻灯片(使用预定义模板)→ 检查尺寸溢出 → 导出 `.pptx` → 清理构建文件。它提供了一个完整的设计系统(CSS tokens),包含极简的配色方案、字体和“红色竖线+小号字母间距标题”的标志性样式,并且内置了图片库和多种模板类型(封面、分节页、三栏版式、对比表格、暗色面板等)。核心限制在于 HTML 到 PPTX 的转换引擎,要求文本必须放在 `<p>` 或 `<h1>`-`<h6>` 中,禁止使用 CSS 渐变、`background-image` 等,以确保转换不出错。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add sharonzhang98/editorial-pptx-deck

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

预览

来自技能 README

editorial-pptx-deck preview

文档

编辑风格 PPTX 演示文稿

生成一份精致的、编辑风格简约的幻灯片,并导出为可编辑的 PPTX。最终交付物仅为 .pptx — HTML 幻灯片仅作为构建源,不生成 PDF 或 HTML 查看器。

工作原理

幻灯片以受限的 HTML 编写(每张幻灯片一个文件),然后 scripts/html2pptx.js 将每个 DOM 元素转换为原生 PowerPoint 对象(真实、可双击编辑的文本框)。页面固定为 1280px × 720px = 960pt × 540pt (LAYOUT_WIDE)。

构建流程

复制此清单并跟踪进度:

- [ ] 1. 搭建项目结构 (shared/ assets/ slides/ output/)
- [ ] 2. 规划叙事 → 将每张幻灯片映射到一个模板类型
- [ ] 3. 根据模板编写 slides/NN-name.html(仅编辑文本)
- [ ] 4. 检查溢出 → 修复任何不完全是 1280x720 的幻灯片
- [ ] 5. 导出 PPTX(仅此文件)
- [ ] 6. 清理构建源(只保留 .pptx 文件)

1. 搭建项目结构。 在工作目录中创建 shared/、assets/、slides/、output/ 文件夹。将本技能中的 shared/tokens.css 复制到项目的 shared/ 文件夹中。仅将本技能 assets/ 中你将使用的图片复制到项目的 assets/ 文件夹中。安装一次依赖:

npm i pptxgenjs playwright sharp && npx playwright install chromium

2. 规划。 将源内容转换为幻灯片列表。每张幻灯片都属于一种模板类型。典型的演示文稿结构为:封面 →(分节页 → 1–3 张内容幻灯片)× 章节 → 结束页。保持文本简洁;此风格追求通透。

3. 编写幻灯片。 从 templates/ 复制最接近的模板到 slides/NN-name.html 并替换文本。规则:

  • 保留 <link rel="stylesheet" href="../shared/tokens.css">。
  • 标题使用衬线字体;其他所有文本使用无衬线字体(已通过 tokens 配置)。
  • 仅使用一种红色强调色。谨慎使用深色面板(--ink-panel),并仅搭配金色 #C9A24B 作为其强调色。
  • 图片通过 <img> 引入(绝不用 CSS background-image)。请参见图片库。

4. 验证是否适配。 超出边界的幻灯片在 PPTX 中会被裁剪:

node scripts/check_overflow.mjs --slides slides

修复所有标记为 OVERFLOW 的问题(缩短文本或调整位置),直到所有幻灯片都报告 1280x720。

5. 仅导出 PPTX。

node scripts/export_deck_pptx.mjs --slides slides --out output/DeckName.pptx

幻灯片按文件名排序(01-…、02-…)。不要运行任何 PDF 或 HTML 导出——PPTX 是唯一交付物。

6. 清理。 删除 slides/ 中的 HTML 文件和所有临时文件,仅保留 output/DeckName.pptx(如果用户希望继续迭代,可保留可复用的 shared/ 和 assets/)。

设计系统

在 shared/tokens.css 中定义。不要发明新颜色。

TokenHEX用途
--ink#1A1A1A标题和主要正文
--soft#555555次要正文
--muted#8C8C8C标签、注释、页码
--red#C8102E唯一的强调色:条、引子、关键词、下划线
--red-deep#A00C24表格中的负向强调
--red-pale#FBE9EC连接芯片(例如 “→” 圆圈)
--box#F4F3F1浅色卡片 / 斑马纹行
--line#E4E2DE细线分隔符
--ink-panel#1C1C1C深色对比面板
gold#C9A24B仅用于深色面板的强调色
background#FFFFFF页面
  • 字体: h*/标题使用 Georgia 衬线字体;其他所有文字使用 Arial/Helvetica 无衬线字体。
  • 标志性样式: 标题左侧的细红色竖线 + 上方带有小号字母间距的红色引子;底部居中放置小字号页码。
  • 品牌调换: 要匹配其他公司,请更改 tokens.css 中的 --red(并可选择性地更改 --ink-panel/gold)— 其他部分无需改动。

图片库

图片位于本技能的 assets/ 中。纵向图片填充右侧约 40% 的分节页/封面面板(object-fit:cover);横向图片适合全出血封面。

文件方向最佳用途
sail.png纵向 589×1024分节页/封面右侧面板(默认)
lighthouse-cliff.png纵向 627×1024分节页/封面右侧面板
staircase.png高 312×1024宁静/抽象的分节条幅
mast.png窄 208×1024窄分节条幅
hiker-clouds.png窄 225×1024窄分节条幅
lighthouse-sunset.png横向 1024×721全出血封面 / 顶部条带
sailboat-deck.png横向 1024×721全出血封面 / 顶部条带

通过更改 <img src="../assets/….png"> 来替换图片。在所有分节页中保持使用一张一致的图片(或一个主题)以保证整体协调性。用户也可以将自己的图片放入 assets/ 中。

模板目录

位于 templates/ 中(每个模板都是一个完整、无溢出、尺寸为 1280×720 的幻灯片):

文件类型
01-cover.html分栏封面:左侧衬线标题,右侧纵向图片
02-divider.html分节页:引子 + 衬线标题 + 红色条,右侧纵向图片
03-three-column.html引子/标题 + 核心行 + 3 列 + 结果条带
04-mapping.html双列“他们想要什么 → 我们做什么”,带连接芯片
05-compare-table.html3 列对比表格,斑马纹行
06-dark-contrast.html双面板(浅色 vs 深色)+ 衬线页脚行
07-pipeline.html带编号的水平步骤管线 + 深色输出条
08-closing.html结束语:带编号的衬线行 + 右侧纵向图片

硬性限制

如果违反以下规则,HTML 到 PPTX 的转换将失败或渲染错误。完整细节及修复方法请参见 reference.md:

  1. 文本必须放在 <p>/<h1>–<h6> 内(绝不允许在 <div> 中有游离文本)。
  2. 不能使用 CSS 渐变。
  3. background/border/box-shadow 只能用于 <div>,绝对不能用于文本标签。
  4. 不能使用 background-image;请使用 <img>。
  5. 内联标签(span/em/strong)不能含有外边距。
  6. 页面保持 1280×720;任何内容不得溢出。

相关技能