跳转至

ppt-writer

所属包: ppt

Create/rewrite/restructure/update/validate/export PPT/PPTX decks (课件、提案、汇报、论文、技术方案). Trigger for 从Markdown/文档/纪要/旧PPT生成新deck, template/style unification, per-slide rewrite plans, build_deck + qa_deck workflow, visual QA, and iterative generate→QA→fix→re-verify delivery.

兼容性: opencode; requires uv for bundled Python scripts; optional LibreOffice and Poppler for visual QA; Node/PptxGenJS may be used for advanced custom layouts when available.

PPT Writer Skill

目标

把用户给出的材料、提纲、旧PPT或改版brief转化为结构清晰、可讲述、可审查、可迭代的PPTX文件。默认不是“把文字塞进幻灯片”，而是先做叙事结构和页面角色设计，再生成并验证。

适用任务：

  • 从Markdown、文档、会议纪要、研究材料或用户提纲生成PPTX。
  • 改写、重构、扩展、压缩已有PPT。
  • 制作课程课件、客户提案、项目汇报、论文汇报、技术方案或战略汇报deck。
  • 按模板或目标风格统一标题、结构、页面类型、视觉语言和讲述节奏。
  • 对输出PPT进行内容QA和视觉QA。

不适用任务：

  • 只读取PPT内容；使用ppt-reader。
  • 海报、长文档或Word正文写作；使用对应文档类skill。
  • 用户要求完全复刻商业模板但未提供授权模板文件时，不要臆造或复制受版权保护设计。

默认工作流

1. 先生成deck brief

在创建PPT前，先整理以下信息。如果用户没有提供，就根据任务上下文作合理默认，并在输出中说明：

  • 受众：高管/客户/学员/评审/内部团队。
  • 场景：课程讲解、销售提案、技术汇报、项目复盘、研究报告。
  • 时长：5分钟、15分钟、45分钟、半天课程等。
  • 目标：说服、教学、汇报、决策、留档。
  • 风格：正式、战略、技术、课程、极简、视觉化。
  • 页数：默认不超过用户可讲完的数量；宁可拆成结构清楚的少页，不要堆字。

2. 设计叙事结构

推荐结构：

  • 战略/提案：背景 → 问题 → 判断 → 方案 → 路线图 → 交付/下一步。
  • 技术方案：目标 → 约束 → 架构 → 关键机制 → 验证 → 风险 → 下一步。
  • 课程课件：概念澄清 → 例子 → 推理分析 → 动手练习 → 反馈提升。
  • 论文汇报：问题 → 相关工作缺口 → 方法 → 系统设计 → 实验 → 结论。

输出PPT前，先形成逐页计划：

| 页码 | 页面角色 | 标题 | 关键信息 | 推荐版式 | 视觉元素 |
|---|---|---|---|---|---|

3. 选择生成方式

默认用内置Python脚本从结构化JSON生成基础PPTX：

uv run scripts/build_deck.py assets/deck_spec_template.json --out output/deck.pptx

如果需要复杂图形、精细模板适配、动态图表或高级布局，允许编写临时Python或PptxGenJS脚本，但必须保留可复现的源文件和输入spec。

4. 生成deck spec

使用references/deck-spec-schema.md中的结构。至少包含：

  • meta.title
  • theme.primary / secondary / accent / background / text
  • slides[]
  • 每页的type、title、body或items

5. 生成PPTX并做QA

uv run scripts/build_deck.py deck_spec.json --out output/deck.pptx
uv run scripts/qa_deck.py output/deck.pptx --expected-slides 10 --out output/qa.json

如用户关心排版或正式交付，必须做视觉QA：

uv run ../ppt-reader/scripts/render_slides.py output/deck.pptx --out output/rendered --resolution 150

... (完整 SKILL.md 中还有 60 行)