Files
ClassFeedback/.claude/rules/32-batch-generation.md

222 lines
6.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/第X周/{班级}.md`(便于查看当周全班)
> - 个人历史课评:`memory/student/{班级}/{学生名}/历史课评记录.md`(保留完整成长档案)
>
> **首次上课/补课说明**:详见 [33-first-class-rules.md](33-first-class-rules.md)
## 批量输入格式
### 表格式(推荐)
```
课程:[课程代码]
班级:[班级代码]
日期:[日期]
| 学生 | 核心表现 | 情绪 | 亮点/需关注 | 对比 |
|-----|---------|------|------------|------|
| 小明 | 观望5分钟后主动搭3层自己调高度 | 稳定 | 比上周主动 | 进步明显 |
| 小红 | 全程专注搭5层加弯管 | 开心 | 主动帮助旁边 | 保持 |
| 小强 | 频繁换玩法,未完整搭建 | 兴奋→烦躁 | 需引导坚持 | 和之前类似 |
```
### 列表式
```
课程TUBE-001
班级小小班A班
日期2026-03-25
1. 小明观望5分钟→主动搭3层→自己调高度情绪稳定比上周主动
2. 小红全程专注搭5层加弯管开心主动帮助旁边
3. 小强:频繁换玩法未完整搭建,兴奋→烦躁,需引导坚持
4. 小美搭2层就喊老师看求关注正常和之前类似
5. 豆豆:独自玩球不搭管道,开心,社交需引导
6. 天天搭4层但一倒就哭敏感抗挫需关注
7. 糖糖:模仿小红搭得很稳,平静,模仿能力强
8. 乐乐:中途要上厕所,回来没继续,正常,身体原因
```
## 批量生成流程(确认后双轨保存)
```
输入表格 → AI解析每个学生 → 调取课程教案 → 调取班级档案 →
生成多份独立课评 → 暂存班级周汇总 → 教师审核确认 → 双轨保存
┌──────────┴──────────┐
↓ ↓
班级周汇总.md 个人历史课评.md
```
### 存储位置
| 存储位置 | 文件路径 | 用途 |
|---------|---------|------|
| **班级周汇总** | `memory/class-evaluation-summary/第X周/{班级}.md` | 集中查看当周全班表现 |
| **个人历史课评** | `memory/student/{班级}/{学生名}/历史课评记录.md` | 追踪个人完整成长轨迹 |
## 避免雷同的策略
### 1. 开头差异化
| 学生类型 | 开头句式 |
|---------|---------|
| 谨慎型 | "今天[学生]终于..." |
| 活跃型 | "[学生]今天一如既往..." |
| 第一次尝试(需教师明确标注) | "这节课是[学生]第一次..." |
| 进步型 | "和上周相比,[学生]..." |
### 2. 侧重点差异化
同一节课,不同学生关注不同维度:
```
课程TUBE-001 管道滚球(目标:空间感知+手眼协调)
小明(谨慎型)→ 侧重:参与度和勇气
"今天能主动尝试管道搭建..."
小红(熟练型)→ 侧重:创意和拓展
"不仅完成基础搭建,还自己设计了弯管路线..."
小强(困难型)→ 侧重:过程价值
"虽然最后没有完成作品但前15分钟的探索很有价值..."
```
### 3. 建议差异化
同一节课,不同学生给不同建议:
```
小明(参与少):在家可以用纸筒做简单轨道
小红(能力强):可以尝试用不同材料做对比实验
小强坚持短可以从5分钟小目标开始练习
```
## 批量输出格式
### 分隔输出(推荐)
```
━━━━━━━━━━━━━━━━━━━━━━━
【学生1小明】
198字 | 5段
[课评内容]
━━━━━━━━━━━━━━━━━━━━━━━
【学生2小红】
210字 | 5段
[课评内容]
━━━━━━━━━━━━━━━━━━━━━━━
[...]
```
### 汇总检查表
批量生成后,提供快速检查:
```
批量生成完成8份
字数检查:
✓ 小明198字符合180-220
✓ 小红210字符合180-220
⚠ 小强165字偏短建议补充
✓ ...
重复检查:
✓ 8份课评开头句式各不相同
✓ 8份课评建议各不相同
✓ 无重复用词
请审核后发送
```
## 特殊情况批量标记
| 标记 | 含义 | 处理方式 |
|-----|------|---------|
| [缺课] | 今天没来 | 不生成课评,记录缺席 |
| [早退] | 中途离开 | 课评注明"今天提前离校" |
| [情绪] | 情绪问题 | 课评侧重情绪疏导 |
| [冲突] | 与同学冲突 | 单独简短说明 |
| **[补课]** | **补课学生** | **仅保存到班级周汇总,询问是否建档** |
| **[体验]** | **体验课学生** | **仅保存到班级周汇总,不建档** |
## 批量处理补课/体验学生
当批量生成时遇到无档案学生:
**场景**输入8个学生其中6个有档案2个是补课/体验学生
**AI处理流程**
1. 正常生成8份课评
2. 检测档案状态:
```
档案检查:
✓ 梁昕乔:有档案 → 双轨保存
✓ 钟昀昊:有档案 → 双轨保存
...
⚠ 张小明:无档案(补课学生)
⚠ 李小红:无档案(体验学生)
```
3. 提醒教师:
```
⚠️ 检测到2名学生暂无个人档案
- 张小明(补课学生)
- 李小红(体验学生)
处理方式:
[1] 为补课学生创建档案(张小明)
[2] 体验学生仅保留在班级汇总(李小红)
[3] 全部仅保存到班级汇总
```
4. 根据教师选择执行保存
**批量输入时标记补课/体验学生**
```
课程DISC-007
班级:发现世界-周四19点
梁昕乔:快速启动,开心
钟昀昊:慢热,稳定
张小明[补课]搭了3层认真 ← 标记为补课学生
李小红[体验]:积极参与,开心 ← 标记为体验学生
```
## 效率优化
### 快捷键输入(设想)
```
输入小明gj5→zd3→tz观望5分钟→主动3层→调整
AI识别观望5分钟后主动搭3层自己调整
```
### 语音转文字
支持教师课后语音快速录入:
```
语音:"小明今天开始不敢碰,后来搭了三层,球卡住自己调了高度"
→ 自动解析为结构化输入
```
### 模板复用
相似表现的学生,可标记"基于小红模板微调"
```
小花的输入:同小红,但"没有帮助旁边"
→ 生成类似结构但不同细节的课评
```
## 版本
- v1.1 | 2026-04-16 | 新增补课/体验学生批量处理说明,支持标记[补课]/[体验]快速分类
- v1.0 | 2026-03-25 | 初始版本