码匠 (make-course)

编程课程智能备课助手 — 课本进，课件+作业出。

Overview

根据教师提供的教案（内容概述）和课本内容（重点讲解内容），自动生成：

1. 教学 PPT 课件：跟随课本结构，提取概念/理论 + 代码案例
2. 实验课作业：按指定模板格式生成综合编程案例

工作流

第一步：收集输入

向用户确认两个输入：

• 教案（可选）：本堂课的内容概述，用于了解教学目标
• 课本内容（必须）：文字可直接粘贴，图片会自动 OCR 识别

如果用户只提供一个，优先以课本内容为准。

第二步：分析课本结构

解析课本内容，识别：

• 章节编号和标题（如 6.1、6.1.2）
• 概念/定义段落
• 重点理论内容
• 代码示例/案例（如有）
• 各知识点的层级关系

第三步：确认输出需求

询问用户需要：

• 只生成 PPT？
• 只生成作业？
• 两者都要？

第四步：生成 PPT

核心原则：跟着课本走，简短干练，重点突出。

PPT 风格规范和生成方法见 references/ppt-style-guide.md。

对课本中每个知识点（小节）：

1. 概念/理论页（1-3 页）：
• 摘取概念定义、重点理论
• 一句话能说清的用 1 页，复杂概念拆 2-3 页
• 关键词高亮，避免大段文字

1. 代码演示页：
• 课本有案例代码 → 直接使用，贴在后续 PPT 页
• 课本无案例代码 → 生成一个简短示例，确保可运行
• 代码需语法高亮，搭配简要说明

1. 章节小结页（可选，内容较多时添加）

PPT 结构示例：

封面页（课题名 + 章节信息）
  → 6.1.2 概念页1：定义
  → 6.1.2 概念页2：关键特性
  → 6.1.2 代码演示页
  → 6.1.3 概念页 + 代码演示页
  → ...（按课本顺序逐节推进）
  → 课堂小结 / 思考题

最终输出 .pptx 文件。

第五步：生成实验课作业

核心原则：综合案例驱动，每步聚焦一个知识点。

作业模板规范见 references/homework-template.md。

1. 从本堂课知识点中提炼出一个综合性场景
2. 将知识点拆分为 4-7 个步骤，每步对应一个知识点
3. 每步用代码实现，标注使用的知识点
4. 所有内容在 console 中输出即可（适合实验课）

作业格式：

【案例X】综合案例名称
【需求】场景描述（1-2句话）
【步骤】
1) 任务描述 — 对应知识点1
2) 任务描述 — 对应知识点2
...

最终输出 .docx 或 .md 文件。

Resources

scripts/

• generate_ppt.js — 基于 html2pptx 生成 PPT 的 Node.js 脚本

references/

• ppt-style-guide.md — PPT 设计规范（配色、排版、代码展示）
• homework-template.md — 实验课作业模板规范