ppt-orchestra-skill

幻灯片页面类型（标准）

逐页生成幻灯片（每页对应一个 JS 文件）时，将每张幻灯片准确归类为以下 5 种页面类型之一。这样可以保持结构一致，避免“布局随意漂移”。

1. 封面页
   • 用途：开场并奠定基调
   • 内容：醒目的标题、副标题／演讲者、日期／场合、鲜明的背景／主题元素
2. 目录页
   • 用途：引导浏览并设定预期（3–5 个部分）
   • 内容：章节列表（可选图标／页码）
3. 章节分隔页
   • 用途：清晰地过渡到不同的主要部分
   • 内容：章节编号 + 标题（+ 可选的 1–2 行简介）
4. 内容页（选择一种子类型）
   • 文本：项目符号／引言／简短段落（仍需添加图标／形状）
   • 混合媒体：双栏／半幅出血式图片 + 文字叠加
   • 数据可视化：图表 + 1–3 个关键结论 + 来源
   • 对比：并排的栏／卡片（A 与 B、优缺点）
   • 时间线／流程：带箭头的步骤、历程、阶段
   • 图片展示：主视觉图片、图库或视觉优先的布局
5. 总结／结束页
   • 用途：总结并引导行动
   • 内容：关键要点、行动号召／后续步骤、联系方式／二维码、致谢

布局选项：

• 双栏（左侧文本，右侧插图）
• 图标 + 文本行（彩色圆形中的图标、加粗标题、下方说明）
• 2x2 或 2x3 网格（一侧放图片，另一侧放内容块网格）
• 半幅出血式图片（占据左侧或右侧的整面）并叠加内容

数据展示：

• 大号数据标注（醒目的 60-72pt 数字，下方配小号标签）
• 对比栏（之前／之后、优缺点、并排选项）
• 时间线或流程图（编号步骤、箭头）

视觉润色：

• 在章节标题旁的彩色小圆圈中放置图标
• 用斜体强调关键数据或标语

字体排版

选择一组有趣的字体搭配——不要默认使用 Arial。选择一款有个性的标题字体，并搭配一款简洁的正文字体。

标题字体	正文字体
Georgia	Calibri
Arial Black	Arial
Calibri	Calibri Light
Cambria	Calibri
Trebuchet MS	Calibri
Impact	Arial
Palatino	Garamond
Consolas	Calibri

元素	大小
幻灯片标题	36-44pt 加粗
章节标题	20-24pt 加粗
正文	14-16pt
说明文字	10-12pt 淡化

间距

• 最小边距为 0.5"
• 内容块之间留出 0.3-0.5"
• 留出呼吸空间——不要填满每一寸

避免事项（常见错误）

• 不要重复使用相同的布局——在不同幻灯片中灵活变换栏、卡片和重点标注
• 不要将正文居中——段落和列表左对齐；只将标题居中
• 不要忽视字号对比——标题需要达到 36pt+，才能与 14-16pt 的正文区分开
• 不要默认使用蓝色——选择能体现具体主题的颜色
• 不要随意混用间距——选择 0.3" 或 0.5" 的间距，并保持统一
• 不要只精心设计一张幻灯片，而让其余页面朴素单调——要么全面采用设计风格，要么始终保持简洁
• 不要制作纯文字幻灯片——添加图片、图标、图表或其他视觉元素；避免只有标题 + 项目符号
• 不要忘记文本框内边距——将线条或形状与文本边缘对齐时，在文本框上设置 margin: 0，或根据内边距调整形状的位置
• 不要使用对比度低的元素——图标和文字都必须与背景形成鲜明对比；避免浅色背景上的浅色文字，或深色背景上的深色文字
• 切勿在标题下方使用强调线——这是 AI 生成幻灯片的典型特征；改用留白或背景色

编译幻灯片

在 slides/ 中生成所有幻灯片 JS 文件后，创建 slides/compile.js，将它们编译为单个 PPTX 文件：

// slides/compile.js
const pptxgen = require('pptxgenjs');
const pres = new pptxgen();
pres.layout = 'LAYOUT_16x9';

const theme = {
  primary: "22223b",    // dark color for backgrounds/text
  secondary: "4a4e69",  // secondary accent
  accent: "9a8c98",     // highlight color
  light: "c9ada7",      // light accent
  bg: "f2e9e4"          // background color
};

for (let i = 1; i <= 12; i++) {  // adjust count as needed
  const num = String(i).padStart(2, '0');
  const slideModule = require(`./slide-${num}.js`);
  slideModule.createSlide(pres, theme);
}

pres.writeFile({ fileName: './output/presentation.pptx' });

运行命令：cd slides && node compile.js

---

QA（必需）

假设存在问题。你的任务是找出它们。

初次渲染几乎从来都不正确。请把 QA 当作查找 Bug 的过程，而不是确认步骤。如果你第一次检查就没有发现任何问题，那说明你还不够仔细。

内容 QA

python -m markitdown output.pptx

检查是否有内容缺失、错别字或顺序错误。

使用模板时，请检查是否残留占位文本：

python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum|this.*(page|slide).*layout"

如果 grep 返回结果，请先修复，再宣布成功。

验证循环

1. 生成幻灯片 → 使用 python -m markitdown output.pptx 提取文本 → 检查内容
2. 列出发现的问题（如果没有发现问题，就更严格地再检查一次）
3. 修复问题
4. 重新验证受影响的幻灯片——一次修复往往会引发另一个问题
5. 重复上述步骤，直到完整检查一遍后不再发现新问题

至少完成一次修复并验证的循环后，才能宣布成功。

---

依赖项

• pip install "markitdown[pptx]" - 提取文本
• npm install -g pptxgenjs - 从头开始创建