PPT-Design-Skill

PPT Design Skill

原生可编辑 · 视觉设计驱动

一个以设计决策和交付质量为核心的 PowerPoint skill。PPTX 的实际生成由已发布的 pptx-designer Python 标准库 负责；本 Skill 负责需求确认、结构设计、视觉方案、生成编排、PNG 视觉验收 以及返工交付。

English README · 中文使用手册 · 真实案例 · 安装说明

---

先选对生成模式

交付级任务，默认选择 Build Mode

如果你的 PPT 要交给客户、管理层、投资人或正式会议使用，优先使用 Build Mode。它允许 LLM 逐页规划结构、锁定视觉方向、精确控制布局， 并在 PPTX → PDF → PNG 后进行视觉复核和返工，是三种模式中视觉控制力和 交付确定性最高的路径。

模式	最适合	布局控制	速度	推荐度
Build Mode ⭐	客户交付、提案、战略、路演、 editorial、正式汇报	最高：逐页、逐元素控制	中等	首选
FreeStyle Mode	快速探索、方向草稿、内容已经明确的轻量 PPT	中等：由 generate_ppt() 自动编排	最快	探索优先
VI Build Mode	已有企业模板、母版或品牌规范的 PPT	受模板约束：提取并保持品牌 DNA	中等	模板优先

如何判断

• 你关心“最终看起来是否专业”，而不是只要一个草稿：Build Mode；
• 你想快速验证主题、内容或风格方向：FreeStyle Mode；
• 你必须沿用企业模板、Logo、字体和版式：VI Build Mode。

FreeStyle 的 generate_ppt(query=...) 和 generate_ppt(content=...) 是同一个模式的两种输入方式，不是两条独立 的生成引擎。无论选择哪种模式，正式交付都必须经过 PNG 视觉检查。

推荐决策： 不确定时使用 Build Mode；只有在明确追求速度或 必须服从现有模板时，才选择 FreeStyle 或 VI Build Mode。

Skill 的核心价值：保证设计决策与交付质量

pptx-designer 负责把设计决策生成成可编辑 PPTX；本 Skill 负责保证设计 决策和交付过程的质量：

需求确认
  → 领域判断与页面结构
  → 视觉方向建议与用户确认
  → 设计 token / 页面锚点锁定
  → pptx-designer 生成可编辑 PPTX
  → PPTX → PDF → PNG
  → 第一门：整体视觉效果与客户级完成度
  → 第二门：严重缺陷、需求和可编辑性检查
  → 源码/内容返工并重新渲染
  → 用户确认与交付

技术上“运行成功”不等于设计完成。Skill 会直接检查导出的 PNG，判断页面 是否有视觉重心、合理密度、清晰层级、完整构图，以及是否真正符合用户需求。 只有通过两道门并完成必要返工，才进入用户确认与交付：第一门检查整体视觉 效果与客户级完成度；第二门检查严重缺陷、需求覆盖和可编辑性。

生成前，LLM 会把用户需求整理成可追踪的视觉验收合同；生成 PNG 后，逐项 对照需求和页面证据，记录 PASS、NEEDS_REVISION 或 BLOCKED。因此 PNG 检查不是泛泛地判断“好不好看”，而是验证结果是否真正满足用户目标。

精选设计案例

这里展示的是可以下载、打开并继续编辑的完整 PowerPoint 案例。它们覆盖 技术系统、基础设施研究、科学证据、文化建筑和城市策略，用来说明本技能 如何把内容结构、视觉方向和原生可编辑对象结合成完整的演示设计。

案例	设计定位	视觉语言与设计重点
AI Agent Operating System	技术系统蓝图	深色网格、分层架构、荧光色标记、流程与治理
AI Infrastructure Economics	编辑型产业研究	纸张质感、物理约束隐喻、数据层级、战略叙事
Single-Cell CAR T Atlas	论文型科学叙事	图证结构、研究设计、证据边界与可编辑机制图
Louvre Abu Dhabi	建筑文化叙事	真实摄影、可编辑几何、气候逻辑与博物馆城市空间
Vertical City Retrofit	城市更新策略	建筑剖面、系统图、情景数据、治理与决策框架
COUTURE COLOR — Objects of Desire	高定美妆编辑叙事	全屏妆效肖像、同一模特的上妆动作、可编辑产品结构与材质叙事

这些案例不是为了证明代码能够运行，而是为了展示从设计判断到最终页面 完成度的完整结果。更多页面和下载入口请查看在线案例画廊 和 examples/README.md。

点击任意预览即可进入在线查看器，浏览完整页面并下载 PPTX、PDF：

Install

Clone the repository first, then run the installer from the repository root. The installer automatically installs the published pptx-designer Python package and copies the skill bundle to the selected coding assistant:

# Clone the skill repository
git clone https://github.com/sunchaokun/PPT-Design-Skill.git
cd PPT-Design-Skill

python installer/install.py --platform opencode --force
python skill/scripts/check_runtime.py

请使用 installer/install.py 完成 Skill 安装。仓库根目录的 install.py 仅用于安装 Python 运行包 pptx-designer，不会把 Skill 注册到编码工具中。

Replace opencode with claude, codex, deepseek-harness, or all as needed. Restart the coding assistant after installation.

LibreOffice 为什么是可选依赖？

PPTX 的生成本身只依赖 Python 包 pptx-designer，不要求安装 LibreOffice。 但按照 Skill 的质量流程，生成 PPTX 后还需要将它渲染为 PDF 和 PNG，检查 文字溢出、图片裁切、构图和页间节奏：

• 有 Microsoft PowerPoint 时，Windows 优先使用 PowerPoint COM 渲染；
• 没有 PowerPoint 时，使用 LibreOffice 的 soffice 将 PPTX 转为 PDF；
• 再使用 Poppler 的 pdftoppm 将 PDF 转为 PNG。

因此，LibreOffice 是无 PowerPoint 环境下的渲染后备方案，不是 PPTX 生成器， 也不是所有用户都必须安装的依赖。运行下面的命令可以检查当前环境：

python skill/scripts/check_runtime.py

安装器会检查 PATH、Windows 默认安装目录和注册表中的 LibreOffice，不会因为 soffice.exe 没有加入 PATH 就误报未安装。桌面软件不会被静默安装；如果需要 使用 winget 显式安装 LibreOffice 和 Poppler，可以执行：

On Windows, users who explicitly want the installer to use winget may run:

python installer/install.py --platform opencode --force --render-deps

检查真实案例

python skill/scripts/inspect_pptx.py examples/new_examplex/louvre_abudhabi/output/louvre_abudhabi_complete.pptx --pretty
powershell -ExecutionPolicy Bypass -File skill/scripts/render_pptx.ps1 `
  -InFile examples/new_examplex/louvre_abudhabi/output/louvre_abudhabi_complete.pptx `
  -OutDir output/louvre-abudhabi-rendered

对其他维护案例重复执行。导出后，LLM 必须直接查看 PNG， 检查构图、层级、文字可读性、图片裁切、页间节奏、用户需求匹配度和可编辑 性。发现问题必须修改源代码或内容并重新渲染。

文档入口

• Skill 主流程
• 设计原则
• 公共 API
• 质量与交付
• 跨平台安装
• 真实评估样例
• 高定视觉方向评估
• 科研结果汇报评估

解决什么问题

仅检查代码、文件和基础结构，不能保证 PPT 达到设计要求。即使“运行成功”， 仍可能存在标题层级弱、页面拥挤、图片裁切错误、图表不可读、页面重复和风格 不统一等问题。

本 skill 将视觉结果作为交付对象的一部分：

1. 用户先确认需求和受众；
2. LLM 先设计页面结构和视觉方向；
3. pptx-designer 把已确认的设计决策生成成可编辑 PPTX；
4. 通过确认过的 PPTX -> PDF -> PNG 路径导出页面；
5. LLM 直接查看 PNG，逐页判断是否达到设计要求；
6. 发现问题后回到 Python 源码或内容进行修订；
7. 重新导出并检查，最终交给用户确认。

设计能力

本 skill 采用成熟的 Designer Mindset，而不是把设计退化成选择一个 style 参数：

能力	作用
Audience-first	根据受众、场景和行动目标决定页面表达方式
Narrative planning	先设计页面级叙事，再生成代码
Domain paradigms	科研、论文、技术、医疗、政府和商业使用不同范式
Design system	锁定颜色、字体、间距、网格、图片和组件语言
Density control	控制页面信息量，避免用小字号塞满页面
Structural variat