matzehg/minto-deck

Minto Deck

幻灯片或备忘录是一个论证，即使只看标题，听众也能跟随思路。本技能确保每份幻灯片和每份备忘录都是答案优先，先构建故事线以便在修改成本较低时获得批准，并根据相同标准审核现有幻灯片和备忘录。该方法论位于 references/ 目录中，独立于任何渲染工具，因此在 Claude.ai、Cowork、Claude Code 或任何与 Agent-Skills 兼容的主机中，行为一致。

三种模式

每次请求选择一种模式，并在回复的第一行命名。

• 构建 (Build)：用户想要新的幻灯片、故事线、幽灵幻灯片、尚不存在的幻灯片的演讲者备注，或将材料改版为幻灯片。
• 备忘录 (Memo)：用户想要以答案优先的方式论证的散文：管理层摘要、简报或备忘录、活动或会议报告、一日或一次会议的论点、决策备忘录、状态说明，或应以结论开头而非复述来源的摘要。输出为文本（聊天、文档或文件），而不是幻灯片。
• 审核 (Audit)：用户已有幻灯片或备忘录（文件、链接、粘贴的大纲、导出的文本），并希望进行审查、检查、批评或评分。审核模式下不要更改内容，除非用户要求重写；此时先报告，再重写。

像“修复我的幻灯片”这样的请求是先审核，然后在修正后的故事线上进入构建模式阶段一。在开始前说明这一点。“总结这些笔记”且没有进一步要求时，是普通摘要，超出本技能范围；“总结以便关键信息优先呈现”、“一日的论点是什么”、“写管理层摘要”则属于备忘录模式。如果同时需要备忘录和幻灯片，先运行备忘录：获批的备忘录故事线将成为幽灵幻灯片的统摄思想和关键行（参见备忘录模式下的“桥接到构建”）。

语言

回复、标题、注释及所有制品使用简报的语言。如果简报是混合的，询问一次。在演示语言为德语时，方法论术语保持英文，并在首次使用时附上德语注释，例如“Governing Thought (Kernbotschaft)”。references/glossary.md 包含固定的对应词对；使用它们以确保幻灯片在不同项目中保持一致。

构建模式

阶段零：简报契约

在写任何标题之前，确定以下事项。首先从请求、附带的材料和对话历史中获取。仅询问缺失且会影响故事线的项目；否则在阶段一输出中陈述假设并继续。一次最多问三个问题。

1. 受众及其问题：房间里坐着谁，他们必须在幻灯片结束时理解、决定或做什么。
2. 目的和幻灯片类型：决策文件、状态报告、提案或推销、专家演讲、阅读幻灯片。references/audit-checklist.md 列出了每种类型的必需元素；类型决定阶段二必须包含什么。
3. 用户已有的统摄思想（如果有）。如果用户没有，从材料中推导出一个，并标记为推导所得。
4. 场景：现场演讲还是无演讲者阅读。这决定了密度模式（演讲者主导或阅读优先）以及是否需要讲义版本。
5. 时长，包括讨论时间，以及由此产生的幻灯片预算。
6. 材料和来源：存在什么证据，缺失什么，哪些不能虚构。数字、引语和示例来自用户的材料，或明确标记为占位符。
7. 约束：模板、企业设计、保密要求、幻灯片限制、强制幻灯片。模板位于 assets/templates/，每个模板一个文件夹，包含文件及其布局的简短说明；选择简报指定的模板，如果有多个合适则询问。模板是用户或其雇主的财产：请勿将其放入公共仓库。
8. 符号表示：当材料包含实际值、计划、预测、上期或差异时，幻灯片默认使用 IBCS 符号。在注册表中说明，并将“未使用 IBCS 符号”作为开放点在关卡处列出，以便用户拒绝。

阶段一：幽灵幻灯片

在开始构建之前，阅读 references/minto-pyramid.md 和 references/storyline-ghost-deck.md。幽灵幻灯片是不含幻灯片正文的完整论证。

按以下顺序构建：

1. 编写统摄思想：一个能回答受众问题且理性人士可能不同意的句子。
2. 编写 SCQA 开场。只保留受众尚未共享的背景和冲突。决定统摄思想出现的位置（默认在第 2 张作为管理层摘要）。
3. 编写关键行：三到五个共同证明统摄思想的论点。作为一组进行测试：同类思想，无重叠，共同充分，存在一种逻辑顺序。
4. 将每个关键行论点扩展为其支持的幻灯片。每个幻灯片标题都是一个完整的句子，陈述一个论点。使用平行语法对同级内容进行分组。
5. 添加结尾：重述统摄思想，以提案形式提出决策或后续步骤，以及如果幻灯片类型有此要求，则明确请求。
6. 构建注册表：每个命名实体（流程、机构、角色、系统、选项、标准）包含将在每张幻灯片上出现的准确名称、其类别、定义和状态（来自简报或假设）。测试每个集合是否属于一个类别且命名模式一致。注册表是用户编辑名称、成员和顺序的入口；阶段二仅将其作为唯一来源。
7. 根据时长推导计时框架并标记裁剪优先级。大约 20 张幻灯片起才使用章节分隔符；较短的幻灯片使用跟踪器。
8. 执行通读测试：仅阅读标题，从头到尾。如果论证存在空白、重复或跳跃，修改标题，而不是正文。

输出完全按照 references/storyline-ghost-deck.md 中的幽灵幻灯片格式：按章节分组的编号标题、注册表、计时框架、假设、开放点，以及如果材料支持不同结构时的最多一个备选关键行。然后停止。以审批问题结束回复。在同一轮中不要生成幻灯片、备注或文件，即使用户要求“完整的幻灯片”：关卡是该方法的要点，现在修改故事线只需几分钟，而以后则需要数小时。如果用户明确要求一次完成，说明关卡应其要求被跳过，然后继续。

当用户编辑标题时，仅重新生成故事线的受影响部分并重新运行通读测试。不要重新打开已批准的部分。

符号预览：如果用户对 IBCS 符号不确定，在阶段二正式开始前构建一个图表幻灯片的两个变体，供用户选择。仅在明确要求时制作两个完整版本的幻灯片。

阶段二：完整幻灯片

仅从已批准的幽灵幻灯片开始。首先阅读 references/stage-2-checklist.md；这是交付前需要逐项检查的页面。然后阅读 references/consulting-practices.md、references/visual-design.md、references/speaker-notes.md 和 references/timing-qa-handout.md。当材料包含实际值、计划、预测、上期或差异时，还需阅读 references/ibcs-notation.md。对于阅读优先的幻灯片或讲义步骤，阅读 references/reading-decks.md。

按以下顺序生成：

1. 幻灯片正文。 每张幻灯片一个信息；正文证明标题。根据信息所做的比较（按 consulting-practices.md 中的图表和表格规则）选择证据形式（图表、表格、卡片、示意图、文本）。每个外部声明都有来源行；每个数字都有单位、时期和分母。密度遵循阶段零确定的模式；在演讲者主导的密度下，缩放类型和形状以填满幻灯片，而不是留下空白。在决策文件中，在展示推荐选项的详细信息之前先展示选项，并在标题中将它们标示为选项。每个实体都来自注册表，使用注册表中的名称和顺序。
2. 幻灯片 2 上的管理层摘要：从幽灵幻灯片起草（统摄思想、关键行、请求）；最终版本在第 8 步编写，在所有其他幻灯片存在且数字已知后。按密度模式根据 visual-design.md 第 8 节格式化。
3. 每张幻灯片的演讲者备注 放在备注窗格中，结构如 speaker-notes.md 所示：关键点、开场白、演讲线索、要指出的证据、过渡、时间预算。提示，而非脚本。
4. 计时计划 作为单独表格：幻灯片、分钟数、累积时间、裁剪优先级。
5. 问答准备 作为单独文档：受众会问的问题，按攻击点分组，每个问题附有简短答案和指向承载证据的幻灯片或备用资料的指针。
6. 备用幻灯片 用于回答预期问题但非主要论证的证据。在问答文档中引用它们。
7. 讲义版本 当幻灯片也将被无演讲者阅读时：相同的故事线，阅读优先密度，来源在幻灯片上，无演示线索；转换规则见 reading-decks.md 第 6 节。
8. 管理层摘要，最终版。 根据完成的幻灯片重写幻灯片 2：每个粗体行都是一个由幻灯片证明的声明，每个数字都与幻灯片匹配。
9. 一致性检查。 提取幻灯片文本并检查注册表中的每个集合：相同成员、相同名称、在其出现的每张幻灯片上顺序相同；出现或消失的成员必须在幻灯片或备注中有明确原因。检查子集是否命名了其总体和标准。检查幽灵幻灯片的证据列：每个标记为“缺失”的标题在幻灯片和交付备注中都是占位符。
10. 交付前自检 对照 references/audit-checklist.md，包括 visual-design.md 第 12 节中的视觉检查。修复阻塞性问题；在交付备注中列出警告。

渲染

该方法论与工具无关；文件由主机提供的任何方式生成，按以下偏好顺序：

1. 主机原生的 PowerPoint 功能（Anthropic 的 pptx 技能、PowerPoint 连接器或等效的幻灯片工具），因为它保持文本、表格和图表可编辑，并将备注放在备注窗格中。
2. 当不存在此类功能时，使用沙箱中的 pptxgenjs 和 scripts/pptx-helpers.js；这些辅助程序编码了区域、网格、类型比例、列表样式表格、卡片、V形符号和备注窗格，因此构建文件仅包含幻灯片的内容（参见 scripts/README.md 和 scripts/example-build.js）。
3. 当根本无法生成文件时，生成 Markdown 大纲并附上备注；说明这一点。

交付可编辑的 .pptx 文件。Keynote 和 Google Slides 可导入它；不要生成 Keynote 原生文件。保持图表为原生。将演讲者备注放在备注窗格中，绝不放在幻灯片上的文本框中。如果用户提供了模板，则应用；否则保持中性并说明。交付前，提取幻灯片文本并检查标题、顺序、备注存在性和遗留的占位符。然后以全尺寸渲染每张幻灯片并查看每张：重叠、浮动连接符、比指向它们的内容更窄的框、换行的关键值行、聚集成团的空白、电子表格样式的表格。缩略图不会显示这些问题。

备忘录模式

在开始前，阅读 references/memo-format.md 和 references/minto-pyramid.md。备忘录应用与幻灯片相同的金字塔，但展平为散文：统摄思想领先，章节标题是关键行论点，每个段落证明其标题。两个阶段，一个简单关卡。

阶段零：简报

从请求、材料和对话中获取以下项目；仅询问缺失且会影响故事线的项目，一次最多问三个问题。

1. 受众及其问题：谁阅读此文，他们必须理解、决定或做什么。混合受众（内部和外部读者）会降低内部引用的密度并提高归因标准。
2. 备忘录类型：管理层摘要、简报、活动或会议报告、决策备忘录、状态说明。memo-format.md 列出了每种类型的必需元素。
3. 用户已有的统摄思想。如果无，则从材料中推导一个，并标记为推导所得；关卡使用户可以替换它。
4. 长度预算（字数或页数）和目的地：聊天回复、文档、文件。
5. 材料和来源：哪些可以使用，哪些不能虚构，如何归因陈述。对于谈话或会议报告，确定是否命名发言人、按角色命名或不命名（memo-format.md 第 5 节）。
6. 是否随后需要幻灯片。如果是，构建故事线以便能承接下来。

阶段一：故事线

按照 memo-format.md 第 2 节的格式交付：统摄思想作为一个句子；开场包含完整的 SCQA 四行，背景和冲突各为一个句子，冲突引发的问题，以及答案就是统摄思想的原句，以便读者在关卡处检查答案是否回答了问题；关键行为三到五个论点，作为完整句子，按主题或论点顺序排列，绝不是按源材料的顺序，每个论点附有证据标记（可用、缺失或占位符及来源）；顺序及其标准；不同来源间的分歧所在及将在哪个论点下进行论证；备忘录对读者的后续行动（当备忘录类型有此元素时）；归因设置；假设和开放点；备忘录命名了必须保持一致的流程、机构、角色、系统或选项时，附一个简短注册表，包含一个“集合 (Sets)”行，用一个复数名词命名每个集合，并按固定顺序列出其成员（复数名词测试：一个机构不属于流程集合）。对关键行执行通读测试。以一个审批问题结束并停止。例外：用户要求一次完成，或我确信不值得（这种情况很少见；说明理由）。

阶段二：备忘录

从批准的、带有证据的故事线开始。为关键行的每个论点撰写一个或多个带标题的段落。一个段落，一个声明。过渡句仅在服务于逻辑时使用，绝不用于装饰。按 memo-format.md 第 4 节进行归因：句子内的引语和数字链接到其来源；没有活链接时，每个段落末尾的括号引用。标题用语或关键行术语的词汇表仅当受众不共享时才需要：标准多于一个时定义它（A4 不是格式，而是格式标准中的一个值）；集合适用于每个组（整个文件中的“选项”或“月份”）；一致性由在阶段零末未共享的注册表列表保证。以受众的下一步行动结束。

桥接到构建 (Bridge to Build)

如果备忘录之后需要幻灯片：批准的备忘录故事线是幽灵幻灯片的统摄思想和关键行。复制它，回答阶段零简报契约中关于幻灯片类型的任何未决问题，继续阶段一。

审核模式

在开始前，阅读 references/audit-checklist.md。它包含：表示类型必需元素的检查点、关键行测试、一致性检查（与注册表相比）以及视觉检查。不要更改输入。

报告以下内容，按此顺序：

1. 总体评分 和无阻塞问题列表。
2. 失分 按严重程度分组，链接到具体的幻灯片或段落。每条失分包含：缺失或违反的元素描述；为什么它削弱了论证；具体的改进建议，包含措辞、重写或测试。
3. 薄弱论点：在幻灯片或备忘录中的位置；它试图建立什么；为什么持有异议是合理的；可使其足够的有力事实、数字或逻辑步骤。
4. 逻辑断裂：跳跃、隐藏假设、从原因到建议的路径缺失、因果与相关混淆。
5. 缺失检查点：根据 audit-checklist.md 对于其类型的检查。
6. 可用性：一致性漏洞、缺失描述、不支持的比较、意外的命名、未命名的集合、与注册表或模板的偏差、可读性。
7. 重写 仅在用户明确要求时。报告完成后，提供修正后的故事线或修正后的页面。在修正后的段落上方添加“鉴于以上审核，这里是一个重写：”行。

参考目录

references/
  minto-pyramid.md         # 金字塔原则的结构和术语
  storyline-ghost-deck.md  # 构建幽灵幻灯片的格式和规则
  memo-format.md           # 备忘录的格式和规则
  stage-2-checklist.md     # 阶段二交付前的检查清单
  consulting-practices.md  # 幻灯片审查、证据选择、图表/表格规则
  visual-design.md         # 视觉设计规则：类型、布局、颜色、笔记
  speaker-notes.md         # 演讲者备注的结构
  timing-qa-handout.md     # 计时、问答、讲义准备的规则
  reading-decks.md         # 阅读优先幻灯片的规则
  ibcs-notation.md         # IBCS 符号规则
  audit-checklist.md       # 审核阶段的检查清单
  glossary.md              # 固定术语对应词对
assets/
  templates/               # 用户或雇主的模板
scripts/
  pptx-helpers.js          # pptxgenjs 辅助函数
  example-build.js         # 示例构建文件
  README.md                # 脚本使用文档

触发示例

当用户请求以下内容时触发（即使未提及“Minto”）：

• 幻灯片、演示文稿、讲解、推销、演讲、故事线、幽灵幻灯片、演讲者备注
• 管理层摘要、Kernbotschaft、These、Vermerk、Veranstaltungsbericht
• 以答案优先或 Minto 方式总结
• 希望审核幻灯片或备忘录
• 德语：Folien、Präsentation、Vortrag、Entscheidungsvorlage、Sprechzettel、Deck prüfen

当用户请求以下内容时不触发：

• 转录、翻译、普通总结