Files
ClassFeedback/.claude/rules/90-archive/33-first-class-rules.md
qiuyan 079a09d743 规则精简合并 v3.2 + 项目结构整理
- 将20+个独立规则合并为9个核心规则(00/10/15/20/21/22/30/50/51)
- 旧规则移入90-archive并标注已合并,请勿直接引用
- 拆分新增:21-shorthand.md(速记符号)、22-student-mgmt.md(补课/新学生/转正)
- 升级keping-advanced skill配置:v2.1 → v2.2(自动双轨保存、三段式结构、字数弹性180-350)
- 删除旧skill文件(keping.json、速查卡、使用指南)和CHANGELOG.md
- 删除各周多余的独立出勤统计文件(出勤已嵌入班级汇总)
- SPIKE02班级文件夹名称规范化(去除特殊字符)
- 将学生模板文件移入memory/student/模板/子目录
- 将fix_config.py移入src/,删除根目录test123.txt测试文件

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-09 20:45:29 +08:00

13 KiB
Raw Blame History

⚠️ 本文件已归档:内容已合并至核心规则文件,此处仅作历史备份。请勿直接引用本文件,请使用 .claude/rules/ 下的核心规则。

新学生与补课学生处理规则 v1.3

统一规范首次上课新学生与补课学生的课评处理

v1.3 更新:优化跨班级补课处理 - 检测到跨班级补课学生时自动完成双轨保存(班级汇总+跨班级个人档案),无需询问

v1.2 更新:新增跨班级补课处理 - 支持将课评跨班级保存到原个人档案,便于追踪完整成长轨迹


核心规则

规则1首次上课新学生

定义

  • 从未在本机构上过任何课程的学生
  • 刚报名入学的学生

课评提及条件

  • 仅在教师输入中明确写明"第一次上课"、"新学生"等关键词时,才能在课评中提及
  • 如果教师未明确说明,课评中不自动添加"这是孩子第一次上课"等表述

正确示例

教师输入小明第一次上课开始不敢碰后来搭了3层
课评输出:这节课是小明第一次上课,开始有点害羞...

错误示例

教师输入小明开始不敢碰后来搭了3层
课评输出:这节课是小明第一次上课... ❌(教师未说明)

规则2补课学生分两种情况处理

补课学生定义 因各种原因(请假、调课等)需要在非原班级时间补课的学生。

⚠️ 重要:补课学生分两类,处理方式不同

情况A自己班级的学生补课

  • 判断标准:学生在 memory/student/{当前班级}/ 目录中存在
  • 处理方式正常双轨保存(班级汇总 + 个人档案)
  • 说明:这是你自己的学生,只是补课,无需额外确认

示例

教师输入:乔乔[补课]搭了3层开心
AI检测乔乔在本班级档案中存在 → 按正式学生处理
处理结果:双轨保存

情况B跨班级补课档案在其他班级

  • 判断标准:学生在 memory/student/{其他班级}/ 目录中存在(跨班级补课)
  • 处理方式自动双轨保存(跨班级模式)
    • 课评保存到补课班级周汇总(当前班级)
    • 课评自动追加原班级个人历史课评记录.md标注补课班级信息
    • 无需询问,自动完成
  • 跨班级保存说明如果学生档案在A班来B班补课
    • 课评保存到B班班级周汇总
    • 课评追加到A班个人历史课评记录.md标注"【跨班级补课】在B班完成"

跨班级补课自动处理示例

教师输入:班级:发现世界-周六09点林瀚丞[补课]搭了3层开心

AI检测 未找到「林瀚丞」在「发现世界-周六09点」的个人档案
        ✅ 找到「林瀚丞」在「发现世界-周四19点」的个人档案

判断跨班级补课学生原班级周四19点补课班级周六09点

自动处理结果:
→ 课评保存到「第7周/发现世界-周六09点.md」班级汇总
→ 课评追加到「student/发现世界-周四19点/林瀚丞/历史课评记录.md」个人档案
   标注【跨班级补课】本节课程在周六09点班第7周完成

✅ 自动完成,无需教师确认

统一规则

  • 不要写"第一次上课"相关表述,即使这是该学生第一次上这节课
  • 补课学生不是新学生,只是课程调整
  • 正常生成课评,按已有档案处理(或询问后的选择处理)

⚠️ 重要规则:课评正文禁止提及补课

绝对禁止

  • 课评正文中绝对不能提及学生来补课相关内容
  • 禁止出现"补课"、"补课上"、"来补课"、"本次补课"等词汇
  • 禁止暗示学生非正常上课(如"今天特别来参加"、"临时加入"等)

正确处理

  • 课评正文完全按正常学生撰写,仿佛学生就是本班正常上课的学生
  • [补课]标记仅作为后台参考,用于档案存储路径判断
  • 补课信息仅保存在班级汇总的元数据中,不进入课评正文

正确示例

教师输入:林瀚丞[补课]:积极分析课程任务,专注完成了绿色身体、黑色头部的蜥蜴设计

课评输出(正确):
瀚丞本节课学习了"蜥蜴"的仿生搭建...(正常撰写,完全不提补课)

课评输出(错误):
瀚丞本节课作为补课学生,学习了"蜥蜴"... ❌(禁止提及补课)
瀚丞今天来补课,学习了"蜥蜴"... ❌(禁止提及补课)

说明

  • 家长看到课评时不应知道孩子是补课还是正常上课
  • 补课标记仅用于教师内部管理和档案存储
  • 保持课评的一致性和专业性

规则3禁止自动推断

严格禁止

  • 禁止AI自动推断学生是补课还是第一次上课
  • 禁止根据表现猜测(如"表现生疏"→"可能是第一次"
  • 禁止根据历史记录自动判断

必须

  • 完全依赖教师输入中的明确标记
  • 无标记时按常规学生处理

教师输入标记方式

单个学生输入

小明[第一次上课]开始不敢碰后来主动搭3层
小红[补课]搭了3层开心

批量输入

课程DISC-003
班级:发现世界-周四19点

梁昕乔:快速启动,开心
钟昀昊:慢热,稳定
张小明[第一次上课]:开始不敢碰,后来主动
李小红[补课]搭了3层认真

无档案学生处理(补课/体验)

当检测到学生无个人档案时:

检测流程(自动处理版)

  1. AI自动检测 memory/student/{当前班级}/{学生名}/ 是否存在
  2. 如存在:该学生为本班级补课学生 → 正常双轨保存(班级汇总 + 个人档案)
  3. 如不存在:自动搜索 memory/student/所有班级目录
    • 如在其他班级存在:该学生为跨班级补课学生自动双轨保存(跨班级模式)
      • 保存到补课班级周汇总(当前班级)
      • 追加到原班级个人历史课评记录.md标注补课班级信息
      • 无需询问,自动完成
    • 如任何班级都不存在:可能是其他老师班级学生 → 询问处理方式

处理方式(更新版)

场景 判断条件 处理方式 存储位置
自己班级补课学生 档案在当前班级目录存在 双轨保存 班级汇总 + 个人档案
跨班级补课学生 档案在其他班级目录存在 自动双轨保存(跨班级模式) 班级汇总(补课班级)+ 个人档案(原班级,标注补课信息)
其他老师班级补课学生 档案不在任何班级目录 询问后决定 班级汇总(可选创建档案)
体验课学生 无标记或标记[体验] 仅班级汇总 班级汇总(标记体验)

询问流程(其他老师班级补课学生)

⚠️ 未找到「张小明」在「发现世界-周四19点」班级的个人档案

该学生标记为[补课],但不在本班级学生名单中。

可能情况:
[1] 其他老师的学生来补课 → 仅保存到班级汇总
[2] 新转班学生 → 创建个人档案(双轨保存)
[3] 档案在其他班级目录 → 询问是否迁移或仅班级汇总

请选择处理方式:

自动保存通知(跨班级补课)

当检测到跨班级补课学生时,自动执行以下操作,无需询问:

⚠️ 检测到「林瀚丞」为跨班级补课学生

档案位置:发现世界-周四19点原班级
补课班级:发现世界-周六09点当前班级

📋 课评归属规则以补课班级周六09点的周数为准
- 原班级周四19点当前进度第8周
- 补课班级周六09点当前进度第7周
- 本节课评将按第7周记录

✅ 自动处理结果:
→ 课评保存到「第7周/发现世界-周六09点.md」补课班级班级汇总
→ 课评追加到「student/发现世界-周四19点/林瀚丞/历史课评记录.md」原班级个人档案
   标注【跨班级补课】本节课程在周六09点班第7周完成

💡 提示:如需调整保存方式,可输入「调整{学生}保存方式」

🔄 简化转正流程(新增 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 创建空文件

迁移示例

# 迁移前(班级汇总)

### 张小明(体验学生)⚠️
【第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节
- 来源:体验课转正

转正后班级汇总更新

# 原标记(体验期间)
### 张小明(体验学生)⚠️

# 更新后(转正后)
### 张小明(已转正 ✅)
- 转正日期2026-04-17
- 个人档案:已创建
- 历史课评:已迁移至个人档案

转正统计

在班级学期总览中添加转正统计:

## 学生流动情况

| 类型 | 人数 | 说明 |
|------|:----:|:-----|
| 正式学生 | 30人 | 学期初已建档 |
| 体验转正 | 3人 | 本学期从体验转正式 |
| 补课转入 | 2人 | 从其他班级转入 |
| 当前体验 | 2人 | 正在体验中 |

### 本学期转正记录

| 学生 | 原状态 | 转正周 | 已上课时 | 转正原因 |
|------|:------:|:------:|:--------:|:---------|
| 张小明 | 体验 | 第7周 | 3节 | 连续参与,表现稳定 |
| 李小红 | 补课 | 第5周 | 2节 | 转入正式班级 |

相关文件