---
name: 课评生成
description: 快速生成个性化课评，你只需提供学生本节课的表现，自动匹配班级风格生成高质量课评
type: skill
---

# 🎯 课评生成器技能包

## 🌟 功能说明
本技能专为穹狼科创编程课程设计，**使用超简单：你只需要告诉我学生的基本信息和本节课表现，我就能自动生成符合班级风格的个性化课评**。

✅ 支持四大课程：C++/AIGC/Kitten/体验课  
✅ 自动匹配班级专属风格：AICODE03温暖鼓励型/K4温和鼓励型/CSP03要求型/体验课转化型  
✅ 自动整合OJ做题数据（CSP班级专属）  
✅ 自动保存到学生个人课评汇总文件  
✅ 自动更新出勤记录

## 💡 使用方式（超简单）
你只需要提供以下信息：
```
学生姓名：_______
班级：_______
课程名称：_______
课次：第_______课
日期：YYYY-MM-DD
表现描述：_______（越具体越好，比如"掌握了循环嵌套，主动调试bug，专注力比上节课好"）
```

我会自动完成剩下的所有工作：
1. 读取学生画像、班级风格指南、本节课教案
2. CSP班级自动拉取OJ做题数据
3. 生成约200字的个性化课评
4. 自动保存到学生的课评汇总文件
5. 自动更新出勤记录

---

## ⚙️ 核心生成逻辑（自动完成，你不需要操作）
```
1. 读取参考资料 → 2. CSP班级自动拉取OJ数据 → 3. 生成个性化课评 → 4. 自动保存+更新出勤
```

### 1. 自动读取参考资料
我会自动找到以下资料用于生成课评：
- **学生画像**：`.claude/memory/class/[班级]/[姓名]/profile.md`（了解学生性格特点和适用风格）
- **班级风格指南**：根据课程类型读取对应规则（`.claude/rules/[课程].md`）
- **本节课教案**：到 `.claude/lesson/` 目录下查找对应班级、对应课次的教案，确保课评内容与实际教学一致，不编造内容
- **过往课评**：读取该学生的历史课评，避免重复用词

### 2. CSP班级专属：自动获取OJ做题数据（必须执行）
如果是CSP03班的学生，我会自动运行脚本拉取本节课的OJ做题数据：
```bash
python scripts/update_feedback_with_oj.py \
  --course CSP03-<课次编号> \
  --get-student-oj "<学生姓名>"
```
自动把OJ数据（完成情况、做题表现、错误分布）整合到课评中。

### 3. 自动生成课评（统一格式，所有课程通用）
**固定格式（必须严格遵守）**：
```markdown
【学生姓名】家长好，我们本周上课的课程是《XXX》

课程目标：
1. 【知识点1】
2. 【知识点2】
3. 【知识点3】

课评反馈：
【具体课评内容，约200字，包含优点、建议、期望】
```

生成规则：
- 课程目标从本节课教案中提取真实知识点，禁止编造
- 课评反馈包含：优点表扬 + 温和建议 + 鼓励期望
- **CSP班级专属要求**：必须查询OJ系统的**A包作业完成情况**，进行详细分析（包含完成率、思考模式、错误分布、改进建议），【OJ做题数据】板块放在课评反馈的最后部分
- 称呼规则：三字姓名默认去掉姓氏，直呼后两个字（如"陈圆振"→"圆振"），更亲切
- 内容完全基于你提供的表现描述和教案知识点，不编造内容

---
### 📋 生成后确认流程（必须遵守）
1. 一批课评全部生成后，我会先把所有课评展示给你，不保存
2. 等待你确认没问题后，再执行保存操作
3. 如果你需要修改，我会根据你的要求修改后再次给你确认，直到你满意再保存

---

## 🎨 各班级风格规范（自动匹配）
### AICODE03班 - 温暖鼓励型
- 多用"很棒"、"特别棒"、"超棒"和波浪号"～"
- 描述具体行为："一字一字打字"、"和AI聊了一节课"
- 温和建议用"要是...就更好啦～"
- 固定结尾："老师会继续关注【姓名】的表现，期待看到更多精彩！🌟💡"

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

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

#### CSP03班 OJ数据板块格式（自动生成）
**OJ作业包定位说明**：
- A包 = 课堂练习（**包含5道具体题目，必须全部列出**）
- B包 = 必须完成的课后家庭作业（未完成会明确提醒家长督促）
- C包 = 拓展训练（学有余力的同学可挑战）

```markdown
## 【OJ做题数据】

**A包（课堂练习）完成情况**: 4/5 (共8次提交)

| 题目 | 类型 | 状态 | 提交次数 | 思考模式 | 错误类型 |
|------|------|------|----------|----------|----------|
| CSP03-XXA1 | 基础题 | ✅ 通过 | 1 | 一气呵成 | — |
| CSP03-XXA2 | 基础题 | ✅ 通过 | 1 | 一气呵成 | — |
| CSP03-XXA3 | 基础题 | ✅ 通过 | 2 | 调试改进 | WA×1 |
| CSP03-XXA4 | 提高题 | ✅ 通过 | 2 | 调试改进 | WA×1 |
| CSP03-XXA5 | 提高题 | ❌ 未通过 | 2 | 遇到困难 | CE×1, WA×1 |

---
| CSP03-XXB | 课后作业（必做） | ✅ 已完成 | 3 | 反复调试 | WA×2 |
| CSP03-XXC | 拓展训练（选做） | ⬜ 未提交 | 0 | — | — |

**📊 分析**: A包5道题完成了4道，基础题全部掌握，提高题第5道考察的是边界条件处理，还需要加强；B包必做课后作业已完成，知识点巩固得不错；C包拓展题未提交，学有余力可以尝试挑战。
**错误分布**: 编译错误1次，答案错误4次，主要是边界条件考虑不周全，建议课后多练类似题目。
```

**自动判断规则**：
- ✅ A包所有5道题必须全部列出，不管是否完成，不能只显示1个A包
- ✅ 如果B包未完成/未通过：明确标注"【重要提醒】B包是必须完成的课后家庭作业，麻烦家长督促孩子在本周内完成提交"
- ✅ 如果B包已完成：表扬"课后作业完成及时，知识点巩固得不错"
- ✅ 如果C包完成了：重点表扬"主动完成拓展训练，探索精神值得鼓励"
- ✅ 如果C包未完成：不做硬性要求，只提"学有余力可以尝试挑战"
- ✅ 对A包中未完成的题目，给出具体的知识点建议，帮助孩子针对性提高

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

---

## 💾 保存规则（你确认后自动执行）
你确认课评没问题后，我会自动保存到多个位置，严格遵守课评规范V1.0要求：

### 📌 命名规范（必须严格遵守）
- **课程编号规则**：C++竞赛班统一用`CSP`，AI编程班统一用`AICODE`，不得使用`AI`、`C++`等缩写
- **文件名规则**：`YYYYMMDD_课程编号-课次.md`（如`20260418_CSP05-07.md`、`20260330_AICODE03-02.md`）
- **日期要求**：文件名中的`YYYYMMDD`必须与校宝`teaching_date`完全一致，不得使用编写/提交日期
- **特殊状态文件**：
  - 请假：`YYYYMMDD_课程编号-课次(请假).md`
  - 补课：`YYYYMMDD_课程编号-课次(补课-去班级名).md`

### 1. 保存到学生个人单次课评文件（必须，用于自动化统计）
为每位学生生成单独的单次课评文件，这是课评完成率统计的依据：
**路径**：`.claude/memory/class/[班级]/[姓名]/feedback/YYYYMMDD_课程编号-课次.md`

**格式**：
```markdown
# 课程名称：[课程名称]

**授课日期**: [YYYY-MM-DD]

**课评内容**：
[生成的课评正文]

---
**老师签名：橙子**
```

### 2. 保存到学生个人课评汇总（按课次追加，可选）
自动将新课评按课次顺序追加到学生的个人课评汇总文件末尾：
**路径**：`.claude/memory/class/[班级]/[姓名]/feedback/课评汇总-2026春季.md`

**格式**：
```markdown
## 第[N]次课：[课程名称]
**授课日期**：[YYYY-MM-DD]

**课评内容**：
[生成的课评正文]

---
```

### 3. 保存到统一周课评汇总（后写的放上面）
同时保存到统一的课评汇总目录，同一周的课评放在同一个文件里，新生成的放在最顶部：
**根目录**：`E:/cc/2code/ClassFeedback/output/课评汇总/`
**文件名规则**：`202X年第X周课评汇总.md`（比如「2026年第18周课评汇总.md」）
**排序规则**：最新生成的课评放在文件的最前面，旧的课评在后面，倒序排列
**班级分组**：同一个班级的课评放在一起，按班级分组展示

### 4. 补课学生特殊处理（双向记录）
如果是补课学生，需要生成两条记录：
**1) 原班级记录**：在原班级学生的feedback目录下生成补课追踪文件
- 文件名：`YYYYMMDD_原课程编号-课次(补课-去补课班级名).md`
- 内容：简要说明去哪补课

**2) 补课班级记录**：在补课班级的`补课/[学生姓名]/feedback/`目录下生成正常课评文件
- 文件名：`YYYYMMDD_补课课程编号-课次.md`
- 内容开头注明：`（补课，来自 [原班级名]）`，后续正常写课评

### 5. 班级总结保存（可选）
如果需要生成班级总结，保存到班级的summaries目录：
**路径**：`.claude/memory/class/[班级]/summaries/YYYYMMDD_课程编号-课次_班级反馈.md`
**格式**：使用课评规范V1.0中的班级群发文案模板

### 6. 自动更新出勤登记
自动在出勤登记表中添加本次出勤记录：
**路径**：`.claude/memory/class/[班级]/[姓名]/feedback/出勤登记-2026春季.md`

**格式**：
```
| 日期 | 课程 | 课次 | 状态 | 备注 |
|------|------|------|------|------|
| 2026-XX-XX | [课程名称] | 第X课 | ✅ 出勤 | |
```

### 7. 请假记录生成
如果学生请假，生成专门的请假记录文件：
**路径**：`.claude/memory/class/[班级]/[姓名]/feedback/YYYYMMDD_课程编号-课次(请假).md`
**格式**：使用课评规范V1.0中的请假记录模板

### 保存完成后我会告诉你：
✅ 已保存X条课评
✅ 个人汇总已更新：X个学生的课评已追加
✅ 周汇总已更新：[周数]周汇总文件已更新，新课评已放在最顶部
✅ 出勤登记已更新：X条出勤记录已添加

---

## 📝 示例课评（参考）

**AIGC课程 - 鼓励型**
> 李明今天虽然是第一次接触AI绘画，但我看到了你眼里的好奇，这就是最好的开始。你的描述很有画面感，"想要一个会眨眼的可爱猫咪"，这就是好的Prompt。虽然操作还有点生疏，但老师注意到你一直在尝试，这份坚持比做对题目更珍贵。下次可以把想法先写在便签纸上，分点列出，跟AI沟通会更顺畅。记住，编程最大的门槛不是英文或数学，是敢于尝试的勇气，你已经有了。继续和你的"AI搭档"对话吧，它会越来越懂你的。

**CSP03班 - 家长信格式·要求型（含OJ数据）**
> 家长好，本周学习的内容是《字符串处理》：
> 1. string 类型的声明与使用
> 2. 字符串的输入输出（cin / getline）
> 3. 字符串的拼接与比较操作
> 4. 常用字符串函数（size / substr / find）
> 5. 培养独立调试与耐心排查错误的能力
>
> 子煜状态在线，课堂互动积极，能够跟上老师的节奏。对于字符串的基本操作掌握得不错，在讲解 substr 和 find 函数时能迅速理解并动手尝试。
>
> ## 【OJ做题数据】
>
> **A包（课堂练习）完成情况**: 4/5 (共8次提交)
>
> | 题目 | 类型 | 状态 | 提交次数 | 思考模式 | 错误类型 |
> |------|------|------|----------|----------|----------|
> | CSP03-07A1 | 基础题 | ✅ 通过 | 1 | 一气呵成 | — |
> | CSP03-07A2 | 基础题 | ✅ 通过 | 1 | 一气呵成 | — |
> | CSP03-07A3 | 基础题 | ✅ 通过 | 2 | 调试改进 | WA×1 |
> | CSP03-07A4 | 提高题 | ✅ 通过 | 2 | 调试改进 | WA×1 |
> | CSP03-07A5 | 提高题 | ❌ 未通过 | 2 | 遇到困难 | CE×1, WA×1 |
>
> ---
> | CSP03-07B | 课后作业（必做） | ✅ 已完成 | 3 | 反复调试 | WA×2 |
> | CSP03-07C | 拓展训练（选做） | ⬜ 未提交 | 0 | — | — |
>
> **📊 分析**: A包5道题完成了4道，基础题全部掌握，提高题第5道考察的是字符串边界处理，还需要加强；B包必做课后作业已完成，知识点巩固得不错；C包拓展题未提交，学有余力可以尝试挑战。
> **错误分布**: 编译错误1次，答案错误4次，主要是边界条件考虑不周全，建议课后多练类似题目。
>
> A包前4题完成得都不错，说明课堂知识点吸收得很好。第5题虽然没做出来但也尝试了2次，调试能力在进步。希望课后能抽时间把第5题搞明白，理解边界条件的处理方法，而不是放着不管～加油呀！💪✨