xiaoq/ClassFeedback
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

优化课评系统：新增速记符号、状态面板、快速编辑功能

Browse Source 
- 新增36-shorthand-learning.md：速记符号阶梯学习指南
- 新增37-status-panel.md：课评状态管理面板
- 新增38-quick-edit.md：快速编辑功能规则
- 新增班级学期总览模板和成长时间线模板
- 更新多条规则文件优化课评生成流程
- 补充第7周班级汇总和学生档案数据
This commit is contained in:
小Q
2026-04-19 19:24:09 +08:00
parent c04f1d18a6
commit 4810387dab
73 changed files with 4070 additions and 898 deletions
Download Patch File Download Diff File Expand all files Collapse all files

493
.claude/rules/32-batch-generation.md
View File

@@ -1,221 +1,336 @@
# 批量课评生成规则
# 批量课评生成规则 v2.0（优化版）
> 支持一节课给多个学生同时生成课评，保持千人千面
>
> **存储方式**（确认后双轨保存）：
> - 班级周汇总：`memory/class-evaluation-summary/第X周/{班级}.md`（便于查看当周全班）
> - 个人历史课评：`memory/student/{班级}/{学生名}/历史课评记录.md`（保留完整成长档案）
>
> **首次上课/补课说明**：详见 [33-first-class-rules.md](33-first-class-rules.md)
> **优化内容**：批量并行生成、智能分级确认、自动质量检查
## 批量输入格式
---
### 表格式（推荐）
## 🚀 批量生成流程（优化后）
```
课程：[课程代码]
班级：[班级代码]
日期：[日期]
| 学生 | 核心表现 | 情绪 | 亮点/需关注 | 对比 |
|-----|---------|------|------------|------|
| 小明 | 观望5分钟后主动搭3层，自己调高度 | 稳定 | 比上周主动 | 进步明显 |
| 小红 | 全程专注，搭5层加弯管 | 开心 | 主动帮助旁边 | 保持 |
| 小强 | 频繁换玩法，未完整搭建 | 兴奋→烦躁 | 需引导坚持 | 和之前类似 |
输入表格 → AI并行解析每个学生 → 预加载课程/档案 →
并行生成多份课评 → 自动保存班级周汇总 → 质量检查 →
批量展示 → 教师一键确认 → 自动双轨保存
```
### 列表式
### 效率对比
```
课程：TUBE-001
班级：小小班A班
日期：2026-03-25
| 环节 | 优化前 | 优化后 | 提升 |
|------|--------|--------|------|
| 生成方式 | 顺序生成 | 并行生成 | 速度↑ |
| 确认次数 | 每人1次 | 批量1次 | 效率↑↑ |
| 保存操作 | 手动双轨 | 自动保存 | 便捷↑ |
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点
日期：4月16日
梁昕乔：快速启动，开心
钟昀昊：慢热，稳定
张小明[补课]：搭了3层，认真 ← 标记为补课学生
李小红[体验]：积极参与，开心 ← 标记为体验学生
1. 乔乔：gj5→zd3→zt ↑++
2. 昊昊：慢热→zd3→反复调 →
3. 张小明[体验]：搭了3层，开心
4. 李小红[补课]：专注完成，稳定
5. 小强：频换玩法 wb↓--
```
## 效率优化
### 快捷键输入（设想）
### 简化表格式
```
输入：小明：gj5→zd3→tz（观望5分钟→主动3层→调整）
AI识别：观望5分钟后主动搭3层，自己调整
课程：DISC-007 班级：发现世界-周四19点
学生 核心表现 情绪 对比
─────────────────────────────────────────
乔乔 gj5→zd3→zt ↑ ++
昊昊 慢热→zd3→反复调 → 渐入佳境
小明[体验] 搭3层参与 ↑ 积极
小红[补课] 专注完成 → 稳定
```
### 语音转文字
### 纯速记式（高效用户）
支持教师课后语音快速录入：
```
语音："小明今天开始不敢碰，后来搭了三层，球卡住自己调了高度"
→ 自动解析为结构化输入
DISC-007 发现世界-周四19点
乔乔 gj5→zd3→zt ↑++
昊昊 慢热→zd3→反复调 →
小明[体验] zd3 ↑
```
### 模板复用
---
## ⚡ 批量输出格式（优化）
### 统一展示界面
相似表现的学生，可标记"基于小红模板微调"：
```
小花的输入：同小红，但"没有帮助旁边"
→ 生成类似结构但不同细节的课评
━━━━━━━━━━━━━━━━━━━━━━━
📊 批量生成完成（5份）｜发现世界-周四19点｜DISC-007
━━━━━━━━━━━━━━━━━━━━━━━
✅ 乔乔 198字 正常
✅ 昊昊 205字 正常
⚠️ 小强 165字 偏短
✅ 张小明[体验] 192字 体验学生
✅ 李小红[补课] 201字 补课学生
【档案状态】
✓ 乔乔：有档案 → 双轨保存
✓ 昊昊：有档案 → 双轨保存
⚠ 张小明[体验]：仅班级汇总
⚠ 李小红[补课]：询问是否建档
【批量操作】
[全部发送] [逐个查看] [标记修改] [取消]
━━━━━━━━━━━━━━━━━━━━━━━
```
## 版本
- v1.1 | 2026-04-16 | 新增补课/体验学生批量处理说明，支持标记[补课]/[体验]快速分类
- v1.0 | 2026-03-25 | 初始版本
### 智能分级确认（新增）
**自动通过条件**（同时满足）：
- ✅ 学生有完整档案
- ✅ 字数180-220字范围内
- ✅ 无敏感词/异常表述
- ✅ 情绪描述合理
**需人工确认条件**（任一满足）：
- ⚠️ 体验/补课学生（无档案）
- ⚠️ 字数偏差>20字
- ⚠️ 检测到负面情绪词
- ⚠️ 与上周表现差异过大
- ⚠️ 内容重复度高
---
## 🔍 自动质量检查（新增）
### 检查维度
```
━━━━━━━━━━━━━━━━━━━━━━━
🔍 质量检查报告
━━━━━━━━━━━━━━━━━━━━━━━
✅ 字数检查
全部符合180-220字范围
⚠️ 重复检查
3份课评开头都使用了"今天"
建议差异化：
- 乔乔→"很高兴看到乔乔..."
- 昊昊→"昊昊今天一如既往..."
- 小强→"这节课小强..."
✅ 差异化检查
5份课评侧重点各不相同
⚠️ 待关注项
小强：情绪从"兴奋"转为"烦躁"
建议：课评中增加情绪引导建议
[一键优化] [忽略继续] [查看详情]
━━━━━━━━━━━━━━━━━━━━━━━
```
### 差异化策略
**1. 开头差异化**
| 学生类型 | 开头句式示例 |
|----------|-------------|
| 谨慎型 | "今天[学生]终于主动尝试了..." |
| 活跃型 | "[学生]今天一如既往充满活力..." |
| 进步型 | "和上周相比，[学生]有了明显进步..." |
| 补课型 | "这节课[学生]融入得很好..." |
| 体验型 | "欢迎[学生]第一次来到..." |
**2. 侧重点差异化**
```
同一节课：DISC-007 旋转飞机
乔乔（谨慎型）→ 侧重：参与度和勇气
"今天能主动尝试侧面连接结构..."
昊昊（熟练型）→ 侧重：创意和拓展
"不仅完成基础旋转结构，还自己设计了..."
小强（困难型）→ 侧重：过程价值
"虽然最后没有完成作品，但前15分钟的探索..."
```
**3. 建议差异化**
```
乔乔（参与少）：在家可以用纸筒做简单旋转玩具
昊昊（能力强）：可以尝试用不同材料做对比实验
小强（坚持短）：可以从5分钟小目标开始练习专注
```
---
## 📦 存储流程（优化后）
### 自动保存机制
```
生成课评 → 自动保存到班级周汇总（待确认状态）
↓
教师确认 → 自动双轨保存 → 发送家长
↓
┌─────────┴─────────┐
↓ ↓
班级周汇总.md 个人历史课评.md
(标记已确认) (追加新记录)
```
### 存储路径
| 位置 | 路径 | 说明 |
|------|------|------|
| 班级周汇总 | `memory/class-evaluation-summary/第7周/发现世界-周四19点.md` | 全班汇总，含确认状态 |
| 个人档案 | `memory/student/{班级}/{学生}/历史课评记录.md` | 个人完整轨迹 |
---
## 🏷️ 特殊情况批量处理
### 标记速查
| 标记 | 处理方式 | 保存位置 |
|------|----------|----------|
| `[补课]` | 生成后询问是否建档 | 班级汇总+（可选）个人档案 |
| `[体验]` | 仅班级汇总，不询问 | 仅班级汇总（标记体验） |
| `[缺课]` | 记录缺席，不生成课评 | 班级汇总（标记缺课） |
| `[new]` | 创建新档案，双轨保存 | 班级汇总+个人档案 |
### 批量处理示例
```
输入：
DISC-007 发现世界-周四19点
1. 乔乔：gj5→zd3→zt ↑++
2. 昊昊：慢热→zd3→反复调 →
3. 张小明[体验]：搭了3层，开心
4. 李小红[补课]：专注完成，稳定
5. 王大力[缺课]
AI处理：
✓ 乔乔、昊昊：正常生成，双轨保存
⚠ 张小明[体验]：生成标记为"体验学生"
⚠ 李小红[补课]：生成后询问"是否为李小红创建档案？"
✓ 王大力[缺课]：记录"王大力：缺课"，不生成课评
```
---
## 💡 效率优化技巧
### 1. 上下文复用
```
/课评 班级：发现世界-周四19点 # 首次指定
# 后续直接输入学生，无需重复班级
乔乔：搭3层
昊昊：慢热
```
### 2. 快捷键输入（设想）
```
输入模板：
gj# = 观望#分钟
zd# = 主动搭#层
zt = 自己调整
示例：
输入：乔乔：gj5zd3zt↑
识别：乔乔观望5分钟后主动搭3层，自己调整，开心
```
### 3. 语音批量录入
```
语音："乔乔观望5分钟主动搭3层开心...
昊昊慢热搭3层稳定...
张小明体验课搭3层开心"
AI自动分段生成5份课评
```
---
## 📊 批量生成检查清单
### 生成前检查
- [ ] 班级信息正确（或已在上下文中）
- [ ] 学生姓名无遗漏
- [ ] 标记使用正确（[补课]/[体验]/[缺课]）
### 生成后检查
- [ ] 全部学生课评已生成
- [ ] 字数符合要求（180-220字）
- [ ] 开头句式差异化
- [ ] 建议内容个性化
- [ ] 特殊学生已标记
### 发送前检查
- [ ] 内容准确无误
- [ ] 称呼正确（小名/去姓）
- [ ] 补课/体验学生处理完毕
---
## 🎯 使用建议
### 推荐工作流程
```
Step 1: 指定班级（一次）
/课评 班级：发现世界-周四19点
Step 2: 批量输入（使用速记）
乔乔：gj5→zd3→zt ↑++
昊昊：慢热→zd3→反复调 →
小明[体验]：zd3 ↑
Step 3: AI批量生成（自动质量检查）
Step 4: 查看质量报告，一键确认
Step 5: 自动保存并发送
```
### 不同场景推荐
| 场景 | 推荐方式 | 预计时间 |
|------|---------|----------|
| 常规课后（8人） | 速记批量输入 | 3-5分钟 |
| 重点关注学生 | 自然语言详细描述 | 2-3分钟/人 |
| 边走边记 | 语音转文字 | 实时 |
| 周汇总整理 | 查看班级周汇总文件 | 1分钟 |
---
## 版本历史
| 版本 | 日期 | 更新内容 |
|-----|------|---------|
| **v2.0** | **2026-04-19** | **优化版**：新增并行生成、智能分级确认、自动质量检查 |
| v1.1 | 2026-04-16 | 新增补课/体验学生批量处理说明 |
| v1.0 | 2026-03-25 | 初始版本 |
---
*核心理念：批量不批量，千人千面不打折*