pptx-author

name	pptx-author
version	1.0.0
description	在无界面环境下用 Python（python-pptx）将演示文稿写为磁盘上的 .pptx 文件产物，供私人银行访前简报等场景使用。
tags	["pptx","presentation","headless","privbank","pre-visit"]
allowed_tools	["bash","read_file","write_file"]

pptx-author（无界面写 PPTX）

在 Agent 无界面运行时，需要把演示文稿作为文件产物交付时使用本技能。

产出约定

• 写入 ./out/<名称>.pptx；若无 ./out/ 则先创建
• 最终回复中给出相对路径，便于编排层收集
• 若同时写 Markdown/文本旁路文件，必须 UTF-8：Path(...).write_text(..., encoding="utf-8")；勿用 Windows 默认 GBK

会前简报默认文件名：./out/briefing-<客户标识>.pptx

如何生成

编写短 Python 脚本，用 Bash 执行。依赖：python-pptx（若未安装：pip install python-pptx）。

from pptx import Presentation
from pptx.util import Inches, Pt
from pathlib import Path

Path("./out").mkdir(parents=True, exist_ok=True)

template = Path("./templates/firm-template.pptx")
prs = Presentation(str(template)) if template.exists() else Presentation()

slide = prs.slides.add_slide(prs.slide_layouts[5])  # 仅标题等空白布局，视模板而定
if slide.shapes.title:
    slide.shapes.title.text = "会前简报摘要"
# ... 继续添加表格 / 文本框 / 图表 ...

prs.save("./out/briefing-客户标识.pptx")

版式约定

• 每页一个观点。 标题即结论，正文支撑结论。
• 数字可追溯。 若来自 ./out/model.xlsx 等，脚注标明工作表与单元格。
• 优先机构模板：若挂载了 ./templates/ 则使用；否则用默认布局。
• 图表：保真要求高时，优先嵌入由模型渲染的 PNG，而非原生 pptx 图表。
• 不对外发送。 本技能只写文件，不发邮件、不上传。

内容建议（会前简报）

1. 封面：客户、会议日期
2. 关系与目标
3. 持仓快照
4. 未决事项
5. 市场背景（仅用已清洗摘要）
6. 建议议程
7. 谈话要点
8. 免责声明

何时不用

若环境已提供可驱动实时 Office 文档的 MCP/插件，且用户正在交互审阅，可优先用交互式编辑；本技能是无界面文件产物回退方案。