homework-grade

SKILL.md

# 📚 Homework Grader Skill

## 🧠 功能简介
自动从QQ邮箱下载学生作业（zip），解析学生信息，基于模板进行AI评分，并生成成绩Excel。

---

## 🎯 使用场景
教师通过QQ邮箱收作业，学生按格式提交：

姓名-学号-第几次作业.zip

系统自动：
1. 下载附件
2. 解压作业
3. 匹配模板
4. AI评分 + 评语
5. 生成Excel成绩表

---

## 📥 输入参数（Inputs）

| 参数名          | 类型   | 必填 | 说明                   |
| --------------- | ------ | ---- | ---------------------- |
| assignment_id   | int    | ✅    | 作业编号（第几次作业） |
| email_user      | string | ✅    | QQ邮箱账号             |
| email_auth_code | string | ✅    | QQ邮箱授权码           |

---

## 📤 输出结果（Outputs）

| 参数名     | 类型   | 说明                |
| ---------- | ------ | ------------------- |
| excel_path | string | 生成的成绩Excel路径 |

---

## ⚙️ 执行流程（Workflow）

```text
1. 连接QQ邮箱（IMAP）
2. 获取未读邮件附件
3. 筛选zip文件
4. 解析文件名（姓名-学号-作业）
5. 解压文件
6. 加载对应作业模板
7. 调用AI评分
8. 汇总成绩
9. 生成Excel