pptx-author

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

pptx-author

pptx-author

Use this skill when running headless (managed-agent / CMA mode) and you need to deliver a PowerPoint deck as a file artifact rather than editing a live document via
mcp__office__powerpoint_*
.
当运行在headless(无界面)模式(托管代理/CMA模式)下,且需要将PowerPoint演示文稿作为文件产物交付,而非通过
mcp__office__powerpoint_*
编辑实时文档时,可使用此skill。

Output contract

输出约定

  • Write to
    ./out/<name>.pptx
    . Create
    ./out/
    if it does not exist.
  • Return the relative path in your final message so the orchestration layer can collect it.
  • 将文件写入
    ./out/<name>.pptx
    。若
    ./out/
    目录不存在则自动创建。
  • 在最终消息中返回相对路径,以便编排层收集该文件。

How to build the deck

如何构建演示文稿

Write a short Python script and run it with Bash. Use
python-pptx
:
python
from pptx import Presentation
from pptx.util import Inches, Pt

prs = Presentation("./templates/firm-template.pptx")  # if a template is provided
编写简短的Python脚本并通过Bash运行。使用
python-pptx
库:
python
from pptx import Presentation
from pptx.util import Inches, Pt

prs = Presentation("./templates/firm-template.pptx")  # 如果提供了模板

or: prs = Presentation()

或者: prs = Presentation()

slide = prs.slides.add_slide(prs.slide_layouts[5]) # title-only slide.shapes.title.text = "Valuation Summary"
slide = prs.slides.add_slide(prs.slide_layouts[5]) # 仅标题布局 slide.shapes.title.text = "Valuation Summary"

... add tables / charts / text boxes ...

... 添加表格 / 图表 / 文本框 ...

prs.save("./out/pitch-<target>.pptx")
undefined
prs.save("./out/pitch-<target>.pptx")
undefined

Conventions (mirror the live-Office
pitch-deck
skill)

约定(与实时Office的
pitch-deck
skill保持一致)

  • One idea per slide. Title states the takeaway; body supports it.
  • Every number traces to the model. If a figure comes from
    ./out/model.xlsx
    , footnote the sheet and cell.
  • Use the firm template when one is mounted at
    ./templates/
    ; otherwise default layouts.
  • Charts: prefer embedding a PNG rendered from the model over native pptx charts when fidelity matters.
  • No external sends. This skill writes a file; it never emails or uploads.
  • 每张幻灯片一个核心观点。标题点明核心结论;正文提供支撑内容。
  • 所有数据均可追溯至模型。若数据来自
    ./out/model.xlsx
    ,需标注对应的工作表和单元格作为脚注。
  • 使用公司模板:若
    ./templates/
    目录下挂载了模板则使用该模板;否则使用默认布局。
  • 图表:当保真度很重要时,优先嵌入从模型渲染的PNG图片,而非原生pptx图表。
  • 禁止外部发送:此skill仅生成文件,从不发送邮件或上传文件。

When NOT to use

不适用场景

If
mcp__office__powerpoint_*
tools are available (Cowork plugin mode), use those instead — they drive the user's live document with review checkpoints. This skill is the file-producing fallback for headless runs.
mcp__office__powerpoint_*
工具可用(Cowork插件模式),则优先使用这些工具——它们会操作用户的实时文档并提供审核检查点。此skill仅作为无界面运行时生成文件的备选方案。