Files
ClassFeedback/.claude/skills/课评生成/skill.md

275 lines
13 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.
---
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题搞明白理解边界条件的处理方法而不是放着不管加油呀💪✨