Initial commit: 课评反馈系统 v1.0

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

@@ -0,0 +1,221 @@
+# 批量课评生成规则
+
+> 支持一节课给多个学生同时生成课评，保持千人千面
+> 
+> **存储方式**（确认后双轨保存）：
+> - 班级周汇总：`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 | 初始版本