教师助手

技能文档

---
name: teacher-assistant
title: 教师助手
category: 通用技能
description: 面向 K12 教师的全流程教学助手：教案生成、智能出题组卷、学情成绩分析、家校沟通（评语/家长信）、教学周报月报、分层作业设计、学生成长档案、班级管理（班规/班委/座位表）、可打印知识卡片、论文作业智能批阅，全部输出支持 Word 和 PDF 双格式导出。当教师用户需要备课写教案、出题组卷、分析成绩、写评语、做教学总结、设计作业、批改论文时触发。触发词：备课、教案、出题、试卷、成绩分析、评语、教学总结、作业设计、批阅。
---

# 教师助手（teacher-assistant）

## 定位

面向中国大陆 K12 教师（小学/初中/高中）的 AI 教学工具，覆盖**备课→出题→教学→作业→成绩→沟通→总结→知识卡片→智能批阅**全链路。一个人，顶一整个教务团队。

---

## 能力总览

| # | 能力 | 触发词 | 输出物 |
|---|------|--------|--------|
| 1 | **教案生成** | 备课、教案、写教案、教学设计、课件思路 | Word/PDF 文档·完整教案（教学目标/过程/板书/反思）|
| 2 | **智能出题** | 出题、组卷、试卷、题目、练习题、考题 | Word/PDF 文档·多种题型试卷（含答案/评分标准）|
| 3 | **学情分析** | 成绩、学情、排名、分析、班级报告 | Word/PDF 文档·成绩分析报告/班级画像 |
| 4 | **家校沟通** | 家校、评语、家长、通知书、联系 | Word/PDF 文档·期末评语/家长会通知/个性化反馈 |
| 5 | **教学总结** | 总结、周报、月报、教学总结、复盘 | Word/PDF 文档·周报/月报/学期总结 |
| 6 | **作业设计** | 作业、设计作业、练习、巩固 | Word/PDF 文档·分层作业（基础/提高/拓展）|
| 7 | **学生档案** | 档案、成长、学情记录、个别辅导 | Word/PDF 文档·学生成长档案/辅导记录 |
| 8 | **班级管理** | 班级、班规、班委、座位表、排座位 | Word/PDF 文档·班级公约/班委职责/座位表 |
| 9 | **教学知识卡片** | 知识卡片、卡片、知识点卡片、打印卡片、可打印 | HTML（精美可打印）+ Word 双格式·彩色渐变卡片 |
| 10 | **论文/作业批阅** | 批阅、论文批改、作业批改、批改作业、阅卷、论文评价 | Word/PDF 文档·详细批阅报告（评分+点评+建议）|

---

## 意图路由规则

当用户消息包含以下关键词时，优先路由到对应能力：

```
备课/教案/教学设计 → [能力1：教案生成]
出题/组卷/试卷/题目/考题/练习 → [能力2：智能出题]
成绩/排名/分析/学情/分数 → [能力3：学情分析]
评语/家长/家校/通知书/联系信 → [能力4：家校沟通]
总结/周报/月报/复盘/教学总结 → [能力5：教学总结]
作业/练习/巩固/分层作业 → [能力6：作业设计]
档案/成长记录/辅导/个别教育 → [能力7：学生档案]
班规/班委/座位表/班级管理 → [能力8：班级管理]
知识卡片/卡片/打印卡片/可打印/知识点 → [能力9：教学知识卡片]
批阅/论文批改/作业批改/阅卷/论文评价 → [能力10：论文/作业智能批阅]
```

混合意图时，以最靠前的意图为主。

---

> **通用输出规范**（适用于全部 10 个能力）：
> 1. **三格式交付**：先生成 Markdown 内容供用户预览/确认，再通过 `scripts/md_to_docx.py` 自动转换为格式化的 Word 文档（.docx），并可选通过 `scripts/export_pdf.py` 将 Word 转为 PDF，保存到工作目录。
> 2. **文档命名规则**：`{能力}_{课题/考试/班级}_{日期}.docx` 或 `.pdf`，例如 `教案_富饶的西沙群岛_20250513.docx`
> 3. **转换脚本位置**：`scripts/md_to_docx.py`（Markdown→Word），`scripts/export_pdf.py`（Word→PDF）。
> 4. **页面设置**：A4 纸，页边距 2.5cm，行距固定 22 磅。知识卡片使用 A5 或半 A4 尺寸。
> 5. **教师反馈**：生成的 Word/PDF 文档可直接打印或二次编辑。
> 6. **用户提示**：生成文档后，提示用户："已生成 Word 文档 `{文件名}.docx`，如需 PDF 格式请告知，我将为您同步导出 PDF 文件。"

---

## 能力详解

### 能力1：教案生成

**触发词**：备课、教案、写教案、教学设计、课件思路、这节课怎么讲

**输入要素**（用户提供尽可能多）：
- 学科 + 年级 + 教材版本 + 课题名称
- 课时数（如"第3课时，共2课时"）
- 学生基础（一般/较好/薄弱）
- 教学重点/难点（可选）

**输出格式**：先输出 Markdown 预览预览，再自动转为 Word 文档（教案_课题名称.docx）。模板如下：

```markdown

## 技能工作流

### 步骤1：意图路由

根据用户消息中的关键词，按上方「意图路由规则」将请求路由到对应能力；无法判断时列出能力清单请用户选择。

### 步骤2：收集参数并选择模板

按所选能力的输入要求收集参数（学科、年级、单元、班级数据、学生姓名等），并从 `references/output-templates.md` 或根目录 `a_*.md` 模板中选择对应输出模板。

### 步骤3：生成内容

结合 [references/teaching-references.md](references/teaching-references.md) 的教学参考（政策要点、评语素材、沟通原则等）生成内容，遵守「使用约定」中的安全与质量要求。

### 步骤4：导出交付

用 `scripts/md_to_docx.py` 将 Markdown 内容转换为 Word 文档，需要 PDF 时再用 `scripts/export_pdf.py` 转换；知识卡片与批阅报告按对应能力文档的专用流程导出。

---

## 工具脚本

### tool_plans.py（教案生成器）
交互式引导问答，生成完整教案（教学目标/重难点/教学过程/板书/反思）。

```bash
python tool_plans.py
```

### tool_exams.py（智能出题器）
支持多种题型、难度、题量组合配置的组卷工具。

```bash
python tool_exams.py
```

### tool_grades.py（学情分析器）
输入成绩数据，输出可视化成绩分析报告。

```bash
python tool_grades.py
```

### tool_comments.py（批量评语生成器）
输入班级名单与学生表现要点，批量生成个性化期末评语。

```bash
python tool_comments.py
```

### tool_hw.py（分层作业设计器）
输入学科/年级/单元，生成基础/提高/拓展三层作业。

```bash
python tool_hw.py
```

### tool_comms.py（家校沟通文稿生成器）
生成各类家长通知、反馈信件与沟通文稿。

```bash
python tool_comms.py
```

### scripts/knowledge_card_generator.py（知识卡片生成器）
根据学科/年级/知识点，生成可打印的 PDF 知识卡片（A5/A4）。

```bash
python scripts/knowledge_card_generator.py
```

### scripts/paper_reviewer.py（论文/作业批阅器）
读取作业文档，生成带评分、批注和改进建议的批阅报告，支持 Word 和 PDF 导出。

```bash
python scripts/paper_reviewer.py --input <作业文件路径>
```

### scripts/export_pdf.py（Word 转 PDF）
将已生成的 .docx 文档转换为 PDF，供打印或分享。

```bash
python scripts/export_pdf.py --input <docx文件路径>
```

### scripts/md_to_docx.py（Markdown 转 Word）
将生成的 Markdown 内容转换为规范排版的 Word 文档。

```bash
python scripts/md_to_docx.py --input <markdown文件路径>
```

---

## 模板资源（a_*.md）

| 文件 | 用途 |
|------|------|
| `a_plan.md` | 通用教案模板 |
| `a_exam.md` | 试卷模板 |
| `a_analysis.md` | 成绩分析报告模板 |
| `a_comment.md` | 期末评语模板集 |
| `a_weekly.md` | 教学周报模板 |
| `a_hw.md` | 分层作业模板 |
| `a_profile.md` | 学生档案模板 |
| `a_class.md` | 班级公约模板 |
| `a_letter.md` | 家长信模板集 |
| `a_reflect.md` | 教学反思模板 |

---

## 参考文档

| 文档 | 内容 |
|------|------|
| [references/output-templates.md](references/output-templates.md) | 八大能力输出模板（教案/试卷/学情/评语/周报/作业/画像等） |
| [references/teaching-references.md](references/teaching-references.md) | 嵌入式教学参考（政策要点/评语素材/沟通原则） |
| [references/capability-knowledge-card.md](references/capability-knowledge-card.md) | 能力9：教学知识卡片生成流程 |
| [references/capability-review.md](references/capability-review.md) | 能力10：论文/作业智能批阅流程与批阅报告模板 |
| [references/embedded-templates.md](references/embedded-templates.md) | 嵌入式完整模板参考 |

---

## 使用约定

1. **学科适配**：所有教案/试卷默认使用中国统编教材（如语文部编版、数学人教版）
2. **政策合规**：教学内容符合"双减"政策要求，作业量适中
3. **因材施教**：生成内容后，请根据实际班级情况调整
4. **隐私保护**：学生姓名等个人信息仅用于本地文档生成，不会上传
5. **生成内容校验**：AI 生成内容需教师审核后使用，尤其是涉及学生的评价内容
6. **PDF 导出**：所有功能均支持导出 PDF，生成 Word 后用户可要求同步导出 PDF 版本

---

使用说明

# 教师助手

面向 K12 教师的全流程教学助手：备课教案、智能出题组卷、学情成绩分析、家校沟通评语、教学周报、分层作业、学生档案、班级管理、可打印知识卡片、论文作业智能批阅，十项能力覆盖教学全链路，全部支持 Word 和 PDF 双格式导出。

## 使用

```bash
# 交互式生成教案 / 试卷 / 成绩分析 / 评语 / 作业 / 家校文稿
python tool_plans.py
python tool_exams.py

# 论文/作业批阅，生成带评分与批注的批阅报告
python scripts/paper_reviewer.py --input <作业文件路径>

# 生成可打印知识卡片（A5/A4 PDF）
python scripts/knowledge_card_generator.py
```

也可以直接对话：「帮我写一份二年级数学《表内乘法》教案」「根据这份成绩单做学情分析」，技能会自动路由到对应能力。

## 工作原理

按关键词意图路由到十项能力之一，收集学科/年级/班级等参数后套用内置输出模板（`a_*.md` 与 references 模板库）生成内容，结合嵌入式教学参考（政策要点、评语素材）保证专业性，最后经 md_to_docx/export_pdf 导出 Word/PDF 交付。批阅与知识卡片有专用流程，见 `references/`。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。