210 lines
7.3 KiB
Markdown
210 lines
7.3 KiB
Markdown
# 班级课评汇总目录
|
||
|
||
> 按周期（每周）汇总的课评档案
|
||
>
|
||
> 存放位置：`memory/class-evaluation-summary/`
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
class-evaluation-summary/
|
||
├── README.md # 本说明文档
|
||
├── 模板-班级周汇总.md # 周汇总模板
|
||
├── 第1周/ # 周期文件夹
|
||
│ ├── 发现世界-周四19点.md # 班级当周课评汇总
|
||
│ ├── 发现世界-周六09点.md
|
||
│ ├── 发现世界-周六19点.md
|
||
│ ├── Wedo创造世界-周六1030.md
|
||
│ ├── Wedo创造世界-周六16点.md
|
||
│ ├── SPIKE02-周日1030.md
|
||
│ ├── AICODE03小Q周五1900.md
|
||
│ └── AICODE03小Q周六1400.md
|
||
├── 第2周/
|
||
│ ├── 发现世界-周四19点.md
|
||
│ └── ...
|
||
├── 第3周/
|
||
├── ...
|
||
└── 第7周/ # 当前周（已创建）
|
||
├── 发现世界-周四19点.md
|
||
├── 发现世界-周六09点.md
|
||
├── 发现世界-周六19点.md
|
||
├── Wedo创造世界-周六1030.md
|
||
├── Wedo创造世界-周六16点.md
|
||
├── SPIKE02-周日1030.md
|
||
├── AICODE03小Q周五1900.md
|
||
└── AICODE03小Q周六1400.md
|
||
```
|
||
|
||
## 工作流程
|
||
|
||
### 方式1：自动创建新周期（推荐）
|
||
|
||
当你发送 **「X周汇总」** 时，AI会自动：
|
||
1. 创建 `第X周/` 文件夹
|
||
2. 在该文件夹下创建8个班级的MD文档（使用模板）
|
||
3. 根据学期周数规则自动填充课程信息
|
||
|
||
**示例**：
|
||
```
|
||
你：7周汇总
|
||
AI：已创建第7周文件夹及8个班级汇总文档
|
||
```
|
||
|
||
### 方式2：生成课评并自动填充
|
||
|
||
当你发送学生表现生成课评时，AI会自动：
|
||
1. 生成个性化课评
|
||
2. 填充到对应班级的当周汇总文档
|
||
3. 标记为「待确认」状态
|
||
4. 等待你确认后同步到个人历史课评
|
||
|
||
**示例**：
|
||
```
|
||
你：乔乔：快速启动→搭3层→自己加装饰，开心
|
||
AI：生成课评 → 填充到 第7周/发现世界-周四19点.md → 等待确认
|
||
```
|
||
|
||
### 方式3：确认后双轨保存
|
||
|
||
当你回复 **「确认」** 或 **「保存」** 后，AI会自动：
|
||
1. 将课评从「待确认」改为「已确认」
|
||
2. 同步保存到个人历史课评：`student/{班级}/{学生}/历史课评记录.md`
|
||
|
||
## 文件命名规范
|
||
|
||
| 层级 | 命名格式 | 示例 |
|
||
|------|---------|------|
|
||
| 周期文件夹 | 第X周/ | 第7周/、第8周/ |
|
||
| 班级文件 | {班级名称}.md | 发现世界-周四19点.md |
|
||
| 特殊周期 | 期初/、期中/、期末/ | 期初/、期末/ |
|
||
|
||
## 课程信息板块规范
|
||
|
||
班级汇总文件的课程信息板块需包含以下内容：
|
||
|
||
```markdown
|
||
> **课程信息**
|
||
> - 日期：YYYY-MM-DD（星期X）
|
||
> - 课程代码：XXX-XXX
|
||
> - 课程主题：XXXX
|
||
> - 核心知识点：XXX、XXX、XXX
|
||
>
|
||
> **已提交课评**：学生全名1、学生全名2、学生全名3[补课标记]
|
||
> **缺勤人员**：学生全名4、学生全名5（或无）
|
||
```
|
||
|
||
### 说明
|
||
|
||
- **已提交课评**：列出所有已生成课评的学生**全名**（如"李怡瞳"、"沙佩琪"），补课学生需标记[补课]
|
||
- **缺勤人员**：列出应出勤但未到校的学生**全名**，如无则填"无"
|
||
|
||
---
|
||
|
||
## 文件路径速查
|
||
|
||
| 用途 | 文件路径 |
|
||
|------|---------|
|
||
| **本周汇总** | `memory/class-evaluation-summary/第7周/{班级}.md` |
|
||
| **个人历史** | `memory/student/{班级}/{学生}/历史课评记录.md` |
|
||
| **学生画像** | `memory/student/{班级}/{学生}/用户画像.md` |
|
||
|
||
## 实到人数计算规则
|
||
|
||
**实到人数** = 实际生成课评的学生数（含「已确认」和「待确认」状态）
|
||
|
||
| 状态 | 是否计入实到 | 说明 |
|
||
|------|:----------:|------|
|
||
| 已确认（☑）| ✅ 计入 | 课评已生成且教师已确认 |
|
||
| 待确认（☐）| ✅ 计入 | 课评已生成，待教师确认 |
|
||
| 待生成 | ❌ 不计入 | 教师未输入该学生表现，无课评 |
|
||
| 缺勤/请假 | ❌ 不计入 | 学生未到校，备注说明 |
|
||
|
||
### 示例
|
||
|
||
**场景**：班级应到4人，教师实际输入了2人的表现
|
||
|
||
```
|
||
应到人数：4人
|
||
实到人数：2人（基于实际生成课评数）
|
||
缺勤：无（或：小明、小红请假）
|
||
课评确认率：50%（1人已确认 / 1人待确认）
|
||
```
|
||
|
||
### 数据统计标准
|
||
|
||
```markdown
|
||
| 指标 | 数值 | 计算方式 |
|
||
|------|------|---------|
|
||
| 应到人数 | {班级总人数} | 学生档案总人数 |
|
||
| 实到人数 | {生成课评数} | 已确认 + 待确认 |
|
||
| 缺勤人数 | {未到校数} | 应到 - 实到（如无课评且未到校）|
|
||
| 课评确认率 | {百分比} | 已确认数 / 实到人数 × 100% |
|
||
```
|
||
|
||
```
|
||
教师输入 → AI生成课评 → 填充到当周班级汇总 → 【等待确认】
|
||
↓
|
||
教师回复「确认」
|
||
↓
|
||
┌─────────┴─────────┐
|
||
↓ ↓
|
||
班级汇总.md（已确认） 个人历史课评.md
|
||
（class-evaluation/） （student/）
|
||
```
|
||
|
||
### 补课/体验学生处理
|
||
|
||
当检测到无档案学生时（补课/体验学生），数据流转略有不同：
|
||
|
||
```
|
||
教师输入（补课学生）→ AI检测无档案 → 提醒教师 → 教师选择「仅保存到班级汇总」
|
||
↓
|
||
仅保存到班级汇总.md（不创建个人档案）
|
||
↓
|
||
标记为：⚠️ 补课/体验学生（无个人档案）
|
||
```
|
||
|
||
**班级汇总文件中的标记示例**：
|
||
```markdown
|
||
### 张小明（补课学生）⚠️
|
||
[课评内容]
|
||
- 状态：已确认
|
||
- 个人档案：未创建（补课学生）
|
||
- 备注：如需创建档案，请回复「为张小明创建档案」
|
||
```
|
||
|
||
**后续处理补课学生**：
|
||
- 回复「为[姓名]创建档案」→ 创建个人档案 → 将该学生历史课评从班级汇总迁移到个人档案
|
||
|
||
## 当前学期进度
|
||
|
||
| 周数 | 日期范围 | 状态 |
|
||
|:---:|:---------|:----:|
|
||
| 第5周 | 3月30日-4月5日 | ✅ 已完成 |
|
||
| 第6周 | 4月6日-4月12日 | ✅ 已完成 |
|
||
| **第7周** | **4月13日-4月19日** | **📍 当前** |
|
||
| 第8周 | 4月20日-4月26日 | ⏳ 待创建 |
|
||
|
||
## 使用场景
|
||
|
||
1. **周回顾**：打开 `第X周/` 文件夹，查看本周全班表现
|
||
2. **备课参考**：查看上周班级汇总，了解整体掌握情况
|
||
3. **批量发送**：从当周汇总文档复制已确认的课评发送给家长
|
||
4. **学期分析**：横向对比各周 `第1周/` 到 `第7周/` 的表现变化
|
||
5. **交接班**：新教师查看历史周汇总，快速了解班级
|
||
|
||
## 自动化指令
|
||
|
||
| 指令 | 功能 |
|
||
|------|------|
|
||
| `X周汇总` | 自动创建第X周文件夹及8个班级MD文档 |
|
||
| `确认` / `保存` | 将课评从「待确认」改为「已确认」，并同步到个人档案 |
|
||
| `修改：XXX` | 重新生成课评内容 |
|
||
| `为[姓名]创建档案` | 为补课/体验学生创建个人档案，并将历史课评迁移 |
|
||
|
||
---
|
||
|
||
*创建日期：2026-04-15*
|
||
*版本：v2.1*
|
||
*维护者：小Q老师*
|