Files
ClassFeedback/.claude/rules/33-first-class-rules.md
小Q(李秋燕) 4810387dab 优化课评系统:新增速记符号、状态面板、快速编辑功能
- 新增36-shorthand-learning.md:速记符号阶梯学习指南
- 新增37-status-panel.md:课评状态管理面板
- 新增38-quick-edit.md:快速编辑功能规则
- 新增班级学期总览模板和成长时间线模板
- 更新多条规则文件优化课评生成流程
- 补充第7周班级汇总和学生档案数据
2026-04-19 19:24:09 +08:00

298 lines
7.4 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.
# 新学生与补课学生处理规则
> 统一规范首次上课新学生与补课学生的课评处理
---
## 核心规则
### 规则1首次上课新学生
**定义**
- 从未在本机构上过任何课程的学生
- 刚报名入学的学生
**课评提及条件**
- **仅在教师输入中明确写明"第一次上课"、"新学生"等关键词时,才能在课评中提及**
- 如果教师未明确说明,课评中**不自动添加**"这是孩子第一次上课"等表述
**正确示例**
```
教师输入小明第一次上课开始不敢碰后来搭了3层
课评输出:这节课是小明第一次上课,开始有点害羞...
```
**错误示例**
```
教师输入小明开始不敢碰后来搭了3层
课评输出:这节课是小明第一次上课... ❌(教师未说明)
```
---
### 规则2补课学生
**定义**
- 已在机构有档案,但第一次上这节课
- 从其他班级/时段调整到本班上课
**处理规则**
- **不要写"第一次上课"相关表述**,即使这是该学生第一次上这节课
- 补课学生**不是新学生**,只是课程调整
- 正常生成课评,按已有档案处理
**正确示例**
```
教师输入小明补课搭了3层开心
课评输出小明今天搭了3层管道表现很开心...
```
**错误示例**
```
教师输入小明补课搭了3层开心
课评输出:这节课是小明第一次上课... ❌(补课≠新学生)
```
---
### 规则3禁止自动推断
**严格禁止**
-**禁止AI自动推断学生是补课还是第一次上课**
- ❌ 禁止根据表现猜测(如"表现生疏"→"可能是第一次"
- ❌ 禁止根据历史记录自动判断
**必须**
- ✅ 完全依赖教师输入中的明确标记
- ✅ 无标记时按常规学生处理
---
## 教师输入标记方式
### 单个学生输入
```
小明[第一次上课]开始不敢碰后来主动搭3层
小红[补课]搭了3层开心
```
### 批量输入
```
课程DISC-003
班级:发现世界-周四19点
梁昕乔:快速启动,开心
钟昀昊:慢热,稳定
张小明[第一次上课]:开始不敢碰,后来主动
李小红[补课]搭了3层认真
```
---
## 无档案学生处理(补课/体验)
当检测到学生无个人档案时:
### 检测流程
1. AI自动检测 `memory/student/{班级}/{学生名}/` 是否存在
2. 如不存在,提醒教师该学生暂无档案
3. 请教师选择处理方式
### 处理方式
| 场景 | 处理方式 | 存储位置 |
|------|---------|---------|
| 补课学生(有档案在其他班级) | 创建档案或仅保存到班级汇总 | 双轨或仅班级汇总 |
| 体验课学生(临时试听) | 仅保存到班级汇总,不建档 | 仅班级汇总 |
### 教师选择
```
⚠️ 未找到「张小明」的个人档案
处理方式:
[1] 创建档案(补课/新学生)
[2] 仅保存到班级汇总(体验课学生)
```
---
## 🔄 简化转正流程(新增 v1.1
### 原流程问题
- 体验学生转正需要回复"转为正式"
- 历史课评需要从班级汇总迁移到个人档案
- 操作步骤多,容易遗忘
### 优化后流程
#### 方案1智能检测转正推荐
当体验/补课学生连续上课达到**3次**时AI主动提示
```
━━━━━━━━━━━━━━━━━━━━━━━━━
💡 转正建议
张小明已连续上3节课第5周、第6周、第7周
- 第5周体验课积极参与
- 第6周体验课专注完成
- 第7周体验课表现稳定
建议为其创建正式档案,便于:
✓ 追踪完整成长轨迹
✓ 生成学期总结报告
✓ 家长沟通更有依据
[创建正式档案] [继续体验] [下周再提醒]
━━━━━━━━━━━━━━━━━━━━━━━━━
```
#### 方案2一键转正快捷
输入简化指令:
```
教师:小明转正
教师:小明[正式]
AI处理
1. 创建个人档案memory/student/{班级}/小明/
2. 自动迁移历史课评(从班级汇总提取)
3. 标记后续课评为"正式学生"
4. 双轨保存生效
━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 转正完成:张小明
已创建:
- 用户画像.md模板待完善
- 历史课评记录.md已迁移3次课评
- 成长素材.md待补充
历史课评已迁移:
- 第5周 DISC-005 天平秤
- 第6周 DISC-006 长颈鹿
- 第7周 DISC-007 旋转飞机
下次输入"小明"将按正式学生处理
━━━━━━━━━━━━━━━━━━━━━━━━━
```
#### 方案3输入时标记升级灵活
支持在输入时直接标记状态变化:
```
输入:小明[体验→正式]:今天表现很好
AI处理
1. 自动创建档案
2. 迁移历史课评
3. 生成本次课评
4. 双轨保存
━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 转正并生成课评:张小明
状态变化:体验 → 正式
已创建个人档案并迁移历史记录
本次课评已双轨保存
━━━━━━━━━━━━━━━━━━━━━━━━━
```
### 转正数据迁移
#### 自动迁移内容
| 内容 | 来源 | 目标 | 操作 |
|------|------|------|------|
| 历史课评 | 班级周汇总 | 个人历史课评.md | 自动提取并追加 |
| 用户画像 | 无 | 新建用户画像.md | 创建模板 |
| 成长素材 | 无 | 新建成长素材.md | 创建空文件 |
#### 迁移示例
```markdown
# 迁移前(班级汇总)
### 张小明(体验学生)⚠️
【第5周课评内容】
【第6周课评内容】
【第7周课评内容】
---
# 迁移后(个人档案)
## 历史课评记录.md
### 2026-04-04 | 课程代码DISC-005
**课评内容**【第5周内容】
**备注**:体验期间,原记录在班级汇总
### 2026-04-11 | 课程代码DISC-006
**课评内容**【第6周内容】
**备注**:体验期间,原记录在班级汇总
### 2026-04-17 | 课程代码DISC-007
**课评内容**【第7周内容】
**备注**:体验期间,原记录在班级汇总
### 转正记录
- 转正日期2026-04-17
- 转正周数第7周
- 已上课时3节
- 来源:体验课转正
```
### 转正后班级汇总更新
```markdown
# 原标记(体验期间)
### 张小明(体验学生)⚠️
# 更新后(转正后)
### 张小明(已转正 ✅)
- 转正日期2026-04-17
- 个人档案:已创建
- 历史课评:已迁移至个人档案
```
### 转正统计
在班级学期总览中添加转正统计:
```
## 学生流动情况
| 类型 | 人数 | 说明 |
|------|:----:|:-----|
| 正式学生 | 30人 | 学期初已建档 |
| 体验转正 | 3人 | 本学期从体验转正式 |
| 补课转入 | 2人 | 从其他班级转入 |
| 当前体验 | 2人 | 正在体验中 |
### 本学期转正记录
| 学生 | 原状态 | 转正周 | 已上课时 | 转正原因 |
|------|:------:|:------:|:--------:|:---------|
| 张小明 | 体验 | 第7周 | 3节 | 连续参与,表现稳定 |
| 李小红 | 补课 | 第5周 | 2节 | 转入正式班级 |
```
---
## 相关文件
- 输入格式规则:[30-input-format.md](30-input-format.md)
- 批量生成规则:[32-batch-generation.md](32-batch-generation.md)
- 快速入门:[40-keping-快速入门.md](40-keping-快速入门.md)
---
## 版本
- v1.1 | 2026-04-19 | 新增简化转正流程
- v1.0 | 2026-04-17 | 从各文件提取统一规范