| name | teaching-materials |
| description | 中小学教学文档智能生成工具。当用户需要制作课件（PPT）、编写教学设计（教案）、或创建学生任务单（导学案）时使用此技能。支持数学、语文等学科的备课、课堂巩固、课后作业等教学场景的文档生成。 |
中小学教学文档技能
概述
本技能为中小学教师提供课件、教学设计、学生任务单等教学文档的智能化生成能力。通过预设的模板框架和结构化提示，帮助快速生成规范的教学文档。
适用场景
- 制作课件（PPT）- 数学、语文等学科
- 编写教学设计/教案
- 创建学生任务单/导学案
- 备课、说课、公开课文档准备
- 课后作业单、单元测试卷设计
- 下载/获取网络教学资源（课件、教案、任务单等）
支持的学科
- 语文：古诗词、现代文阅读、作文指导等
- 数学：数与代数、图形与几何、统计与概率等
支持的文档类型
1. 课件（PPT）
适用于新授课、复习课、练习课等课型。
【强制要求】课件必须有配图：
- 数学课：情境图、示意图、思维导图、几何图形
- 语文课（古诗词）：诗人画像、诗意意境图、时代背景图
- 具体配图要求参考
references/ppt_guide.md
【强制要求】课件必须美观专业：
生成 PPT 时必须使用 dragon-ppt-maker 脚本（~/.workbuddy/skills/dragon-ppt-maker/ppt_maker.py），该脚本支持：
- 渐变背景（非纯色）
- 图文混排布局
- 多种主题风格（tech/modern/corporate）
- 自动排版与对齐
禁止使用 pptxgenjs 直接生成简陋的纯文字 PPT。
课件视觉设计规范（参考 PPT视觉设计技能）：
| 设计要素 | 规范 |
|---|
| 配色 | 不超过3种主色，参考下方的学科配色方案 |
| 字体 | 标题≥36pt粗体，正文14-18pt，最多2-3种字体 |
| 留白 | 页边距≥10%，元素间距≥20px |
| 每页内容 | ≤5个要点，不堆砌文字 |
| 图文比例 | 每页至少1个视觉元素（图/图标/图表/形状） |
学科配色方案：
| 学科/场景 | 主色 | 辅色 | 强调色 | 背景 |
|---|
| 语文（古诗词） | 8B0000 深红 | F5F5DC 米色 | DAA520 金色 | 浅米色 |
| 语文（现代文） | 2E86AB 蓝色 | A23B72 紫红 | F18F01 橙色 | 白色 |
| 数学 | 0D9488 青绿 | 065F46 深绿 | F97316 橙色 | 米白 |
| 英语 | 6366F1 靛蓝 | 8B5CF6 紫色 | EC4899 粉色 | 浅灰 |
| 复习课 | 1E2761 深蓝 | CADCFC 冰蓝 | FFFFFF 白色 | 深色 |
【思维导图生成】：
- 本技能集成了 diagram-generator 技能，可以自动生成高质量的思维导图
- 支持三种格式：drawio(可编辑)、mermaid(代码化)、excalidraw(手绘风格)
- 适用于知识梳理、概念关系展示、教学重点归纳等场景
- 在制作课件时，系统会自动判断是否需要思维导图并生成
资源获取（自动执行）
当用户要求制作课件/教案/任务单时，必须自动执行以下步骤：
- 搜索网络资源：使用 web_search 搜索相关的课件、教案、图片资源
- 下载相关资源：
- 对腾讯文档链接：使用 scrape_url 工具保存
- 对外部网站（学科网等）：尝试使用 web_fetch 获取公开内容，登录后可下载的资源需提示用户
- 对公开图片：下载到
参考资源/images/
- 整合到课件：将下载的图片/资料整合到生成的课件中
- 保存到对应目录：所有资源保存到当前课程的文件夹下
d:/WorkBuddy/MyTeacher/{课程文件夹}/参考资源/
注意：
- 学科网等外部网站通常需要登录/付费才能下载资源
- 优先使用免费的公开资源
- 如果需要登录，提示用户手动登录后下载
首次使用设置
资源网站账号配置
首次使用技能时，必须询问用户以下信息：
-
是否有学科网/21世纪教育网等资源网站账号？
- 如果有，请用户提供用户名和密码
- 如果没有，跳过此步骤
-
需要保存的账号信息：
| 网站 | 用户名 | 密码 | 用途 |
|---|
| 学科网(zxxk.com) | 用户名 | 密码 | 下载课件、教案 |
| 21世纪教育网(21cnjy.com) | 用户名 | 密码 | 下载课件、教案 |
| 其他网站 | 用户名 | 密码 | 按需添加 |
- 账号保存方式：
- 保存到
d:/WorkBuddy/MyTeacher/accounts.json（仅本地保存，不上传）
- 后续下载资源时自动读取账号信息
账号安全说明
- 账号信息仅用于自动登录下载资源
- 不会用于其他用途
- 用户可随时更新账号信息
2. 教学设计（教案）
适用于详细教学方案设计，包含教学目标、重难点、教学过程等完整环节。
3. 学生任务单/导学案
适用于学生自主学习引导，包含预习任务、课堂活动、课后巩固等模块。
文件输出规范
工作目录
所有生成的文档统一保存在用户工作区：
d:/WorkBuddy/MyTeacher/
文件夹组织结构
每个课程单独建一个文件夹，文件夹命名格式：
{年级}{册次}_{单元名}_第{N}课_{课程名}/
命名要素：
| 要素 | 说明 | 示例 |
|---|
| 年级 | 年级简称 | 五上、五下、六年级 |
| 册次 | 上下册 | 上（可省略）、下 |
| 单元名 | 单元序号 | 第一单元、Unit1 |
| 课序 | 第几课 | 第1课、第2课 |
| 课程名 | 具体课题 | 古诗三首、积的近似数 |
文件夹内部结构：
d:/WorkBuddy/MyTeacher/
└── 五上_第一单元_第1课_古诗三首/
├── 古诗三首_课件.pptx # 生成的课件
├── 古诗三首_教学设计.docx # 生成的教案
├── 古诗三首_任务单.docx # 生成的学生任务单
└── 参考资源/ # 搜索/下载的参考资源
├── 学科网_古诗三首课件.docx
├── 21世纪教育网_古诗三首教案.docx
├── 古诗意境配图1.png
└── ...
文件夹命名示例：
| 课程 | 文件夹名 |
|---|
| 五上第一单元第1课古诗三首 | 五上_第一单元_第1课_古诗三首/ |
| 五上第一单元第5课积的近似数 | 五上_第一单元_第5课_积的近似数/ |
| 五下第三单元第2课因数与倍数 | 五下_第三单元_第2课_因数与倍数/ |
文件命名规则
文件夹内的文件使用简短命名 {课程名}_{类型}.扩展名：
| 类型 | 命名示例 |
|---|
| 课件 | 古诗三首_课件.pptx |
| 教学设计 | 古诗三首_教学设计.docx |
| 任务单 | 古诗三首_任务单.docx |
参考资源文件夹内按来源命名：{来源}_{描述}.扩展名
参考资源（自动保存）
搜索到的参考资源必须保存到对应课程的 参考资源/ 子文件夹中：
- 网页资源 → 保存为腾讯文档或本地文件
- 图片资源 → 下载到
参考资源/images/
- 课件/教案参考 → 保存到
参考资源/
简写规则
- 五年级上册 → 五上，五年级下册 → 五下
- 单元：第X单元
- 课程文件夹中的文件名不再重复年级/单元信息（已在文件夹名中体现）
文件输出方式
- PPT/Word 文件：生成到对应课程文件夹
- 在线文档：可生成腾讯文档链接返回给用户
- 参考资源：保存到对应课程的
参考资源/ 子文件夹
资源获取功能
支持的平台
获取方式
根据用户提供的资源链接，采用以下方式获取：
- 网页剪藏 → 使用
scrape_url 工具保存为腾讯文档
- 截屏保存 → 使用浏览器自动化截取页面
- 内容提取 → 读取页面内容，提取课件/教案/任务单信息
使用示例
用户可能这样触发：
- "帮我下载学科网的《小数乘法》课件"
- "获取智慧教育平台上这个教案"
- "截取这个网页的教学设计"
- "把学科网的这个资源保存下来"
文档生成流程
Step 1：收集教学信息
向用户确认以下关键信息：
| 信息项 | 说明 | 示例 |
|---|
| 课题 | 具体教学内容 | 《勾股定理》 |
| 教材版本 | 使用哪个版本教材 | 人教版/北师大版 |
| 年级 | 学生年级 | 初二/七年级 |
| 课型 | 授课类型 | 新授课/复习课/练习课 |
| 课时 | 预计时长 | 1课时(45分钟) |
| 学生学情 | 学生基础水平 | 已掌握三角形基本知识 |
Step 2：选择文档模板
根据用户需求选择对应的模板框架：
教学设计模板 → 参考 references/teaching_design_template.md
学生任务单模板 → 参考 references/task_sheet_template.md
课件结构建议 → 参考 references/ppt_guide.md
Step 3：生成文档内容
根据模板框架和收集的教学信息，生成完整的教学文档：
- 教学设计：按模板结构逐一填充内容，确保教学目标明确、过程完整
- 学生任务单：设计分层任务，兼顾基础巩固与能力提升
- 课件：规划每页内容，合理使用动画和可视化
- 思维导图：对于知识点较多或需要梳理逻辑关系的内容，自动生成思维导图
思维导图生成流程：
- 识别课程中的核心知识点和概念关系
- 选择合适的导图格式（默认使用 mermaid，适合快速生成）
- 调用 diagram-generator 生成思维导图文件
- 将导图文件插入到课件的相应页面
- 同时保存原始导图文件到工作目录供后续编辑
Step 4：输出交付物
根据用户选择的输出格式生成文档：
- PPT 课件：使用 pptx skill 生成 .pptx 文件
- Word 教案：使用 docx skill 生成 .docx 文件
- 在线文档：可生成腾讯文档链接
教学设计内容要求
教学目标
- 知识与技能：具体、可测量
- 过程与方法：体现探究过程
- 情感态度：适当即可
教学重难点
教学过程
- 导入：2-3分钟，生活情境引入
- 新知探究：15-20分钟，核心环节
- 巩固练习：10-15分钟，梯度练习
- 总结：3-5分钟，知识梳理
学生任务单设计原则
预习任务
课堂任务
巩固练习
- 基础达标（全员必做）
- 能力提升（选做）
- 拓展挑战（学有余力）
数学学科特殊处理
公式与符号
几何图形
例题设计
- 提供规范解题步骤
- 包含易错点提示
- 适当提供变式训练
常用提示词示例
用户可能这样触发技能：
文档生成：
- "帮我设计一节《二次函数》的教学设计"
- "制作一个《全等三角形》复习课的PPT"
- "创建一个《有理数运算》的导学案"
- "帮我写一份《圆》的教案"
- "生成一个《一次函数》预习任务单"
资源获取：
参考资源
templates/
teaching_design_template.md - 教学设计通用模板task_sheet_template.md - 学生任务单通用模板ppt_guide.md - 课件制作指南
使用建议
- 先生成通用框架，再根据具体课题填充内容
- 数学概念要确保表述准确
- 例题选择要有代表性
- 练习要有梯度，从易到难
- 思维导图的使用：
- 适合知识复习课、单元总结、概念梳理等场景
- 对于逻辑关系复杂的知识点，优先使用思维导图呈现
- 生成的导图文件保存在
d:/WorkBuddy/MyTeacher/diagrams/ 目录
- 如需调整导图样式或内容，可直接编辑生成的文件
思维导图技能集成
本技能已集成 diagram-generator 技能，提供专业的思维导图生成能力。
支持的导图格式
| 格式 | 特点 | 适用场景 |
|---|
| Mermaid | 代码化、版本控制友好、生成快速 | 课件内嵌、快速预览、文档集成 |
| DrawIO | 功能强大、可精细编辑、支持复杂布局 | 需要后续编辑、复杂知识体系 |
| Excalidraw | 手绘风格、创意性强、非正式感 | 吸引学生注意力、轻松氛围 |
导图应用场景
数学学科：
- 单元知识梳理（如"小数运算"、"平面图形"）
- 公式推导过程（如"勾股定理证明步骤"）
- 易错点归类（如"分数运算常见错误"）
- 解题思路梳理（如"应用题解题流程"）
语文学科：
- 古诗词意象梳理
- 文章结构分析
- 人物关系图
- 写作技巧归纳
导图示例
数学知识梳理导图：
小数乘法
├── 小数乘整数
├── 小数乘小数
├── 积的近似数
├── 连乘、乘加、乘减
└── 解决问题
├── 估算
└── 精确计算
语文古诗意象导图：
《望天门山》
├── 景物
│ ├── 天门山
│ ├── 楚江
│ └── 孤帆
├── 动态描写
│ ├── 断
│ ├── 开
│ └── 出
└── 情感
└── 豪迈豁达
技术实现
当用户要求制作课件时，系统会：
- 分析课程内容，判断是否适合使用思维导图
- 如果适合，自动生成导图 JSON 规范
- 调用
mcp-diagram-generator MCP 服务器生成导图文件
- 将导图插入到课件中（作为图片或可编辑对象）
- 保存导图原始文件供后续修改
