mcpField
D
deck-business-report

deck-business-report

github.com/jurgendn文档处理1152 次安装6 周前更新
代码仓库

关于 deck-business-report

面向管理层、客户及跨职能团队的业务报告幻灯片技能,以决策和影响组织内容,并支持生成 PowerPoint 或提供 Canva 可用的内容与设计规范。

主要功能

  1. 01答案优先的业务叙事
  2. 02高管摘要页指导
  3. 03业务影响与风险呈现
  4. 04生成 PowerPoint 幻灯片
  5. 05提供 Canva 内容与设计规范

适用场景

  1. 01准备高管决策演示文稿
  2. 02汇报试点结果与目标对比
  3. 03制作季度业务回顾
  4. 04交付客户建议与实施计划

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/jurgendn/agent-skills --skill deck-business-report

安装后在 Claude Code 中输入/deck-business-report确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

evals/
evals.json
references/
slide-spec-and-design.md
scripts/
build_pptx.py

详细介绍

商业 / 工业报告演示文稿

面向商业受众制作演示文稿,包括高管、经理、客户和跨职能利益相关者。输出格式为 PowerPoint(生成真实的 .pptx 文件)或 Canva(提供可导入的内容和设计规范,因为无法通过程序生成 Canva 文件)。受众关注决策、影响、风险和后续步骤,而非方法上的新颖性。

这是非 LaTeX 演示文稿的渲染步骤。幻灯片规范的架构和与格式无关的设计规则位于 references/slide-spec-and-design.md 中——请先阅读。学术类 LaTeX 演示文稿请改用 beamer-* 技能。


商业演示文稿的用途

商业演示文稿依次回答:情况如何?我们该怎么做?做了(或不做)会怎样? 先给出答案,再提供支持细节。这与论文从铺垫逐步推导结果的结构相反——高管自上而下阅读,可能看完第 3 张幻灯片就停下。

有两种有效的框架;选一种并贯彻到底:

  • SCQA——情境 → 冲突 → 问题 → 答案。适合问题 / 建议类演示文稿。
  • 金字塔结构(答案优先)——先给出建议,再分组呈现支持论据,最后提供证据。适合决策和 QBR 演示文稿。

常见类型与主线

类型主线
执行摘要 / 决策演示文稿建议 → 原因 → 影响 → 风险 → 诉求
试点 / 项目结果报告目标 → 已完成的工作 → 实际结果与目标对比 → 结果的意义 → 后续步骤
季度业务回顾(QBR)核心指标 → 成功之处 → 未达标项 → 驱动因素 → 计划
研发到业务报告问题与机遇 → 方法(通俗语言)→ 证据 → 业务影响 → 路线图 / 诉求
客户交付材料目标 → 发现 → 建议 → 实施计划 → 附录

每条主线都以一张独立成篇的执行摘要幻灯片开篇——即使读者只看这一张,也能了解决策和原因。


工作流

1. 收集输入
  • 目标工具:PowerPoint(.pptx)或 Canva。
  • 演示文稿类型、受众资历,以及演示文稿要推动的一项决策 / 行动。
  • 数据:指标、目标、结果、成本 / 收益、时间线。
  • 品牌信息:模板 / 主题颜色、徽标、字体(是否有可用作起点的企业 .pptx 模板?)。
2. 编写幻灯片规范

先确定类型对应的主线,再为每张幻灯片编写规范块(见 references/slide-spec-and-design.md),并着重考虑商业场景的要求:

  • 标题页之后的第 1 张幻灯片 = 执行摘要:建议 + 2–3 条理由 + 诉求。内容完整,可独立阅读。
  • 以业务成果作为结论式标题:例如“试点将处理时间缩短 31%——建议全面推广”,而非“试点结果”。
  • 每张幻灯片一个图表,图表本身就是论据(柱状图 / 折线图 / 瀑布图),标注核心结论,尽量减少装饰元素。
  • 用业务单位量化影响:时间、成本、收入、风险、满意度——而不只是模型指标。尽可能将准确率 / F1 转换为金额 / 小时。
  • 风险和后续步骤是必需的收尾幻灯片;高管需要了解不利因素和诉求。
  • 详细方法、完整表格和技术深度内容放入附录。

生成文件前,请先确认规范。

3a. 生成 .pptx(PowerPoint)

使用 scripts/build_pptx.py 将已批准的规范渲染为真实的 PowerPoint 文件:

  • 将规范写入 slides.json(架构见脚本头部的说明)。
  • 运行构建器;它会生成 deck.pptx,其中包含标题、章节、项目符号、图表占位符和表格布局、结论式标题、一致的主题颜色、页码和演讲者备注。
  • 如果提供了企业 .pptx 模板,请将其作为基础模板传入,以继承品牌字体 / 颜色 / 母版。
  • 图表:提供数据时,构建器会插入原生 PowerPoint 图表;否则会插入带标签的占位符,以便用户粘贴符合品牌规范的图表。
3b. Canva 路径

Canva 没有文件生成 API,因此请交付:

  • 可直接导入的内容:按幻灯片整理的简洁文本大纲(标题 + 正文 + 备注),供用户粘贴到 Canva 中,并附上准确的图表数据。
  • 设计规范:推荐的 Canva 模板风格、颜色十六进制代码、字体搭配、各类幻灯片的版式,以及每个视觉元素的位置。
  • 可选:生成相同演示文稿的 .pptx(步骤 3a)——Canva 可以导入 .pptx 并应用模板,这通常是制作符合品牌风格的 Canva 演示文稿最快的方式。请提供此选项。
4. 交接

PowerPoint:说明如何打开、在哪里替换为品牌图表/徽标、备注的位置,以及附录包含的内容。Canva:说明导入/粘贴步骤和设计规范。


与学术演示文稿不同的商业演示文稿规则

  • 先给答案。 绝不要让高管先听完动机,才能看到建议。
  • 讲业务,而不是模型。 对副总裁来说,“精确率为 94%”毫无意义;“每月减少约 2,000 条误报,释放约 3 个全职人力”才有意义。
  • 每张幻灯片传达一个要点、一张图表、一个数字。 信息过密会让人觉得“尚未准备好供决策”。
  • 明确提出诉求。 以你需要的决策、资源或批准作为结尾。
  • 善用附录。 细节放在附录中;主线始终聚焦于决策。

应避免的反面模式

  • 把建议藏到第 12 张幻灯片才讲。
  • 只报告模型指标,不说明其业务意义。
  • 标题页之后先讲方法论,却迟迟不展示结果或建议。
  • 直接从分析笔记本复制内容密集、包含多张图表的幻灯片。
  • 没有风险页,也没有明确的诉求。

输出

  1. 已确认的幻灯片规范(markdown),以业务逻辑为主线,并先给出答案。
  2. PowerPoint:slides.json + 生成的 deck.pptx(通过 scripts/build_pptx.py),包含标记清楚的占位符和演讲者备注。
    Canva:按幻灯片整理的可直接导入内容 + 图表数据 + 设计规范(以及可选的 .pptx 供导入)。
  3. 交接说明(品牌元素替换、附录内容、Canva 导入步骤)。

评论

支持 Markdown