ppt-master 的 instructional 教学模式：用“学习顺序“编排培训型演示文稿的完整指南

ppt-master 的 instructional 教学模式：用"学习顺序"编排培训型演示文稿的完整指南

【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master

导读

在 ppt-master 项目中，一套演示文稿在动笔之前首先要回答一个与视觉无关的问题：这一页一页之间靠什么逻辑前进？本指南以项目权威文档 skills/ppt-master/references/modes/instructional.md 为核心，系统讲解五大叙事模式中的instructional（教学式）模式——它把概念拆解成有序、可消化的学习单元，逐页建立理解，适用于培训、教程、知识讲解、新人 onboarding 与科普分享。读完本文，你将掌握 instructional 模式的叙事骨架、页面结构倾向、演讲者备注语域，以及它如何通过executor-structure、executor-notes等执行层模块真正落到一张张 SVG/PPTX 页面上，并能在与pyramid、briefing等相邻模式的选型中做出准确判断。

1. 什么是 instructional 模式：教学主导的阐述

原文档开篇给出的定义是：

Teaching-led exposition.Decompose a concept into ordered, digestible parts and build understanding step by step.

即：以教学为主导的阐述。instructional 模式不追求"先抛结论再证明"（那是pyramid），也不追求"设悬念、讲故事"（那是narrative），更不追求"铺满事实、便于扫读"（那是briefing）。它唯一的使命是——把一个概念拆成有序、可消化的部分，让理解一步一个台阶地建立起来。

它的典型应用场景在文档中明确列出：training（培训）、tutorials（教程）、explainers（讲解）、onboarding（新人入职）、science / knowledge sharing（科学 / 知识分享）。换句话说，当受众的核心任务不是"做决定"而是"学会某件事"时，instructional 就是首选骨架。

1.1 在五大模式目录中的定位

instructional 是 skills/ppt-master/references/modes/_index.md 中定义的五种预设模式之一。五种模式本质上是五种**"论证策略"（argument strategies）**，而不是沟通目的的穷举分类：

索引文件特别强调了一个关键区分，这也是理解 instructional 的前提：

Mode = 你怎么论证；visual style = 它看起来怎样。两者独立解析，任意 mode 可以与任意 visual style 配对——一套pyramid骨架的 deck 既可以是swiss-minimal也可以是dark-tech。详见 skills/ppt-master/references/visual-styles/_index.md。

因此，选择 instructional 模式只决定"学习顺序与颗粒度"，绝不决定配色、字体或卡片形状。

2. 叙事骨架：分解，然后排序

instructional 模式的第一节给出了叙事骨架的完整原则，这是整个模式的核心。原文列出的五个要点如下：

2.1 分解再排序（Decompose, then sequence）

把主题拆成若干部分，然后按刻意设计的顺序呈现：从简单到复杂、从前置知识到依赖知识、从概览到细节。这正是教学法与写作大纲的本质区别——作者不是按资料的自然顺序罗列，而是按学习者的认知路径重新排序。

例如讲解注意力机制时，合理的排序是"查询向量是什么 → 如何对每个 token 打分 → 分数如何归一化 → 加权求和如何汇总信息"，每一步都建立在前一步之上。

2.2 聚焦学习单元（Focused learning unit）

每一页都围绕一个连贯的教学步骤展开。只有当两个概念的关系本身就是学习者需要理解的对象时，才允许它们共享一页。这个原则直接约束了页面颗粒度：宁可多一页，也不要把三个互不相干的步骤挤进一页。

2.3 平行展开（Parallel exposition）

并列的概念要获得并列的结构——相同的形状、相同的深度。当一页同时呈现三个同级概念（例如三种归一化方法）时，它们应该用同样结构的卡片、同样的信息层级呈现，这样受众才能直接对比和映射。这恰好与 skills/ppt-master/references/executor-structure.md 中的contrast（对比）关系原子相呼应——共享基线加分离的平行区域，是并列教学内容的天然拓扑。

2.4 具象化抽象（Ground abstraction）

当一个具体示例或类比有助于阐明原理时，就使用它；示例与解释的先后顺序取决于学习者的前置知识需求。对零基础受众，通常"先示例、后原理"；对已有背景的受众，可能"先原理、后示例"更高效。这与narrative模式用隐喻让抽象变得可触（"like adding a turbocharger"）思路相通，但 instructional 的使用更克制、以阐明原理为准绳。

2.5 路标（Signpost）

持续为学习者指明方向——"我们刚才覆盖了什么，接下来将发生什么"。路标是教学 deck 与纯资料 deck 的重要差异：它让学习者在长链条中始终知道自己身处何处。

2.6 标题法则：清晰优于机巧

原文档给出了明确的标题规范：

Titles state what the page teaches ("How attention weights are computed") — clear over clever.

即标题直接陈述"这一页教什么"，例如"如何计算注意力权重"，追求清晰而非机巧。这与pyramid的"断言式标题"（结论即标题）和briefing的"主题式标签"（如 "Q3 headcount by team"）形成三档差异：instructional 的标题是动作/过程导向的学习声明。

3. 页面结构倾向：为教学过程服务的版式

原文档第二节给出三条页面结构倾向：

1. 流程用编号步骤 / 有序流程，并列概念用平行卡片：1 → 2 → 3的编号步骤天然承载"顺序"，平行卡片承载"对比"。从源码实现看，这些定性拓扑正是由 executor-structure.md 的"关系原子"在运行时生成的——教学最常用的order（顺序、递进、排序）原子，可用一条开放的阅读路径承载（直线/折线/阶梯/盘旋，平/升/降，恒定/扩张/收缩），配以转折点与里程碑；而"前置知识 → 依赖知识"的递进关系则可用link（依赖、影响、过渡）原子表达为链式路径。文档明确指出这些原子"按实际单元、文字负载、页面角色与视觉系统适配"，绝不是照搬示意图。

2. 图表渐进式构建，并注释当前正在讲解的部分：教学场景下，一张图不应一次全部出现。渐进式构建（progressive build）意味着"先画骨架、再逐块填充、每出现一块就标注它在讲什么"。这与 ppt-master 的动画能力直接衔接——executor-base.md要求"连续动作的两个可见端点状态在写页面时就同时落笔"，后续由animations.json绑定为 slide-in、progressive reveal 等动作，见 skills/ppt-master/references/executor-base.md 的 Motion endpoints 规则。

3. 具体示例锚定抽象要点：当示例能改善迁移（transfer）或理解时，用具体示例锚定抽象点。示例不是装饰，而是理解杠杆。

原文档同时划定了模式与执行层的职责边界：

步骤、流程与图表拓扑在运行时通过executor-structure.md编排；数值驱动的教学图表仍留在templates/charts/目录中。模式只决定学习顺序与颗粒度。

这意味着 instructional 模式是"骨架层"决策，而具体的卡片、连线、图表形状属于"执行层"决策——executor-base.md 中 Executor 的每页决策链（Step 3 拓扑决策、Step 5 载体混合、Step 7 构图、Step 8 几何动作）会接手剩余工作。

4. 演讲者备注语域：耐心、解释性、会话式

原文档第三节给出 instructional 模式的演讲者备注（speaker notes）语域，这是教学中"说出来的话"应该呈现的样子：

Patient, explanatory. Define before using; analogy then principle. Anticipate the learner's question and answer it. Steady pace; signpost transitions ("now that we have X, we can ask Y"). Conversational data.

拆解为五条可执行准则：

• 先定义，后使用：任何术语第一次出现时必须先给出定义，绝不默认受众知道。
• 类比在前，原理在后（analogy then principle）：先用类比建立直觉，再落到正式原理。
• 预判学习者的问题并回答：站在学习者视角主动抛出"你可能会问……"并当场解答。
• 平稳节奏 + 路标式转场：典型句式是 "now that we have X, we can ask Y"（既然我们有了 X，就可以问 Y 了）——页与页之间用"已掌握 → 下一步问题"的方式桥接。
• 会话式数据：数字用口语化表达（"nearly a third"、"more than doubled"），而不是干巴巴念报表。

这一语域在生成侧有专门的落地规则。原文档注明其公共框架是executor-notes.md的 §1。查看该文件可知：完整演讲稿要一次性写入notes/total.md（每页# <序号>_<页标题>标题 +---分隔），且notes_to_audio.py会逐字朗读正文，所以正文必须是纯散文——不得出现列表标记、舞台指示、要点标签、时长行等元数据；数字和符号要按 TTS 的读音习惯展开（中文场景写"百分之六十八"而非"68%"）。也就是说，instructional 语域中的"会话式数据"在演讲稿里要落实为真实的口语化措辞，而不是视觉页上的编号列表。这正是 executor-notes.md §1 所要求的"一条文字只写散文"。

5. 页面骨架示例：三层一页的最小模板

原文档第四节给出了 instructional 模式最精华的实操模板——每页由三层构成：

Title: "Step 2 — Scoring each token against the query" Body: concrete example (3 tokens) → the rule it illustrates → one diagram Notes: "Remember the query from the last page? Here's what it does next…"

逐层解读：

• Title（标题）：直接声明本页的教学步骤（"第 2 步——让每个 token 与查询打分"）。注意它自带序号前缀，这是 instructional 模式"路标"原则在标题层的体现。
• Body（正文）：固定三段式节奏——具体示例（3 个 token）→ 示例所说明的规则 → 一张图。这正是 2.4"具象化抽象"的页面级落地：先让学习者看到具体例子，再提炼规则，最后用图固化心智模型。
• Notes（备注）：用上一页建立的路标开场（"还记得上一页的查询吗？接下来它要做的是……"），实现平稳转场。

对比其他模式的页面骨架可以更清晰地看出差异：pyramid的骨架是"结论标题 → 一句话要点 → 支撑论证 → 来源页脚"（见 pyramid.md）；narrative的骨架是"全幅图像 + 一句转折 → 重构 + 一个焦点数字"（见 narrative.md）；briefing的骨架是"主题标签标题 → 等权重状态表 → 平淡读稿"（见 briefing.md）。只有 instructional 把"示例 → 规则 → 图"的内嵌循环作为页面常量。

6. 阅读模式与教学密度的配合

instructional 模式的"理解优先"目标，与 executor-base.md §2.2 定义的三种consumption_mode（阅读模式）配合使用。在design_spec.md中记录为delivery_purpose（仅 PPT）：

需要特别注意的是：当备注被禁用时，绝不能假设备注会承载内容而删减页面（executor-base.md 的显式规则）。教学场景下如果选择了presentation阅读模式却关闭了备注，就会违背"聚焦学习单元"原则——这一点必须在规划阶段就锁定一致。

另外，page_rhythm（页面节奏标签anchor/dense/breathing，见 executor-base.md §2.2 Step 4）为教学 deck 提供了密度编排工具：概念讲解页用dense，里程碑/小结页用breathing制造呼吸感，封面/章节页用anchor。这是"学习单元"颗粒度的版式层实现。

7. 从策划到执行：mode 如何贯穿整条流水线

instructional 模式不是一篇孤立的文档，它在 ppt-master 的生成流水线中拥有明确的"入口"与"出口"。理解这条链路有助于真正用好它：

7.1 策划层：Strategist 锁定 mode

在 skills/ppt-master/references/strategist.md 的 Stage 2 中，d. Mode + Visual style是必须确认的样式目标项，且遵循自上而下的方向构造：先从已确认的沟通契约与素材出发撰写三个完整的解决方案意图，再选择目录基准。modes/_index.md是唯一的 mode 基准权威（GATE），一次 deck 只解析一个mode——要么是pyramid/narrative/instructional/showcase/briefing中的某个预设，要么是带行为描述的custom。选择结果记录在design_spec.md，并投影到spec_lock.md；Executor 只读取锁定的预设文件或 custom 的精确引用。

索引文件特别提示了custom逃生舱：当 deck 需要多模式融合（例如"先教学后说服"）时，应该将其声明为一个custom行为——在行为段落中写出可执行的节奏——而不是同时挂多个 mode。

7.2 执行层：Executor 按 mode 的语域与颗粒度出页

Executor 读取锁定的 instructional 预设文件后，会把"学习顺序与颗粒度"落实到每页决策链（executor-base.md §2.2）：Step 1 沟通追踪（页面必须推进目标）、Step 3 拓扑决策（用executor-structure.md的关系原子承载教学关系）、Step 5 载体混合、Step 8 几何动作。教学页中典型的order（步骤链）、parent（父概念分解为子概念，用分支/嵌套/放射呈现）、membership（概念归属某个阶段或车道，用容器/条带/泳道呈现）都是该语法中的一等公民。

7.3 备注层：启用 speaker notes 才进入 TTS 链路

由于 instructional 的语域主要作用于"说出来的话"，当design_spec.md §I的 Speaker Notes 有效结果为 enabled 时，Executor 会在全部 SVG 页面通过质检后加载 executor-notes.md 分支，以最终 SVG 为准撰写完整演讲稿（notes/total.md），再经notes_to_audio.py转语音。教学 deck 如果同时启用 narration（旁白配音），则notes/total.md就是配音逐字稿——因此 instructional 语域中的"会话式数据""路标转场"必须直接写进这篇文档的正文，而不能只存在于设计意图里。

8. 选型判断：instructional 与相邻模式怎么选

modes/_index.md的"决策区分"小节给出了最容易混淆的两对模式，其中直接涉及 instructional 的是：

判断要点：如果受众看完 deck 后要能"解释、复现或应用"某个知识，选 instructional；如果受众只需要"查到自己需要的条目"，选 briefing。两者的标题与页面结构倾向是相反的——instructional 用"本页教什么"的过程性标题与示例-规则-图循环，briefing 用"主题是什么"的标签性标题与表格/定义列表。同时注意briefing是五种模式中"重塑最少"的（对既有大纲约束最轻），而 instructional 会主动对大纲做重组、重排、重命名——前提是保留事实与既定关系（content_divergence边界内的重排是模式的本职工作，用户明确要求保留顺序/标题/措辞时除外）。

9. 实践自检清单

基于上述内容，将 instructional 模式落到实际 deck 时建议逐项自查：

• 单页单步：每一页是否只承载一个连贯的教学步骤？共享页面的两个概念是否因为"它们的关系"本身需要被理解？
• 顺序刻意：页面顺序是否符合"简单 → 复杂 / 前置 → 依赖 / 概览 → 细节"？是否存在按资料原始顺序而非学习路径排列的情况？
• 平行结构：同级并列概念是否使用了相同形状、相同深度的结构，便于受众对比？
• 示例-规则-图循环：抽象概念页是否都有"具体示例 → 规则 → 一张图"的闭环？图表是否渐进式构建并标注了当前讲解部分？
• 标题教什么：标题是否陈述"本页教什么"，而不是机巧的双关或笼统的主题标签？
• 备注语域：演讲稿是否先定义后使用、类比在前原理在后、预判并回答了学习者的问题？转场是否采用"既然有了 X，就可以问 Y"的路标句式？数字是否为会话式表达？
• 阅读模式一致：consumption_mode是否与备注开关、教学自足性需求一致（备注关闭时绝不删减页面内容）？
• 单 mode 约束：整副 deck 是否只解析了一个 mode（含 custom 融合时的单一行为描述）？design_spec.md/spec_lock.md是否记录了 mode 与理由？

结语

instructional 模式是 ppt-master 五大叙事骨架中"最像老师"的一个：它不替你下结论，不替你讲故事，也不替你陈列事实，而是替学习者安排认知的台阶。它的全部力量来自五条叙事骨架原则（分解再排序、聚焦学习单元、平行展开、具象化抽象、路标）与一套鲜明的语域（耐心、解释性、会话式），并最终通过executor-structure的关系原子、executor-notes的逐字稿规则与consumption_mode的阅读模式在 SVG/PPTX 页面上具象化。当你的 deck 目标是"让受众真正学会"，而不是"让受众做出决定"或"让受众查到条目"时，instructional 就是你应该锁定的那一个模式——训练、教程、讲解、onboarding 与科普分享场景下，它始终是与视觉风格完全解耦、可以放心与任意风格配对的第一选择。

【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master