# CLAUDE.md - 班级课评核心规范

本目录是课评系统的核心数据目录，包含所有班级、学生的课评档案、画像和沟通记录。

---

## 🚀 智能课评生成流程

### 🔧 推荐：使用课评生成技能

**技能路径**：`../../skills/课评生成/SKILL.md`

课评生成技能包支持：
- ✅ **超简单输入**：只需提供学生姓名 + 班级 + 本节课表现
- ✅ **自动匹配风格**：AICODE03温暖鼓励型 / K4温和鼓励型 / CSP03要求型 / 体验课转化型
- ✅ **批量处理**：支持从笔记文件（`E:\cc\3笔记\第N课.md`）批量生成课评
- ✅ **CSP专属OJ数据**：自动拉取OJ做题数据并整合到课评
- ✅ **自动多位置保存**：单次课评文件 + 个人汇总 + 周汇总 + 班级总结
- ✅ **自动更新画像**：根据本节课表现更新学生画像

### 📋 手动生成步骤（不推荐）

```
1. 确认学生/课程/课次 → 2. 读取相关资料 → 3. 收集本次表现 → 4. 生成课评 → 5. 保存到学生文件夹
```

### 步骤1：确认基本信息
- 学生姓名：_______
- 班级：_______
- 课程类型：□CPP □AICODE □KITTEN □体验课
- 本节课次：第_______课
- 课评风格：□鼓励型 □体验转化型

### 步骤2：参考资料
- **风格指南**：`.claude/rules/[课程].md`
- **学生用户画像**：`[班级]/[姓名]/profile.md`（必须先看！）
- **评语归档**：`[班级]/[姓名]/feedback/`
- **教学方案**：根据课次查找对应教案（`.claude/lesson/`）

### 步骤3：生成课评
根据学生画像和风格指南，生成约200字个性化课评

### 步骤4：保存归档（严格遵守命名规范）

**命名规则：**
- C++竞赛班统一用`CSP`前缀，AI编程班统一用`AICODE`前缀，不得使用`AI`、`C++`等缩写
- 文件名格式：`YYYYMMDD_课程编号-课次.md`（如`20260418_CSP05-07.md`、`20260330_AICODE03-02.md`）
- 日期要求：`YYYYMMDD`必须与校宝`teaching_date`完全一致，不得使用编写/提交日期

**特殊文件命名：**
- 请假记录：`YYYYMMDD_课程编号-课次(请假).md`
- 补课追踪：`YYYYMMDD_课程编号-课次(补课-去班级名).md`

**保存路径：**
- 正常课评：`[班级]/[姓名]/feedback/YYYYMMDD_课程编号-课次.md`
- 补课学生：`[补课班级]/补课/[学生姓名]/feedback/YYYYMMDD_课程编号-课次.md`

### 步骤5：更新出勤登记（自动）
保存课评后，自动在出勤登记文件中记录本次出勤：
- 文件路径：`[班级]/[姓名]/feedback/出勤登记-2026春季.md`
- 操作：添加一条出勤记录，状态为"✅ 出勤"

---

## 📊 出勤记录管理

### 出勤记录功能
- 每位学生都有独立的出勤登记表：`出勤登记-2026春季.md`
- 写课评时自动更新出勤状态为"✅ 出勤"
- 可使用 `/出勤记录` 命令查询出勤情况

### 出勤状态说明
| 状态 | 说明 |
|------|------|
| ✅ 出勤 | 学生正常上课 |
| ⏸ 请假 | 学生请假 |
| ❌ 未上课 | 学生未上课 |

### 使用方法
```
/出勤记录 [学生姓名] [班级] [时间范围]
```

**示例：**
- `/出勤记录` - 查询所有学生
- `/出勤记录 陈嘉博` - 查询某个学生
- `/出勤记录 周六晚上1900AICODE03班` - 查询某个班级
- `/出勤记录 陈嘉博 4月` - 查询指定月份

### 出勤登记表格式
```
| 日期 | 课程 | 课次 | 状态 | 备注 |
|------|------|------|------|------|
| 2026-04-06 | AI大作家下 | 第5课 | ✅ 出勤 | |
```

---

## 🎨 班级专属课评风格

### AICODE03班 - 温暖鼓励型
**特点：** 温暖亲切、兴趣激发、表情符号多
- 语气：用"很棒"、"特别棒"、"超棒"、波浪号"～"
- 表情：🌟💡🌸😊💪✨
- 描述具体行为："一字一字打字"、"和AI聊了一节课"
- 提及学生感兴趣的项目："恐怖故事大王"
- 温和建议："要是...就更好啦～"
- 固定结尾："老师会继续关注XX的表现，期待看到更多精彩！🌟💡"

### K4班 - 家长信格式·温和鼓励型
**特点：** 温和鼓励、具体描述、家长视角
- 固定开头："家长好，本周学习的内容是《...》" + 5个知识点
- 表扬创意："能够有自己的创意"
- 温和指出："不过老师发现...专注力有些下降"
- 鼓励结尾："继续加油哦！"、"相信你会把程序做得更完整"

### CSP03班 - 家长信格式·要求型
**特点：** 温和但有要求、高期望
- 固定开头："家长好，本周学习的内容是《...》" + 5个知识点
- 表扬积极："状态在线"、"早早到校等候超积极"
- 期望要求："希望多思考"、"理解为什么这么写，不只是抄完就好～"
- 鼓励结尾："加油呀！💪✨"

### 体验课 - 家长信格式·转化导向型
**特点：** 展示价值、激发兴趣、促成报课
- 固定开头："家长好，今天体验的是《...》课程" + 课程价值介绍
- 突出"第一次"：强调新体验，降低焦虑，突出潜力
- 展示潜力：具体描述孩子在体验中展现的能力和天赋
- 建立愿景：描述继续学习后孩子能达到的水平
- 自然引导：用期待和相信来引导家长报课，不硬推销
- 鼓励结尾："期待在正式课堂上再次见到XX！"

---

## 📌 课评规范V1.0 重要说明

本项目已全面升级到课评规范V1.0，所有操作必须严格遵守以下要求：

### 核心规范

1. **课程编号规则：**
   - C++竞赛班统一用`CSP`前缀（如CSP01、CSP03）
   - AI编程班统一用`AICODE`前缀（如AICODE01、AICODE03），不得使用`AI`缩写
   - 课程编号必须与校宝系统完全一致

2. **文件名规则：**
   - 正常课评：`YYYYMMDD_课程编号-课次.md`
   - 请假记录：`YYYYMMDD_课程编号-课次(请假).md`
   - 补课追踪：`YYYYMMDD_课程编号-课次(补课-去班级名).md`
   - 日期必须与校宝`teaching_date`完全一致，不得使用编写/提交日期

3. **目录结构：**
   - 所有班级目录必须符合`课程编号+老师+星期时间`格式
   - 补课学生的课评必须放在补课班级的`补课/[学生姓名]/feedback/`目录下

4. **完成率统计：**
   - 课评完成率由自动化系统根据文件结构和命名自动统计
   - 只有符合规范的文件才会被计入完成率
   - 请假学生不纳入应发总数，补课学生按到课处理

---

## 💡 使用示例

**场景1：使用技能生成**

**生成过程：**
1. 确认学生信息：小明/三年级A班/AICODE/第5课/鼓励型
2. 读取资料：用户画像(信心不足型)+风格指南(AICODE.md)
3. 收集表现：掌握程度一般，但想象力丰富
4. 生成课评：200字个性化内容
5. 保存归档：学生课堂反馈文件夹

---

## 📁 目录结构说明

```
【课程+老师+时间】/                    # 班级目录（如：AICODE03橙子周六1900）
├── summaries/                          # 班级总结/群发文案
│   ├── YYYYMMDD_课程编号-课次_班级反馈.md
│   └── YYYYMMDD_课程编号-课次_微信群.txt
├── 补课/                               # 补课学生专用目录
│   └── 【学生姓名】/
│       └── feedback/
│           └── YYYYMMDD_课程编号-课次.md
└── 【学生姓名】/                       # 学生个人目录
    ├── feedback/                       # 个人课评目录
    │   ├── YYYYMMDD_课程编号-课次.md          # 正常课评
    │   ├── YYYYMMDD_课程编号-课次(请假).md    # 请假记录
    │   ├── YYYYMMDD_课程编号-课次(补课-去XX班).md # 补课追踪
    │   ├── 出勤登记-2026春季.md
    │   └── 课评汇总-2026春季.md
    ├── communication/                  # 家长沟通记录
    │   ├── YYYYMMDD_问题类型.md
    │   └── 沟通汇总-2026春季.md
    ├── profile.md                      # 学生画像
    ├── summary/                        # 阶段性总结
    │   └── YYYY-MM_月度总结.md
    └── 照片视频/                       # 学生上课作品/照片
```

---

*班级课评核心规范 v1.0*