create-lecture

课程讲座创建工作流

创建一套精美、教学效果出色的 Beamer 讲座幻灯片。

这是一个协作、迭代的过程。讲师负责把握方向；Claude 是思考伙伴。

---

约束（不可妥协）

1. 首先阅读知识库——符号注册表、叙事脉络、应用数据库
2. 每个新符号都必须对照符号注册表检查
3. 先讲动机，再讲形式化内容——无一例外
4. 每个定义后 2 张幻灯片内必须提供一个完整示例
5. 每张幻灯片最多 2 个彩色框
6. 不使用 \pause 或叠加命令（检查项目规则）
7. 在主要概念转折处加入过渡幻灯片
8. 贯穿全程至少使用 1 个实证应用
9. 对照参考文献核实所有引文
10. 每批制作 5-10 张幻灯片——分享以征求反馈，不要一次性大量倾倒

---

工作流

阶段 0：接收材料与了解背景（必须提供预检报告）

阅读输入材料，然后在阶段 1 开始前，于回复中提供预检报告。

需阅读的输入：

• .claude/rules/knowledge-base-template.md——符号注册表、叙事脉络、应用
• .claude/rules/content-invariants.md——INV-1..INV-8 约束幻灯片内容
• 用户提供的任何论文来源／现有幻灯片
• 上一讲的 .tex（最后一节和结束幻灯片），如果存在

预检报告必须包含以下区块：

## Pre-Flight Report

**Sources read:**
- [source 1]: [one-line takeaway — what notation, what result, what diagram]
- [source 2]: ...

**Notation registry check:**
- New symbols this lecture will introduce: [list]
- Symbols reused from prior lectures: [list, with the lecture each was introduced in]
- Conflicts detected: [none / specific clashes]

**Narrative position:** [Where does this lecture sit in the course arc? What did the previous lecture end on? What does the next lecture need you to set up?]

**Pedagogical goal:** [one sentence]

**Running application:** [which real-world example threads through this deck]

说明教学目标，征求用户确认，然后继续。

首次讲座回退方案（全新分支，知识库为空）。 如果 .claude/rules/knowledge-base-template.md 仍包含未填写的占位表格（没有符号注册表条目、没有应用，也没有 Slides/ 中的先前讲座），请勿停下来等待。改为：

1. 说明模板为空，我们正在创建课程的第一讲。
2. 根据用户主题提出一个最精简的初始知识库：包含 5-8 个带有惯例说明的关键符号、1-2 个贯穿全程的应用，以及简短的叙事脉络（引入 → 核心思想 → 影响）。提交用户审批。
3. 将获批的初始内容写入知识库模板，以便后续讲座沿用。
4. 继续阶段 1。

这样可以避免每个新分支都因 /create-lecture 而陷入停滞。

阶段 1：论文分析（提供论文时）

• 将论文拆分成若干部分，提取核心思想
• 将论文符号映射到课程符号
• 确定适合制作成幻灯片的内容
• 提交摘要以供审批

阶段 2：结构提案

• 提出大纲（5 幕或 3 部分模板）
• 列出所需的 TikZ 图示和 R 图形
• 列出需要引入的新符号
• 关卡：用户批准后方可进入阶段 3

阶段 3：起草幻灯片（迭代进行）

• 每批制作 5-10 张幻灯片
• 检查符号，应用创作模式
• 起草过程中进行质量检查

阶段 4：图形与代码

• 按照惯例编写 R 脚本
• 在 Beamer 源文件中编写 TikZ 图示（单一事实来源）
• 保存 RDS，供日后 Quarto 集成使用

阶段 5：润色与编译

• 完整进行 3 轮编译
• 运行 Devil's Advocate
• 运行内容审查（如果已配置领域审阅者）
• 使用新符号更新知识库

---

创建后检查清单

[ ] Lecture compiles without errors
[ ] No overfull hbox > 10pt
[ ] All citations resolve
[ ] Every definition has motivation + worked example
[ ] Max 2 colored boxes per slide
[ ] 2-3 Socratic questions embedded
[ ] Transition slides between sections
[ ] At least 1 running application threaded throughout
[ ] New notation added to knowledge base
[ ] Session log updated
[ ] Devil's Advocate run

交叉引用

• .claude/skills/translate-to-quarto/SKILL.md——将完成的 Beamer 幻灯片移植为 Quarto RevealJS 镜像。
• .claude/skills/qa-quarto/SKILL.md——对 Beamer↔Quarto 进行对抗式一致性检查（循环直至无问题）。
• .claude/skills/deploy/SKILL.md——渲染讲座并发布到 GitHub Pages。
• .claude/skills/scaffold-exercises/SKILL.md——为讲座配套准备习题集和解答。