Files
ClassFeedback/memory/class-evaluation-summary/README.md

157 lines
5.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 班级课评汇总目录
> 按周期(每周)汇总的课评档案
>
> 存放位置:`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
│ ├── AICODE-03-周五19点.md
│ └── AICODE-03-周六14点.md
├── 第2周/
│ ├── 发现世界-周四19点.md
│ └── ...
├── 第3周/
├── ...
└── 第7周/ # 当前周(已创建)
├── 发现世界-周四19点.md
├── 发现世界-周六09点.md
├── 发现世界-周六19点.md
├── Wedo创造世界-周六1030.md
├── Wedo创造世界-周六16点.md
├── SPIKE02-周日1030.md
├── AICODE-03-周五19点.md
└── AICODE-03-周六14点.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 |
| 特殊周期 | 期初/、期中/、期末/ | 期初/、期末/ |
## 文件路径速查
| 用途 | 文件路径 |
|------|---------|
| **本周汇总** | `memory/class-evaluation-summary/第7周/{班级}.md` |
| **个人历史** | `memory/student/{班级}/{学生}/历史课评记录.md` |
| **学生画像** | `memory/student/{班级}/{学生}/用户画像.md` |
## 数据流转
```
教师输入 → 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老师*