- name
- homework-grader
- description
- 老师作业批改助手，用于自动批改数学作业、统计错题、生成Excel统计表和PDF报告。当老师需要：(1) 上传正确答案并让AI识别 (2) 批量上传学生作业照片进行批改 (3) 统计全班错误率并生成错题分析报告 (4) 生成重点错题PDF供讲解使用时，触发此skill。
Homework Grader - 作业批改助手
Overview
帮助老师自动批改数学作业，统计错题信息，生成 Excel 统计表和 PDF 分析报告。
依赖安装
运行此 skill 前需要安装以下依赖：
Python 包
pip install -r scripts/requirements.txt系统依赖（必须安装）
# Ubuntu/Debian
sudo apt install tesseract-ocr
# macOS
brew install tesseract
# Windows
# 下载安装：https://github.com/UB-Mannheim/tesseract/wikiWorkflow
完整工作流程
Step 1: 上传正确答案 → AI OCR 识别
↓
Step 2: 循环上传学生作业 → AI 批改 → 记录结果
↓
Step 3: 统计错误率 → 生成 Excel 统计表
↓
Step 4: 生成 PDF 报告（含重点标记）Step 1: 上传正确答案
老师上传包含正确答案的图片（可以是纸质答案照片或电子版截图）。
AI 行为：
- 使用 OCR 识别图片中的答案
- 解析答案内容，按题目编号存储
- 向老师确认识别结果是否正确
- 如需修改，允许老师手动调整
Step 2: 上传学生作业
循环上传学生作业照片。
交互流程：
- 询问老师"请上传学生作业照片"
- 提供学生姓名输入框（可选填写）
- 如果不填姓名，使用序号标识（如：学生1、学生2）
- 重复步骤1-3，直到老师说"上传完成"
AI 行为：
- OCR 识别学生作业内容
- 与正确答案比对
- 标记正确/错误
- 记录错误类型
Step 3: 生成 Excel 统计表
当老师说"生成统计表"或"上传完成"时：
输出 Excel 包含：
- 学生姓名/序号
- 各题对错情况
- 正确题数、错误题数
- 错误率百分比
Step 4: 生成 PDF 报告
当老师说"生成 PDF"或"生成报告"时：
PDF 内容：
- 班级概况 - 总人数、提交人数、平均正确率
- 错题统计表 - 每道题的错题人数、错误率
- 重点错题 - 错误率 ≥ 配置阈值的题目（默认40%）
- 讲解建议 - AI 针对重点错题提供的解题思路和讲解要点
配置说明
| 配置项 | 说明 | 默认值 |
|---|---|---|
| threshold | 重点错题错误率阈值 | 40% |
修改阈值： 老师可以说"设置阈值为 30%"来调整
Resources
scripts/requirements.txt
Python 依赖包列表
scripts/
ocr_helper.py- OCR 识别辅助工具generate_excel.py- 生成 Excel 统计表generate_pdf.py- 生成 PDF 分析报告
references/
answer_format.md- 答案格式规范output_format.md- 输出格式说明
assets/
report_template.html- PDF 报告 HTML 模板