培训 PPT 神器·先排课再做页
一页说明
| 项目 | 内容 |
|---|---|
| 给谁用 | 企业内训师、AI 培训讲师、学校老师、做产品/销售内训的人 |
| 解决什么 | 课件越做越像发布会：大标题大留白很好看，上台却讲不下去；或者页数堆满，时间严重超；页上的数字说不清从哪来 |
| 原来几步 | 找模板 → 边做页边想讲什么 → 试讲发现超时 → 删页 → 现场被问“这个数哪来的” |
| 用了以后 | 给课程目标、时长和材料（或上游的课节安排、作业单）→ 助手一次问清缺的 → 拿到逐页大纲表和逐页讲稿，脚本核过时长和证据 → 交给自己或 PPT 工具做页 |
| 产出 | ①逐页大纲表（CSV + 表格）②逐页讲稿（可转 Word）③脚本检查结果 ④待补清单和可能追问清单 |
完整示例见 examples/：虚构的“示例烘焙连锁有限公司”文员培训，第 2 节“逐行核对”70 分钟，11 页。
上下游
- 上游·AI 试点诊断（
ai-pilot-diagnostician）：诊断报告里的基线、根因可以当课件的证据来源（要写出处）。 - 上游·AI 培训设计（
ai-training-task-designer）：它交来的课节安排 CSV、学习目标、作业单就是本技能的骨架——练习和作业页的时间直接沿用，不另编。 - 本技能（页纲 + 讲稿）。
- 下游：讲师自己做页，或把页纲表交给任意 PPT 生成工具；试讲后回填“试讲秒”再跑一次检查。
没有上游产出也能单独用，按第 1 步收材料即可。
运行环境
- 脚本
scripts/deck_plan.py，只用 Python 3 标准库。macOS/Linux 用python3，Windows 用python，下文统一写python3；脚本路径写本技能目录下的完整路径，用户文件传绝对路径并加引号，不必切换目录。 - 先自测：
python3 scripts/deck_plan.py --selftest。 - Windows 输出乱码时设
PYTHONUTF8=1。 - 没有 Python：照样出页纲和讲稿，但时长和字数要标“未经脚本核算”。
- 讲稿转 Word（可选）：
python3 scripts/md2docx.py 讲稿.md 讲稿.docx；页纲表列多，转 Word 时加--landscape。
工作流
每步有检查点。要问用户的一次问完，同时先做不依赖答案的部分。
第 1 步：收材料
需要：
1. 课程主题、对象（岗位、人数、基础）、这节课结束时学员要交出什么。
2. 总时长、交付场景（现场投屏 / 线上直播 / 自学翻看）。
3. 内容材料：课节安排、作业单、教案、资料、数据表、旧课件——有什么给什么。
4. 讲师语速（每分钟字数），没有就请讲师读一段计时 1 分钟；拿不到先用 200 字/分钟作假设。
检查点：
- 缺项按 1–4 一次问全。用户只说“帮我做个 AI 培训 PPT”而没有任何材料：先问清 1、2，同时说明“没有内容材料时，所有事实页都会标待补”。
- 材料里有真实客户、员工、价格信息：提醒用户，并在页纲里用岗位或“示例”替代。
- 用户要“直接给 pptx”：说明本技能出页纲和讲稿（理由：先把课排对，返工最便宜），交付后可把页纲交给 PPT 工具；用户仍坚持，就先交页纲讲稿，不假装生成了文件。
- 用户要“像发布会一样大气”：照 references/排页规则.md 第七节的话术回应，风格写进版式提示。
- 练习素材（虚构记录、虚构资料）用户没给：可以起草，标“示例（虚构）”，参考答案标“草案，由讲师确认”。
第 2 步：排时间骨架
按 references/排页规则.md 第二节：先扣开场、结尾、练习/作业、互动、机动，剩下的分给讲解。有课节安排就直接沿用其中的分钟数。
检查点：写出“总时长 = 开场 + 讲解（含数据、回顾） + 示范 + 提问互动 + 练习/作业 + 点评 + 结尾”的分配，机动时间并进某一页并在控场注明，合计等于总时长。
第 3 步：排逐页大纲
按 references/排页规则.md 第三、四节逐页填页纲（格式见 references/页纲与讲稿模板.md）。
检查点：
- 每页一个学员动作；内容多就拆页。
- 讲解、数据页标题是结论句；提问页标题是问题，答案放后面。
- 每个事实写出处；找不到的标“待补”，冲突的标“冲突”并列两边。
- 数据页写口径，数字从原表或上游脚本结果抄；比率用 python3 scripts/deck_plan.py ratio 名称=分子/分母 ... 核算，写分子分母。
- 标题只放已核的数字；没有原始记录的数字标“待补”（不是“冲突”）。
然后跑检查：
python3 scripts/deck_plan.py check "页纲.csv" --total 总分钟 -o "页纲检查.md"
必须做到：合计等于总时长；“数据问题”为空；连续只讲不做的提醒已处理或说明原因。
第 4 步：写逐页讲稿
按 references/排页规则.md 第五节，每页五段，控场单列，来源单列（格式见模板）。写完连同讲稿再跑一次：
python3 scripts/deck_plan.py check "页纲.csv" --total 总分钟 --script "讲稿.md" --cpm 每分钟字数 -o "页纲检查.md"
检查点：
- 讲解类页偏差超过 30% 的，改稿（删或补）或改页时长，改完合计仍要等于总时长。讲解页里要留学员讨论时间的，拆出单独的提问页，不要靠拉长讲解页时长。
- 练习、提问、示范页脚本只列不比，但口播不能超过整页时长。
- 讲稿里没有页纲里标“待补”的内容被当成事实讲；需要讲师自己的经历或案例时写“待补：讲师案例”，不代编。
第 5 步：交付
交付清单见 references/页纲与讲稿模板.md 末尾（页纲表用 deck_plan.py table 生成）。交付前过 references/自查清单.md。对话里说清：多少页、总时长是否对上、几页待补/冲突、语速是实测还是假设、未试讲，以及“这版能不能直接上台”。
第 6 步（试讲后）：回填实测
讲师试讲后把每页实际秒数填进“试讲秒”列，再跑一次 check。超时的页优先砍讲解、不砍练习。
边界
- 不直接生成 .pptx，不定字号、配色、动画，只给版式提示。
- 不编事实、数字、案例和讲师经历；找不到出处就标待补。
- 不承诺“学员一定学会”“讲完效率提升”；效果评估交给培训设计技能的分层反馈。
- AI 生成的配图只当示意，涉及产品外观、界面、尺寸的用真实截图或官方图。
- 不改用户原文件，产出另存。
参考文件
references/排页规则.md：时间骨架、每页学员任务、标题写法、证据与数据页、讲稿五段、时长核对、不做的事references/页纲与讲稿模板.md：页纲 CSV 列定义、讲稿 Markdown 格式、交付清单references/自查清单.md：交付前自查scripts/deck_plan.py：check检查页纲和讲稿 /table页纲转表格 /ratio核算比率 /--selftestscripts/md2docx.py：Markdown 转 Word（标准库）examples/：虚构课程输入、页纲 CSV、逐页讲稿、脚本检查结果和期望要点
方法来源
方法参考：教学设计中“按学习任务拆页”、演讲准备中“逐页事实映射与时长预算”的通用做法，以及培训课件与发布会式演示的区别；结构、规则和脚本为本技能重新编写，示例全部虚构。
