一、这个 skill 是做什么的
training-deck 专门用来做「培训课件 / 教学幻灯片」——新员工 onboarding、产品使用培训、方法论宣贯、公开课讲义都算。它的重点不是炫技,而是易讲、易学、易复习。
它遵循一套「一页一概念 + 图示化 + 节奏感」的方法:每页只讲一个概念,信息密度适中(正文 ≤ 40 字或 ≤ 5 条),细节放进讲义 / 备注,不堆满屏;流程用 card + badge + 连线,对比用双栏,概念用比喻图;模块间用暗色分隔页做「翻篇」,暗 / 亮交替防疲劳。
它复用 premium-pptx 的 ppt_components 与 design_systems,默认用 education(深靛蓝 + 暖琥珀,亲和有活力)。所有文字、图表、示例代码都是可编辑的,示例代码用等宽文本框,方便学员直接复制。
二、什么时候用它
- 你说:「帮我做一套新员工入职培训课件。」
- 「我要给客户讲产品用法,需要一页一概念、好跟练的讲义。」
- 「做个公开课 PPT,信息别太密,学员看得过来。」
- 「把这个方法论做成培训材料,要有概念页、讲解页、示例页、练习页。」
- 可能的原话信号:培训课件、讲义、onboarding、教学 PPT、公开课、方法论宣贯、学员跟练。
三、前置条件 / 准备
- 本机安装 Python 3,并安装依赖库:
pip install python-pptx(只需一次)。
- 无需账号、无需 API Key、无需联网——本地完成。
- 准备好培训主题、学习目标(建议 3–5 条、动词开头,如「能搭建 / 能排查」)、模块划分与示例。
- 视觉系统依赖 premium-pptx 的
assets/ 资源(已随 skill 安装)。
四、具体用法(步骤)
- 定设计系统:默认
education(亲和不刻板);企业内训偏正式可用 diplomatic 或 finance_blue,技术类培训用 tech_deep_space。
- 按模块组织:封面 → 学习目标 → 课程地图 → 每个模块(概念页 / 讲解页 / 示例页 / 练习页)→ 总结 → 附录资源。每模块 3–5 页。
- 写每页要点:页标题就是概念名(如「什么是 Webhook」),不是「第三章第二节」;每页正文 ≤ 40 字或 ≤ 5 条。
- 先出 HTML 预览:让 AI大模型或AI智能体 先给浏览器可看的预览,确认结构节奏。
- 确认后生成 PPTX:用 python-pptx 输出全可编辑课件;过 QA 清单(一页一概念、密度适中、图示化、有分隔页、代码可复制)。
五、可直接照用的示例
你直接对 AI大模型或AI智能体 说:
「帮我做一套『Webhook 入门』的培训课件,要有概念页、讲解页、一个最小示例、再加一道自测题。」
AI大模型或AI智能体 会:
用 education 设计系统,按模块搭:概念页标题直接叫「什么是 Webhook」+ 一句比喻(系统间的『反向 API』),讲解页用 card + badge + 连线画出「事件发生 → 推送回调」流程,示例页放一段可复制的代码,练习页给一道自测任务。先给你 HTML 预览,确认后出 PPTX。
你直接对 AI大模型或AI智能体 说:
「课件信息量别太大,学员看不过来,每页就讲清楚一个点就行。」
AI大模型或AI智能体 会:
严格控制「一页一概念」:每页正文 ≤ 40 字或 ≤ 5 条,细节进备注 / 附录;模块之间插入暗色分隔页做节奏翻篇,暗亮交替防止学员疲劳。
进阶 / 可选(代码方式)
下面是用共享库搭「概念页」的核心做法(大白话:绑定 education 配色,用 card 放定义、badge + hrule 画流程)。普通用户只需说出需求,不必自己写。
import sys; sys.path.insert(0, r"/skills/premium-pptx/assets")
from ppt_components import *
import design_systems
use_palette(design_systems.get("education"))
prs = Presentation(); prs.slide_width = Inches(13.333); prs.slide_height = Inches(7.5)
s = prs.slides.add_slide(prs.slide_layouts[6]); bg(s, IVORY)
header(s, "Concept", "什么是 Webhook")
card(s, 0.8, 2.1, 6.0, 4.4, PAPER, LINEL, 1.0, 0.08, topbar=True)
paragraphs(s, 1.15, 2.5, 5.3, 3.6, [
{"text":"Webhook 是系统间的『反向 API』", "size":16, "color":GOLD, "bold":True, "font":F_HEAD},
])
六、常见注意 / 避坑
- 一页别塞满 200 字:学员看不过来,细节进备注 / 附录,保持每页 ≤ 40 字或 ≤ 5 条。
- 标题应是概念本身:不要写「第 X 章第 Y 节」当标题,要写「什么是 Webhook」这种概念名。
- 别全是文字无图:教学靠图示与类比,不是念稿;流程用 card + badge + 连线,对比用双栏。
- 代码要可复制:示例代码用
F_MONO 等宽文本框,方便学员直接拷贝。
- 动画从简:商务 / 教学场合不加花哨动画,最多简单渐入。
七、相关 skill / 延伸
- premium-pptx:本 skill 的视觉底座,提供外交级设计系统与共享绘制库。
- pitch-deck:同体系的融资路演生成,默认
finance_blue 设计系统。
- pptx-generator:更轻量的通用 PPT 生成器,结构化课件更推荐用本 skill。