AutoPPT — скилл

---
name: autoppt
description: AutoPPT（AI备课神器）——只需一句话的课程主题（或一份教学大纲），先了解老师的课程需求，再一键生成一整周精美、可交互的 HTML 教学课件（两节理论课 + 一节实践课，各约 45 分钟）：完整讲稿、浏览器里真实计算的互动、可直接运行的实践代码与 Notebook、学生版、教师指南与出处页；三种风格（学术刊物 / 黑底舞台 / 几何色块）任选。Use when a teacher asks to design / build / 做 / 设计 course slides or 课件, a weekly design doc (设计文档), lecture decks from a syllabus, or says "开干" after a design doc.
---

# AutoPPT（AI备课神器）：一周三节课的交互式 HTML 课件

你要交付的是**一整周可以直接上课的课件**：理论一、理论二、实践课三套 Reveal.js 幻灯片（1920×1080，离线可用），每页有完整讲稿，互动在浏览器里真实计算，实践课代码真实运行并生成 Notebook，另有学生版、教师指南、学生指南、事实出处与图片来源。

参考实现：仓库里的 `examples/week01/`（《人工智能基础》第 1 周，含设计文档）。动手前至少打开它的 `lecture1.html` 和 `第一周 设计文档.md` 看一遍。

## 什么时候用
- 老师第一次来、要做一门课 → 先 ⓪ 需求访谈、① 课程内容设计，老师确认后再做第 1 周。
- 一句话：“帮我做一节 / 一周关于 X 的课件” → **快速模式**：只问学生是谁和风格，其余用默认值，写设计文档并完整实现。
- “设计 / 做第 N 周的课件” → 写设计文档 **并完整实现**。
- “设计第 N 周的课程内容 / 设计文档” → **只写设计文档**；教师说“开干”再实现。
- “根据大纲做课件”“把这门课做成 HTML 课件” → 先建课程大纲与制作约定，再从第 1 周开始。

## 流程（详见 references/workflow.md）
**先了解老师的课，再做课件。** 前两步（⓪①）每门课只做一次，结果要老师确认。

⓪ **了解课程（需求访谈）**——`references/intake.md`、`templates/课程需求表.md`：先读老师给的大纲 / 教材目录 / 旧课件，再用选择题一轮最多 4 问补齐：学生是谁（会不会编程）、几周几节、每周讲什么、实践课做什么（编程 / 案例 / 实验 / 习题 / 写作）、配图政策（能否搜开放图库、能否 AI 生成、是否公开发布）、课件风格。快速模式（老师只说一句）只问学生和风格，其余用默认值并标“假设”。

① **课程内容设计**——产出 `课程大纲.md`（周次表：每周主题、三节课各讲什么、实践课形式、项目里程碑、每周主线、素材计划），**交老师修改确认**；同时建立《课件制作约定》。

**选风格**（在 ⓪ 中一并问）：给用户看 `styles/styles.jpg`，三选一（有选择题工具就用它，否则列编号选项）：
   - **A 学术刊物** `academic`（默认）：暖纸底 · 宋体大标题 · 整句标题 + 图证据
   - **B 黑底舞台** `stage`：深色封面与章节页 · 巨型年份 · 大字金句；内容页冷灰底
   - **C 几何色块** `blocks`：深蓝大色块 · 橙色圆点 · 网格信息；无衬线粗标题
   选定后写进《课件制作约定》，同一门课各周保持一致。

然后每一周：
1. **读**：课程大纲、`课件制作约定.md`、上一周的设计文档与结果、旧课件里**内容**对应的部分。
2. **设计文档**：按 `templates/周设计文档模板.md` 写《第 N 周 设计文档.md》——一句主线、逐页表、新组件、数据与计算、事实核查清单（联网核对）、验收标准、需要教师确认的事。教师修改后以修改版为准。
3. **生成骨架**：
   ```bash
   python3 <本 skill>/scripts/new_week.py --dest <课程文件夹> --week N --style academic --course "课程名" \
       --teacher "教师" --school "学校" --term "学期" --topic "本周主题" --l1 "理论一" --l2 "理论二" --lab "实践课"
   ```
   得到 `weekNN/`（风格写在 `src/styles/theme.css`；换风格 = 把 `src/styles/themes/` 里另一个文件复制过去）：页型样板（每种版式一页）、首页、学生指南、教师指南模板、`build.py`、`start.py`、`tools/run_lab.py`、`week.json`。上一周首页会自动加“第 N 周 →”。