SuperAPI AI 工具集

deck-pipeline

办公与效率

查看项目

更新于 10-16 16:28

技能介绍

用途

Deck Pipeline 是一个 4 智能体流水线,目标是把一个主题转化为「经得起批评」的演示文稿。每个智能体角色独立,前一环节的输出作为后一环节的输入,因此在你打开文件之前,文稿已经过策略规划、构建、评审与修正。

其核心动机是:单个「帮我做一份幻灯片」的提示词之所以效果一般,是因为它试图同时完成战略思考、内容撰写与自我批评。将角色拆开后:策略师专注于叙事结构;构建者带着清晰任务书专注于内容与视觉;评审者是对抗性的,不试图保护已完成的内容;修正者拿到的是具体且按优先级排列的指令,而不是模糊的「做得更好」。

主要能力(四个智能体)

智能体 1:Strategist(策略师)

角色:在开始构建前,定义受众、核心论点与完整幻灯片大纲。

主要工作:

  • 识别目标受众及其关注点
  • 定义 governing thought(整份文稿要证明的那一句话)
  • 使用 Situation → Complication → Resolution 结构,创建 10–12 页大纲
  • 每页标题是论断而非标签(例如「RTD market will reach $42.5B by 2028」而不是「Market Overview」)
  • 将幻灯片归入清晰的叙事模块

输出:包含受众定义、核心论点、逐页标题及支撑要点、叙事流标记(Situation / Complication / Resolution)的结构化大纲。

意义:没有策略的文稿只是幻灯片的集合;策略师确保每页都在论证中占有一席之地。

智能体 2:Builder(构建者)

角色:把策略师的大纲转化为实际演示文稿。

主要工作:

  • 依据大纲创建完整幻灯片内容
  • 撰写幻灯片正文、数据点与支撑论据
  • 组织视觉元素:对比表格、数据高亮框、框架图
  • 保持全篇一致的格式与语气
  • 确保每页都有清晰的「so what」

输出:通过 python-pptx 生成的完整原生 .pptx,文本与图表均可编辑。可选:markdown 或格式化文本作为中间产物用于评审。具体包括每页的论断式标题、带来源的数据点(在可获得的情况下)、视觉结构建议(表格、高亮框、图表),以及叙事模块之间的过渡页。

Builder 使用的工具:

  • mckinsey-charts:生成原生可编辑图表——单数字故事用条形图+标注,构成随时间变化用堆叠柱状图,桥接关系用瀑布图。受众可在 PowerPoint 中右键 → 编辑数据。用以替代粘贴图表图片。
  • python-pptx:生成原生文本、表格与版式。不使用截图、不使用基于图片的内容——一切保持可编辑。

Builder 的提示:

  • 数据高亮框适合呈现关键数字(大字号、对比色)
  • 展示选项时,对比表格优于项目符号列表
  • 每页正文最多 3–5 个要点
  • 每个数据页至少需要一个来源
  • 每个定量页使用 mckinsey-charts 生成的图表,而不是截图

智能体 3:Critic(评审者)

角色:像资深项目经理一样评审文稿——找出所有结构问题、薄弱论证与缺失要素。

主要工作:

  • 对整份文稿评级(Green / Yellow / Red)
  • 对每一页给出状态与具体问题
  • 指出按影响排序的前三大修改项
  • 指出一处做得好的地方(予以保护)

评级含义:

  • Green:可交付给利益相关方
  • Yellow:可在一夜之间修复,不要按原样发出
  • Red:核心论证已破,需要返工

检查内容:叙事流与结构;数据严谨性(来源、具体性、可比性);每页的「so what」;必要处的财务框架;论断式标题与主题式标题的区分;框架与项目符号列表的区分。

输出:包含逐节评级与前三优先修改项的批评文档。可参考 McKinsey Critic 技能获取完整评审框架。

智能体 4:Fixer(修正者)

角色:应用评审者的前三大修改项,产出最终文稿。

主要工作:

  • 获取评审者的具体修改指令
  • 将每项修改应用到文稿
  • 记录改动内容与原因
  • 产出最终打磨版本

Fixer 常见的修改包括:

  • 为数据页添加来源脚注
  • 把项目符号列表重建为对比表格(列 = 选项,行 = 评估维度)
  • 添加财务框架(市场规模 × 份额 = 收入、利润率分析、所需投资)
  • 把标题从描述性表述锐化为论断
  • 点名竞争对手,而不是泛泛描述
  • 把脱节的幻灯片重新链接回核心论点

输出:应用全部修改后的最终文稿,外加展示每项修改 before → after 的变更日志。

使用方式

快速开始:"Build me a deck on [topic] for [audience]. Use the full pipeline — strategist, builder, critic, fixer."

提供更多上下文:"I need a deck for [audience] arguing that [governing thought]. Key data points I have: [list any data, stats, or sources you want included]. Run the full pipeline: outline it, build it, critique it, fix it."

分步执行(若想在阶段间保持控制):

  • Step 1: "Act as the strategist. Define the audience, governing thought, and 10-slide outline for [topic]."
  • Step 2: "Now act as the builder. Turn this outline into a full deck."
  • Step 3: "Now act as the McKinsey critic. Grade this deck and give me the top 3 fixes."
  • Step 4: "Now act as the fixer. Apply the top 3 fixes."

各智能体输出示例

主题:"Should a premium coffee company enter the RTD (Ready-to-Drink) market?"

  • Strategist 输出:受众为董事会 + CEO;核心论点:"The premium RTD market offers a $425M revenue opportunity that plays to our existing capabilities — but only if we move within 12 months.";10 页结构:3 页 Situation(市场规模、精品增长、RTD 增长)→ 3 页 Complication(消费者转变、竞争、先发窗口)→ 4 页 Resolution(路径对比、RTD 建议、可持续性、路线图)。
  • Builder 输出:含数据、数据高亮框、对比表格的完整文稿。
  • Critic 输出:评级 YELLOW;修改 1:为每个数字标注来源(所有页面都没有来源脚注);修改 2:第 7 页是项目符号列表,需改为对比表格(3 条路径 × 5 个维度);修改 3:缺少财务框架,需添加 1% 份额下的 $425M 收入、$15–25M 第一阶段投资。
  • Fixer 输出:添加全部来源、重建对比表格、在建议页加入财务框架的最终文稿。

适用场景

  • 董事会演示与投资者更新
  • 面向领导层的战略建议
  • 产品发布提案
  • 市场进入分析
  • 任何需要经受尖锐提问的演示文稿

限制与替代说明

关于替代旧的 Gamma 路径:该仓库早期版本把故事线与 Gamma API 配对以生成成品文稿。当前版本改用原生 python-pptx + mckinsey-charts 技能,原因包括:可编辑而非生成(图表是真实的 PowerPoint 图表对象,不是图片,受众可改颜色、编辑数据、复制到自己的文稿);无第三方依赖(不需要 Gamma 账号、API 密钥或按文稿计费);更好的默认效果(单一高亮色、无网格线、论断式标题已内置于 mckinsey-charts,而 Gamma 路径每次都需要通过提示词工程调整外观)。gamma-automation/ 文件夹保留供参考,但已弃用。

其他限制:资料未提供具体的安装命令、代码示例、收费与价格信息、支持的平台细节、运行环境要求及性能数据。官方文本为空,暂未提供。