无头 PowerPoint 制作器
在没有打开 Office 应用的托管代理环境中生成可交付的 PPTX 文件。
技能明确仅写入 ./out/<name>.pptx,声明不发送或上传文件,且要求在 Cowork 工具可用时改用带审核检查点的路径,外部影响较小。扣分原因是未要求用户确认、未说明敏感数据处理、未固定或校验 python-pptx 依赖,也未提供失败后的恢复或回滚机制。
输出路径、模板选择、默认布局和基本 python-pptx 示例较清楚,主流程可理解。扣分原因是没有依赖安装说明、输入校验、异常处理、文件存在性验证或可诊断的失败反馈;静态审查且无关键路径测试,按上限限制不超过10分。
明确面向 managed-agent/CMA 无 Office 应用的无头场景,规定何时不应使用,并给出文件产物形式。扣分原因是未定义输入边界、复杂模板或图表失败时的非适用范围,也未提供中文内容或中国大陆网络环境适配说明。
文档采用前置元数据、输出契约、构建方法、约定和反向触发条件的结构,示例简洁;仓库提供 Apache-2.0 许可证及官方组织来源。扣分原因是技能自身没有版本、变更记录、维护责任、更新路径、安装依赖、FAQ 或已知限制说明。
技能直接规定生成 .pptx 文件、目录创建、模板使用、图表处理和相对路径返回,能够覆盖核心文件产出任务。扣分原因是没有可验证的完整示例输出、质量检查步骤或失败处理,且内容设计仍依赖调用方补充,静态审查下按上限限制不超过7分。
源文件本身可审计,示例代码、输出契约和仓库级插件验证及安全扫描工作流提供有限支持。扣分原因是 CI 未覆盖该技能的 pptx 生成关键路径,没有提交的专门测试、第三方执行证据或多源交叉验证;静态审查下不超过5分。
- 使用前应在隔离环境中明确安装并固定 python-pptx 版本,并验证生成文件可打开。
- 技能未定义敏感财务数据的处理、日志或临时文件清理要求;正式使用前应补充数据治理和人工复核流程。
- 缺少模板缺失、无效输入、写入失败和图表渲染失败时的明确错误信息及恢复策略。
它能做什么 & 适用场景
pptx-author 用于无头的 Managed Agent 或 CMA 会话,将 PowerPoint 演示文稿作为磁盘文件生成,而不是操作实时 PowerPoint 文档。它要求把文件写入 ./out/<name>.pptx,并在最终回复中返回相对路径。实现方式是编写并运行 Python 脚本,使用 python-pptx 创建或编辑演示文稿。该技能适合需要文件工件的托管代理流程,但不负责发送或上传文件。
创建 ./out/ 目录(如不存在);编写并通过 Bash 运行 Python 脚本;使用 python-pptx 创建演示文稿、添加幻灯片、文本、表格或图表;可在提供模板时读取 ./templates/firm-template.pptx;将结果保存为 ./out/<name>.pptx;在最终消息中返回相对文件路径。
- 金融服务团队在没有打开 Office 应用的 Managed Agent 会话中,需要生成客户演示文稿文件。
- 托管代理已经准备好估值或模型数据,需要将结果写入 PowerPoint 文件工件。
- 团队提供了 ./templates/ 下的公司模板,需要据此生成演示文稿。
- 需要批量或自动化生成 PPTX,而不是编辑用户当前打开的 PowerPoint 文档。
优缺点一览
- 明确规定 PPTX 输出位置和最终路径,便于编排层收集文件。
- 使用 python-pptx,可从空白演示文稿或公司模板开始。
- 支持无头环境,不依赖打开的 Office 应用。
- 明确禁止外部发送和上传,范围清晰。
- 依赖可运行的 Python、python-pptx、Bash 和本地文件系统。
- 源材料没有提供测试套件或具体平台验证信息。
- 不能替代通过 mcp__office__powerpoint_* 操作实时 PowerPoint 文档的流程。
- 图表优先使用从模型渲染的 PNG,相关模型文件和数据需要由调用流程提供。
如何安装
在 Cowork 中打开 Settings → Plugins → Add plugin,粘贴 https://github.com/anthropics/financial-services,然后选择 Meeting Prep Agent;也可以上传包含 plugins/agent-plugins/meeting-prep-agent/ 的压缩包。源材料未说明单独安装 pptx-author 技能的命令。
如何使用
在无头 Managed Agent 或 CMA 会话中提出生成 PowerPoint 文件的请求,并要求使用 pptx-author。技能应将文件写入 ./out/<name>.pptx,并在最终回复中返回该相对路径。源材料未规定固定的触发短语。
对比同类
与同仓库中面向实时 Office 文档的 live-Office pitch-deck 流程相比,pptx-author 生成磁盘上的 PPTX 文件,适用于没有打开 Office 应用的无头会话;源材料未提供其他竞品比较。