pedagogy-review（教育学幻灯片审查）Skill 是什么？

教育学幻灯片审查Skill：让每一页讲义都经得起教学法的推敲

核心结论速览：

它是什么：pedagogy-review 是一个面向讲座幻灯片（讲义）的教育学审查技能，专门从"学生能不能学会"的角度，而不是"页面好不好看"的角度，对幻灯片做一次系统体检。
它查什么：围绕叙事弧线、学生先决条件、工作示例（worked examples）、符号清晰度、幻灯片节奏等维度，内置 13 个教育学模式做遵循/违反判定，并给出幻灯片级评估。
它产出什么：一份结构化审查报告，自动落盘到 quality_reports/[文件名去扩展名]_pedagogy_report.md，并附上最关键的 3-5 条建议。
它不做什么：只读审查，绝不修改你的任何源文件；也不做视觉布局检查（那是 /visual-audit 的职责），综合体检则用 /slide-excellence。
适合谁用：给本科生/研究生上课的高校教师、做技术分享与内训的工程师、写课程材料的教研与教学设计人员。

一、该技能叫什么？如何一键安装 AI 技能提升开发效率？

1.1 技能基本信息

项目	内容
技能中文名	教育学幻灯片审查Skill
技能英文名	`pedagogy-review`
技能ID	13617
输入参数	`[QMD 或 TEX 文件名]`，即 Quarto 的 `.qmd` 源文件或 LaTeX 的 `.tex` 源文件
可用工具权限	`Read`、`Grep`、`Glob`、`Write`、`Task`
输出位置	`quality_reports/[FILENAME_WITHOUT_EXT]_pedagogy_report.md`
性质	只读审查，不编辑任何文件

它解决的是一个非常具体、也非常常见的痛点：老师做幻灯片时，注意力几乎全部花在"内容对不对"和"排版好不好看"上，而"这段讲法对学生是否可学"往往无人把关。 一页页精心排版的 PPT，可能在前置知识铺垫上出现了断层，可能在关键推导处省略了工作示例，也可能符号定义前后不一致，导致学生在第三页就跟不上了。这个技能把"教学法审查"这件事自动化，让 AI 以一个有经验的教学设计者 + 挑刺学生的心态，把讲义从头到尾读一遍。

1.2 "一键安装"的思路与步骤

所谓"一键安装 AI 技能"，本质是把这套审查流程（提示词 + 工具权限 + 产出规范）封装成一个可以被直接调用的技能条目，让团队成员或未来的自己不必每次重新写一遍长提示词。通用流程如下（具体安装入口、命令与目录约定以你所使用的 AI 客户端/技能市场的官方说明为准）：

准备前提：确认你的 AI 编程客户端支持技能（Skill）机制，并已开通 Read / Grep / Glob / Write / Task 这类本地文件与子任务能力——因为这些正是本技能读取幻灯片源文件、生成报告的依赖。
获取技能：通过技能市场搜索技能英文名 pedagogy-review 或技能ID 13617 获取该技能（安装命令与市场链接以官方说明为准）。
放入技能目录：按官方约定把技能文件放到本地技能目录中完成安装，安装后技能会被自动索引。
验证是否生效：在对话/命令面板中输入 /pedagogy-review（技能名即调用入口），若技能被正确识别，它会提示你指定要审查的讲座文件；也可以直接带上参数调用，如 /pedagogy-review lecture03.qmd。
确认产出链路：随便挑一份讲义试跑一次，检查项目下是否生成了 quality_reports/xxx_pedagogy_report.md。有报告落盘，说明安装与写入权限都正常。

提示：如果你所在环境不支持 / 形式的斜杠命令，也可以直接用自然语言描述"请用 pedagogy-review 技能审查 lecture03.qmd"，效果一致；具体调用形式以官方说明为准。

为什么说这一步能提效？ 因为审查标准被"固化"了：13 个教育学模式不会再漏检，报告命名不会再各写各的，团队里每个人拿到的是同一种格式、同一套评判口径的反馈——这正是把个人经验沉淀为可复用资产的价值。

二、该技能的主要功能和特点

13 个教育学模式的全覆盖检查：技能内置 13 个教育学模式（pedagogical patterns），审查时会逐一判定每个模式是"被遵循"还是"被违反"，形成一份可核对的清单式结论，而不是笼统地说"讲得还行"。
叙事弧线分析：关注整份讲义是否有一条清晰的教学推进线索——从引入、铺垫、展开到收束，而不是知识点的简单堆叠。
学生先决条件审视：从学生视角出发，检查讲授某个概念前是否已补齐必要的前置知识，避免"默认学生会"造成的空中楼阁。
工作示例检查：审查关键知识点是否配有可跟随的示范性解题/推导过程，而不是只给结论和公式。
符号清晰度检查：排查符号定义是否前后一致、是否在首次出现时说明含义，减少学生因记法混乱产生的无谓认知负荷。
幻灯片节奏与视觉节奏评估：以幻灯片为单位分析信息密度与推进速度，识别"某几页信息过载、某几页空转"的节奏问题。
面向学生的异议预判：以学生视角设想可能的困惑与反驳点，提前暴露教学中容易卡住的位置。
自动生成结构化报告：审查结果输出为 Markdown 报告，保存到 quality_reports/[文件名去扩展名]_pedagogy_report.md，便于归档、对比与分享。
只读、零风险：技能只读取文件、不修改文件，任何修改决定权仍在教师手里——这对珍贵的课程源文件非常重要。
职责边界清晰：明确不做视觉布局检查（交给 /visual-audit），综合审查交给 /slide-excellence，避免不同技能互相"越界打架"。

和普通工具比强在哪？ 普通拼写检查、语法检查、Markdown linter 只能看形式；通用 AI 对话也能给一些泛泛建议，但每次口径不一、容易漏项、也懒得读完整份讲义。这个技能的差异在于：固定的检查维度（13 个模式）+ 固定的分析层次（幻灯片级）+ 固定的产出物（报告文件），把"随缘点评"变成了"可重复的审查流程"。

三、如何使用该技能？

步骤 1：确认要审查的讲座文件

技能支持 Quarto（.qmd）与 LaTeX（.tex）两种源文件，参数即文件名：

/pedagogy-review lecture05.qmd

步骤 2：处理"没给参数"的情况

如果你只输入 /pedagogy-review 而不带参数，技能会主动询问你要审查哪一讲；如果你只给了一个不含路径的名字（例如 lecture05），技能会在 Quarto/ 或 Slides/ 目录中查找对应文件。所以目录约定最好保持稳定，能省掉反复确认路径的时间。

步骤 3：技能自动启动教育学审查代理

技能会用完整文件路径启动教育学审查代理，代理执行三件事：

检查 13 个教育学模式的遵循与违反情况；
执行幻灯片级分析（叙事弧线、节奏、视觉节奏、符号）；
切换到学生视角（先决条件是否满足、有哪些可能的异议）。

步骤 4：读取生成的报告

审查完成后，报告会自动保存到：

quality_reports/[FILENAME_WITHOUT_EXT]_pedagogy_report.md

例如审查 lecture05.qmd，报告通常落在 quality_reports/lecture05_pedagogy_report.md（具体文件名以技能实际生成为准）。

步骤 5：查看摘要并决定改什么

技能会向你呈现摘要，包含三块内容：

遵循与违反的模式（共 13 个），一眼看出哪些教学法要求没做到；
幻灯片级评估，定位问题具体出在第几页、哪一段；
关键建议（前 3-5 条），即"如果只改五处，先改这五处"。

输入输出示例（示意）

输入：/pedagogy-review lecture05.qmd

输出（摘要示意，非真实数据）：

教育学模式：遵循 9 / 违反 4
幻灯片级评估：第 12-15 页信息密度偏高；符号 g 与 G 混用；工作示例缺失于"贝叶斯更新"一节
关键建议：
1. 在第 8 页前补充条件概率的快速回顾，满足先决条件
2. 为"贝叶斯更新"增加一个完整演算的工作示例
3. 统一第 12 页起对增益符号的写法
4. 拆分第 14 页，降低单页认知负荷

步骤 6：按需组合其他技能

只想看视觉/排版问题 → 用 /visual-audit；
想要教学法 + 视觉的综合体检 → 用 /slide-excellence 代替本技能；
想要修改讲义 → 本技能不写文件，请在拿到报告后自行或另用编辑类技能完成。

四、同类型竞品对比分析

方案名称	定位	核心功能	安装/使用门槛	适用场景	优势与不足
pedagogy-review（本技能）	讲座幻灯片的教育学专项审查	13 个教育学模式检查、叙事弧线、先决条件、工作示例、符号清晰度、节奏、学生视角、自动生成报告	需支持技能机制的 AI 客户端；一条 `/pedagogy-review 文件名` 即可调用，门槛低	高校讲义、内训课件、课程材料定稿前的教学法体检	优势：维度固定、口径统一、只读安全、产出可归档；不足：只覆盖教育学维度，视觉与内容正确性需配合其他工具
人工同行评审 / 教研组互评	传统的教学质量把关方式	由同事听课或阅读讲义后给出口头/书面意见	需协调时间与人手，组织成本高	重要课程、公开课、教学竞赛	优势：经验判断深、能捕捉微妙语境；不足：周期长、意见主观、难以覆盖全部 13 个维度且不易沉淀
通用 AI 对话（直接让聊天模型读讲义）	通用大模型辅助审阅	自由提问，如"帮我看看这份讲义有什么问题"	门槛最低，粘贴文本即可	快速获得零散灵感	优势：灵活、零配置；不足：每次口径不同、容易漏项、无固定报告产物、长文档容易只读一部分
`/visual-audit` 视觉审查技能（同族）	幻灯片视觉审查	检查版面、对齐、层级、可读性等视觉问题	同为技能调用，门槛与本体相当	排版返工、模板统一	优势：与教学法审查互补，边界清晰；不足：不评估教学逻辑与学习路径，不能替代本技能
`/slide-excellence` 综合审查技能（同族）	教学法 + 视觉的组合审查	一次性给出综合评估	同为技能调用	定稿前的最后一道关	优势：一步到位；不足：单维度深度不及专项技能，问题定位颗粒度可能更粗

怎么选？ 一句话判断：要"讲得对不对、学得会学不会"→ 本技能；要"看着舒不舒服"→ 视觉审查；要"全都想要"→ 综合审查。

五、该技能的典型应用场景与实际体验情况

场景一：高校教师新课件的定稿前自检

角色与痛点：一位讲授统计/机器学习课程的教师，讲义已经写到第 10 讲，但每讲都是"赶出来的"，很难判断学生是否跟得上。自己重读时容易陷入"我知道我在说什么"的盲区。

使用方式：在每讲定稿前运行 /pedagogy-review lecture10.qmd，重点看"先决条件"与"工作示例"两栏的违反项，逐条决定是否补一页回顾、加一个演算示范。

实际体验：上手几乎没有难度——记住一个命令和参数格式即可。真正有价值的是它站在学生视角提异议，那些"我以为大家都懂"的地方往往会被点出来。注意事项：报告里的建议是"可讨论的建议"而非"必须执行的命令"，需要教师结合课时与学情做取舍。

场景二：企业内训讲师与技术分享者

角色与痛点：工程师转做内部培训，技术内容没问题，但经常被反馈"讲得太快"“听不懂”“例子太少”。

使用方式：把分享稿的源文件交给技能审查，重点关注"幻灯片节奏"与"视觉节奏"结论，识别信息过载的单页；再按"关键建议前 3-5 条"做小步修改。

实际体验：节奏类问题肉眼很难自查，工具的幻灯片级评估能把问题定位到具体页码，修改起来非常省事。注意：技术分享中刻意的高密度页有时是合理的，不要把"违反"当成绝对错误。

场景三：教研团队统一课程质量口径

角色与痛点：一门课由多位老师分讲，风格差异大，教研组想建立统一的审查标准，但每次开会逐页过太耗时间。

使用方式：规定每位老师提交讲义前先跑一遍本技能，把 quality_reports/ 下的报告作为教研会的讨论底稿。

实际体验：因为 13 个教育学模式和报告路径都是固定的，横向对比不同讲次变得可行。注意事项：报告文件会持续累积，建议按讲次或学期归档，避免目录膨胀。

场景四：课程材料的迭代与回归检查

角色与痛点：课程每学期都要小改，改着改着叙事弧线可能被打断，早先补上的工作示例也可能被误删。

使用方式：每轮修改后重跑一次审查，对比新旧报告中"违反项"数量的变化，把它当作一种教学法层面的回归测试。

实际体验：只读设计让这件事毫无心理负担——跑多少次都不会动到源文件。长期坚持后，违反项通常呈下降趋势，讲义的可学性提升是能被"数出来"的。

六、该技能能为用户带来的价值

把"教学法审查"从没人做的事，变成一分钟能做的事：过去需要请同行抽时间通读一遍讲义，现在一条命令就能拿到覆盖 13 个模式的结构化反馈，审查这件高价值但高成本的事终于有了可持续的执行方式。
降低教学设计门槛：不是每位讲者都受过教学法训练。技能把叙事弧线、先决条件、工作示例、符号清晰度、节奏这些原本属于"教学专家语感"的判断，转译成了可读、可核对的检查项，让非教育专业出身的讲者也能按图索骥地改进。
问题定位精度高，返工成本低：报告提供幻灯片级评估，问题能落到"第几页、哪一类"，避免"整份重写"的粗暴返工，修改量通常集中在少数几页。
口径统一带来的长期资产价值：统一的 13 项标准 + 统一的报告路径，使课程质量可以被纵向追踪（同一讲次逐学期对比）与横向对比（不同讲次、不同教师之间），为教研管理提供事实依据。
零风险的审查体验：只读审查意味着你可以放心地在任何阶段反复运行，不必担心珍贵源文件被误改。
可量化的收益参考：以"违反项数量"作为核心指标，一轮修改通常能集中消解报告列出的前 3-5 条关键建议；把违反项从两位数压到个位数，往往就是一轮迭代的现实目标（具体改善幅度取决于原稿质量与投入时间）。

七、常见问题 FAQ

Q1：这个技能怎么安装？安装后怎么确认能用？

A：通过技能市场获取英文名 pedagogy-review 或技能ID 13617 对应的技能，按官方约定放入本地技能目录完成安装（具体安装命令与目录以官方说明为准）。验证方式很简单：输入 /pedagogy-review，若它反问你"要审查哪一讲"，说明已生效；再跑一次真实文件，确认 quality_reports/ 下生成了 *_pedagogy_report.md，即写入链路正常。

Q2：它是收费的吗？

A：技能本身的定价、是否需要订阅或额度，取决于你获取它的平台与账户方案，请以官方说明为准。本文不对价格做任何承诺。可确定的是：它运行在你自己的 AI 客户端环境中，审查过程消耗的是该环境的模型调用额度。

Q3：它会不会改坏我的讲义源文件？

A：不会。这是只读审查技能，仅使用读取与检索能力分析文件，产出是一份新的报告文件，源文件不会被编辑。真正的修改由你自己决定并执行。

Q4：它和 /visual-audit、/slide-excellence 应该怎么选？

A：按关注点选。只想解决"讲得对不对、学生跟不跟得上"→ 用本技能（/pedagogy-review）；只想解决"排版、对齐、可读性"→ 用 /visual-audit；想要教学法与视觉一次性综合体检 → 用 /slide-excellence 代替本技能。三者边界清晰，不要指望一个技能包打天下。

Q5：适合谁用？对文件格式有什么要求？

A：最适合高校教师、教研与教学设计人员、企业内训讲师、技术分享者，以及任何需要产出"别人能学会"的讲义的人。文件格式上，技能面向 Quarto（.qmd）与 LaTeX（.tex）源文件；若你只给文件名而不给路径，它会在 Quarto/ 或 Slides/ 目录中查找，因此保持这两个目录约定能显著减少来回确认。