name: ppt-orchestra-skill
description: 从零开始规划并编排多页PowerPoint演示文稿的创建。在通过子代理生成完整演示文稿之前，执行以下操作：对每张幻灯片类型进行分类、强制视觉多样性、设置排版/间距规则，并运行基于文本的质量检查以发现内容问题。
license: Proprietary. LICENSE.txt has complete terms

幻灯片页面类型（标准）

对于逐页生成（每张幻灯片一个 JS 文件），请将每一张幻灯片精确归类为以下 5 种页面类型之一。这有助于保持结构一致性，并防止“随机布局漂移”。

1. 封面页

• 用途：开场 + 定调
• 内容：大标题、副标题/演讲者、日期/场合、强烈的背景/主题图案

1. 目录页

• 用途：导航 + 预期设定（3–5 个部分）
• 内容：章节列表（可选图标 / 页码）

1. 章节分隔页

• 用途：在主要部分之间提供清晰的过渡
• 内容：章节编号 + 标题（+ 可选 1–2 行介绍）

1. 内容页（选择一个子类型）

• 文本：项目符号/引用/短段落（仍然添加图标/形状）
• 混合媒体：两栏 / 半出血图片 + 文字叠加
• 数据可视化：图表 + 1–3 个关键要点 + 来源
• 对比：并排的列/卡片（A 与 B、优缺点）
• 时间线 / 流程：带箭头的步骤、旅程、阶段
• 图片展示：主图、图库或视觉优先的布局

1. 总结 / 结束页

• 用途：收尾 + 行动号召
• 内容：关键要点、行动号召/下一步措施、联系方式/二维码、感谢语

布局选项：

• 两栏（左侧文本，右侧插图）
• 图标 + 文本行（图标在彩色圆内，粗体标题，下方描述）
• 2×2 或 2×3 网格（一侧图片，另一侧内容块网格）
• 半出血图片（左侧或右侧全高）并带有内容叠加

数据展示：

• 大数字标注（60–72pt 大号数字，下方带小标签）
• 对比列（之前/之后、优缺点、并排选项）
• 时间线或流程（编号步骤、箭头）

视觉修饰：

• 章节标题旁边的小彩色圆圈中的图标
• 关键统计或标语使用斜体强调文字

字体排印

选择有趣的字体搭配 — 不要默认使用 Arial。选择有特色的标题字体，并与清晰的正文字体配对。

间距

• 最小页边距 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",    // 用于背景/文本的深色
  secondary: "4a4e69",  // 二次强调色
  accent: "9a8c98",     // 高亮色
  light: "c9ada7",      // 浅色强调
  bg: "f2e9e4"          // 背景色
};

for (let i = 1; i <= 12; i++) {  // 根据需要调整数量
  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 视为一次错误排查，而不是确认步骤。如果在第一次检查中发现零问题，说明你没有仔细查看。

内容 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 - 从头创建