52f21814e8
- 批量模式新增Python脚本调用指令和参数映射表 - 单条模式新增--get-student-oj命令说明 - 新增OJ数据板块格式模板和思考模式联动规则 - 新增含OJ数据的CSP03课评示例
497 lines
18 KiB
Markdown
497 lines
18 KiB
Markdown
---
|
||
name: 课评生成
|
||
description: 根据课程记录文档批量生成个性化课评，支持单条生成和批量生成两种模式
|
||
type: skill
|
||
---
|
||
|
||
# 🎯 课评生成器技能包
|
||
|
||
## 📁 文件结构
|
||
```
|
||
课评生成/
|
||
├── 技能说明.md # 本文件（完整技能指南）
|
||
└── 使用模板/ # 存放各类模板和示例
|
||
├── 学生画像模板.md
|
||
├── 课评示例.md
|
||
└── 课程记录模板.md # 批量生成用的课程记录文档模板
|
||
```
|
||
|
||
## 🌟 功能说明
|
||
本技能包专为穹狼科创编程课程设计，支持两种生成模式：
|
||
1. **批量生成（推荐）**：用户提供课程记录 md 文档，自动解析学生名单并批量生成课评
|
||
2. **单条生成**：针对单个学生逐一确认信息、读取资料、生成课评
|
||
|
||
综合学生用户画像、教学方案、过往表现和课程特点，生成约200字的个性化课评。支持C++、AIGC、Kitten、体验课四大课程，按班级匹配专属评语风格。所有课评统一汇总到 `课评汇总-2026春季.md`，便于查阅和归档。
|
||
|
||
⚠️ **执行规则：调用本技能时无需询问用户确认，直接按流程自动完成所有步骤。**
|
||
|
||
---
|
||
|
||
## 📋 模式一：批量课评生成（推荐）
|
||
|
||
### 使用流程
|
||
```
|
||
1. 用户提供课程记录文档 → 2. 解析学生名单与表现 → 3. 按学生读取资料 → 4. 逐一生成课评 → 5. 保存到个人汇总（按课次顺序追加） → 6. 生成 output 周汇总文件
|
||
```
|
||
|
||
### 1. 课程记录文档格式
|
||
用户提供的课程记录文档（md 格式）应包含以下内容：
|
||
|
||
```markdown
|
||
# 第X周课程记录
|
||
|
||
**日期范围**：2026-04-17 至 2026-04-19
|
||
|
||
---
|
||
|
||
## 【周五下午 1700 AI03班】（1人上课）
|
||
|
||
### 李梓宁
|
||
- **课程**：AI大作家（下）
|
||
- **日期**：2026-04-17
|
||
- **课次**：第7课
|
||
- **表现**：对自己的小说特别上心，不断调试修改，主动要求更好的效果，精益求精
|
||
- **状态**：✅ 出勤
|
||
|
||
---
|
||
|
||
## 【周五晚上 1900 K4班】（4人上课）
|
||
|
||
### 陈圆振
|
||
- **课程**：彩虹生成器
|
||
- **日期**：2026-04-17
|
||
- **课次**：第7课
|
||
- **表现**：思维敏捷，掌握分支嵌套知识点，认真完成作品，课堂积极性高
|
||
- **状态**：✅ 出勤
|
||
|
||
### 彭煜腾
|
||
- **课程**：彩虹生成器
|
||
- **日期**：2026-04-17
|
||
- **课次**：第7课
|
||
- **表现**：掌握循环嵌套结构，迅速完成作品，出现 bug 能主动拉着老师讨论
|
||
- **状态**：✅ 出勤
|
||
|
||
---
|
||
|
||
## 【周六下午 1400 CSP03班】（4人上课，1人请假）
|
||
|
||
### 郑子煜
|
||
- **课程**：字符串处理
|
||
- **日期**：2026-04-18
|
||
- **课次**：第7课
|
||
- **状态**：⏸ 请假
|
||
- **备注**：请家长督促在家复习本周字符串相关知识点
|
||
```
|
||
|
||
### 2. 解析与处理流程
|
||
1. **读取课程记录文档**：解析出周次、日期范围、各班级、学生名单及表现
|
||
2. **过滤状态**：只处理 **状态为「✅ 出勤」** 的学生，跳过请假/缺勤学生
|
||
3. **OJ数据自动获取（仅CSP班级）**：如果是CSP班级，调用Python脚本拉取所有出勤学生的OJ做题数据。**此步骤必须执行，不可跳过。**
|
||
|
||
**步骤3.1：确定参数**
|
||
- 课程代码：`CSP03-<课次编号>`（从课次提取，如"第7课"→`CSP03-07`，注意补零到两位数）
|
||
- 班级目录名（`--class-name` 参数），映射关系：
|
||
|
||
| 课程记录中的班级名 | --class-name 参数 |
|
||
|---|---|
|
||
| 周六早上0830CSP03班 | 橙子周六0830CSP03 |
|
||
| 周六下午1400CSP03班 | 橙子周六1400CSP03 |
|
||
| 周日早上1030CSP03班 | 橙子周日1030CSP03 |
|
||
|
||
- 日期：`YYYYMMDD` 格式（从课程记录中提取）
|
||
- 学生名单：所有出勤学生姓名，逗号分隔
|
||
|
||
**步骤3.2：执行脚本（一次性拉取所有出勤学生数据）**
|
||
```bash
|
||
python scripts/update_feedback_with_oj.py \
|
||
--course CSP03-<课次编号> \
|
||
--title "<课程名称>" \
|
||
--class-name "<班级目录名>" \
|
||
--date <YYYYMMDD> \
|
||
--students "学生1,学生2,学生3"
|
||
```
|
||
脚本会：
|
||
- 登录OJ系统（凭据从 `.env` 读取）
|
||
- 从 `config/hw_dict.json` 查找对应课次的作业ID
|
||
- 抓取所有出勤学生的提交记录（A=课堂练习, B=课后作业, C=拓展练习）
|
||
- 控制台输出每个学生的完成率、思考模式、错误分布
|
||
- 分析结果自动保存到 `.claude/memory/oj/analysis/CSP03-XX_student_analysis.json`
|
||
|
||
**步骤3.3：读取分析结果**
|
||
分析JSON中包含每个学生的：
|
||
- `completion`：完成率（如 "2/3"）
|
||
- `total_attempts`：总提交次数
|
||
- `problems`：每题详情（状态、提交次数、思考模式、错误类型）
|
||
- `total_errors`：错误分布（WA/CE/RE/TLE 各几次）
|
||
|
||
4. **按学生循环处理**：
|
||
- 读取该学生的用户画像（`.claude/memory/class/[班级]/[姓名]/profile.md`）
|
||
- 读取过往课评（`.claude/memory/class/[班级]/[姓名]/feedback/课评汇总-2026春季.md`）
|
||
- **读取本节课上课目标（必须！）：到 `.claude/lesson/` 目录下查找对应班级、对应课次的教案文件，获取本节课的教学目标和知识点，作为课评中本节课内容的唯一依据，禁止编造课程内容
|
||
- 读取班级风格指南（`.claude/rules/CPP.md`，CSP03班使用"家长信格式·要求型"风格）
|
||
- **对于CSP班级**：从步骤3的分析JSON中提取该学生的OJ做题数据，生成【OJ做题数据】板块（见下方OJ板块格式），整合到课评的"建议/期望"部分之前
|
||
- 结合课程记录中的「表现」字段和OJ做题数据，生成个性化课评
|
||
5. **保存课评**：将新课评按课次顺序追加到个人汇总文件 **末尾**（详见下方保存规则），CSP班级的课评会自动包含OJ数据部分
|
||
6. **更新出勤登记**：为出勤学生添加出勤记录
|
||
|
||
### 3. 保存课评（按课次顺序追加）
|
||
|
||
**目标文件路径**：
|
||
`.claude/memory/class/[班级]/[姓名]/feedback/课评汇总-2026春季.md`
|
||
|
||
**操作步骤**：
|
||
1. 检查汇总文件是否存在，不存在则按模板创建
|
||
2. 读取现有文件的全部内容
|
||
3. **按课次顺序追加新课评到文件末尾**：
|
||
- 找到文件最后一个课评条目
|
||
- 在其后追加新条目，编号为 **最后一条编号 + 1**
|
||
- 新条目编号与 `lesson` 文件夹中的课程顺序一一对应
|
||
4. **无需重新编号**：原有条目编号保持不变
|
||
5. **新条目格式**：
|
||
```markdown
|
||
## 第[N]条：[课程名称]
|
||
|
||
**授课日期**：[日期]
|
||
|
||
**课评内容**：
|
||
|
||
[课评正文]
|
||
|
||
---
|
||
```
|
||
|
||
**示例**（追加前）：
|
||
```markdown
|
||
# 李梓宁 课评汇总（2026春季）
|
||
|
||
**班级**：周五下午1700AI03班
|
||
**学生**：李梓宁
|
||
|
||
---
|
||
|
||
## 第1条：AI是怎么想的
|
||
|
||
**授课日期**：2026-03-08
|
||
|
||
**课评内容**：...
|
||
|
||
---
|
||
|
||
## 第2条：AI的记忆之谜
|
||
|
||
...
|
||
```
|
||
|
||
**示例**（追加后）：
|
||
```markdown
|
||
# 李梓宁 课评汇总（2026春季）
|
||
|
||
**班级**：周五下午1700AI03班
|
||
**学生**：李梓宁
|
||
|
||
---
|
||
|
||
## 第1条：AI是怎么想的
|
||
|
||
**授课日期**：2026-03-08
|
||
|
||
**课评内容**：...
|
||
|
||
---
|
||
|
||
## 第2条：AI的记忆之谜
|
||
|
||
...
|
||
|
||
---
|
||
|
||
## 第3条：AI大作家（下）
|
||
|
||
**授课日期**：2026-04-17
|
||
|
||
**课评内容**：
|
||
|
||
[新课评正文]
|
||
|
||
---
|
||
```
|
||
|
||
### 4. 生成 output 周汇总文件
|
||
|
||
**所有学生课评生成完毕后**，汇总本周所有课评到一个markdown文件：
|
||
|
||
**文件路径**：`output/第[X]周课评汇总.md`
|
||
- 如果 `output` 文件夹不存在，自动创建
|
||
- 如果目标文件不存在，自动新建；如果已存在，覆盖写入最新内容
|
||
|
||
**文件格式**（按日期倒叙排列，最新课程在前）：
|
||
```markdown
|
||
# 第X周课评汇总
|
||
📅 日期范围：[日期范围]
|
||
|
||
---
|
||
|
||
## 【周日下午 1400 AI03班】（4人上课）
|
||
|
||
### 贺楚悦
|
||
**课程**：AI大作家插图生成
|
||
**日期**：2026-04-19
|
||
|
||
[课评正文]
|
||
|
||
---
|
||
|
||
### 林俊宇
|
||
**课程**：AI大作家插图生成
|
||
**日期**：2026-04-19
|
||
|
||
[课评正文]
|
||
|
||
---
|
||
|
||
## 【周日早上 0845 AI03班】（3人上课，1人缺勤）
|
||
|
||
### 卢皓霖
|
||
⏸ 请假
|
||
**备注**：请家长督促在家复习本周知识点
|
||
|
||
---
|
||
|
||
### 黄俊博
|
||
**课程**：AI大作家插图生成
|
||
**日期**：2026-04-19
|
||
|
||
[课评正文]
|
||
|
||
---
|
||
|
||
### 穹狼科创 · 2026春季学期 ✨
|
||
```
|
||
|
||
**排序规则（倒叙）**：
|
||
- 按班级分组，**日期最晚的班级排在最前面**（倒叙排列）
|
||
- 同一班级内，学生顺序保持课程记录文档中的顺序
|
||
- 请假/缺勤学生也列出，标注状态和备注
|
||
|
||
**生成步骤**：
|
||
1. 读取课程记录文档，按日期从晚到早排序班级（倒叙）
|
||
2. 对每个班级，输出班级标题和人数信息
|
||
3. 对出勤学生，从个人课评汇总文件中提取最新一条课评内容
|
||
4. 对请假/缺勤学生，输出状态说明和复习建议
|
||
5. 检查 `output` 文件夹是否存在，不存在则创建
|
||
6. 保存到 `output/第[X]周课评汇总.md`
|
||
|
||
---
|
||
|
||
## 📋 模式二：单条课评生成（备用）
|
||
|
||
当不需要批量生成，只需要为单个学生写课评时使用。
|
||
|
||
### 使用流程
|
||
```
|
||
1. 确认学生/课程/课次 → 2. 自动获取OJ数据（仅CSP班级，运行Python脚本）→ 3. 读取相关资料 → 4. 收集本次表现 → 5. 生成课评（CSP班级自动整合OJ数据）→ 6. 保存到学生文件夹（按课次顺序追加）
|
||
```
|
||
|
||
### 1. 确认基本信息
|
||
- 学生姓名：_______
|
||
- 班级：_______
|
||
- 课程类型：□CPP □AIGC □KITTEN □体验课
|
||
- 本节课次：第_______课
|
||
- 课评风格：根据班级自动匹配
|
||
- AI03班 → 温暖鼓励型
|
||
- K4班 → 家长信格式·温和鼓励型
|
||
- CSP03班 → 家长信格式·要求型
|
||
- 体验课 → 家长信格式·转化导向型
|
||
|
||
### 2. OJ数据获取（仅CSP班级，必须执行）
|
||
|
||
如果课程类型为CPP且班级为CSP03班，运行以下命令获取该学生的OJ做题数据：
|
||
|
||
```bash
|
||
python scripts/update_feedback_with_oj.py \
|
||
--course CSP03-<课次编号> \
|
||
--get-student-oj "<学生姓名>"
|
||
```
|
||
|
||
**参数说明**：
|
||
- `--course`：CSP03-课次，如第7课→`CSP03-07`（课次必须补零到两位数）
|
||
- `--get-student-oj`：学生姓名，脚本会输出该学生的OJ数据Markdown板块
|
||
- 脚本自动从 `.env` 读取OJ登录凭据，从 `config/hw_dict.json` 查找作业ID
|
||
|
||
脚本输出的Markdown内容包含：完成情况、每题状态表（含思考模式和错误类型）、分析和错误分布。将此内容直接作为【OJ做题数据】板块嵌入课评。
|
||
|
||
### 3. 读取参考资料
|
||
- **风格指南**：`.claude/rules/[课程].md`
|
||
- CPP.md：C++课程评语
|
||
- AIGC.md：AIGC课程评语
|
||
- KITTEN.md：Kitten课程评语
|
||
- 体验课.md：体验课转化评语
|
||
- **用户画像**：`.claude/memory/class/[班级]/[姓名]/profile.md`
|
||
- 参考6种学生类型：内向谨慎型、信心不足型、新手入门型、聪明浮躁型、潜力待挖型、容易满足型
|
||
- **本节课上课目标（必须读取！）：** 到 `.claude/lesson/` 目录下查找对应班级、对应课次的教案文件，获取本节课的教学目标和知识点，作为课评中本节课内容的唯一依据，禁止编造课程内容：
|
||
- K4班课程：`.claude/lesson/K4/README.md`
|
||
- AI03班课程：`.claude/lesson/AI03/AICODE-03/` 或 `.claude/lesson/AI03/AICODE-06/`
|
||
- CSP03班课程：`.claude/lesson/CSP03/知识点.md`
|
||
- 体验课：根据实际体验内容从对应lesson文件读取
|
||
- **过往课评**：读取该学生的 `课评汇总-2026春季.md` 和最近课评，避免重复用词
|
||
|
||
### 4. 收集本次表现
|
||
```
|
||
掌握程度：□优秀 □良好 □一般 □待提高
|
||
课堂互动：□积极 □一般 □被动 □缺席
|
||
|
||
具体表现：
|
||
- 优点：_________________________
|
||
- 不足：_________________________
|
||
- 进步：_________________________
|
||
```
|
||
|
||
### 5. 生成课评（约200字）
|
||
根据选择的风格组合内容：
|
||
- 开场白（30字）+ 优点（60字）+ 建议（60字）+ 结束语（50字）
|
||
- **CSP班级专属**：自动整合OJ做题数据，包括完成情况、错误分布、思考模式分析，放在课评的单独板块
|
||
- 姓名称呼规则：如果学生姓名是三字姓名，正文中默认去掉姓氏，只保留后两个字称呼，例如"陈圆振"写作"圆振"，"王晨语"写作"晨语"，让语气更亲切。
|
||
|
||
### 6. 保存课评（按课次顺序追加）
|
||
保存规则与「模式一」第3节相同：将新课评按课次顺序追加到个人汇总文件末尾，原有条目编号保持不变。
|
||
|
||
### 7. 更新出勤登记（自动）
|
||
保存课评后，自动在出勤登记文件中记录本次出勤：
|
||
|
||
**出勤登记文件路径**：
|
||
`.claude/memory/class/[班级]/[姓名]/feedback/出勤登记-2026春季.md`
|
||
|
||
**记录格式**：
|
||
```
|
||
| 日期 | 课程 | 课次 | 状态 | 备注 |
|
||
| 2026-04-06 | AI大作家下 | 第5课 | ✅ 出勤 | |
|
||
```
|
||
|
||
**操作步骤**：
|
||
1. 检查出勤登记文件是否存在，不存在则从模板创建
|
||
2. 查找日期列，如果已有今日记录则更新，否则在表格末尾添加新行
|
||
3. 状态标记为"✅ 出勤"
|
||
4. 备注栏留空
|
||
|
||
---
|
||
|
||
## 🎨 学生类型速查
|
||
|
||
| 观察点 | 鼓励型学生 | 激励型学生 |
|
||
|--------|------------|------------|
|
||
| **语言特征** | "我不会"、"对不对"、"好难" | "我会了"、"太简单"、"够用了" |
|
||
| **课堂表现** | 专注但沉默、需要确认、害怕出错 | 反应快、爱抢答、满足现状 |
|
||
| **作品完成** | 慢但认真、反复确认 | 快但粗糙、不愿优化 |
|
||
| **提问方式** | 被动等待老师发现 | 主动但缺乏深度 |
|
||
|
||
## 💡 生成技巧
|
||
|
||
### AI03班 - 温暖鼓励型
|
||
- 多用"很棒"、"特别棒"、"超棒"和波浪号"～"
|
||
- 描述具体行为："一字一字打字"、"和AI聊了一节课"
|
||
- 温和建议用"要是...就更好啦～"
|
||
- 固定结尾："老师会继续关注【姓名】的表现，期待看到更多精彩！🌟💡"
|
||
|
||
### K4班 - 家长信格式·温和鼓励型
|
||
- 固定开头："家长好，本周学习的内容是《...》" + 5个知识点
|
||
- 肯定创意："能够有自己的创意"
|
||
- 温和指出："不过老师发现...专注力有些下降"
|
||
- 鼓励结尾："继续加油哦！"、"相信你会把程序做得更完整"
|
||
|
||
### CSP03班 - 家长信格式·要求型
|
||
- 固定开头："家长好，本周学习的内容是《...》" + 5个知识点
|
||
- 表扬积极："状态在线"、"早早到校等候超积极"
|
||
- 期望要求："希望多思考"、"理解为什么这么写，不只是抄完就好～"
|
||
- 鼓励结尾："加油呀！💪✨"
|
||
|
||
#### CSP03班 OJ数据板块格式（必须包含）
|
||
|
||
课评正文后、鼓励结尾前，插入以下格式的OJ做题数据板块：
|
||
|
||
```markdown
|
||
## 【OJ做题数据】
|
||
|
||
**完成情况**: 2/3 (共5次提交)
|
||
|
||
| 题目 | 状态 | 提交次数 | 思考模式 | 错误类型 |
|
||
|------|------|----------|----------|----------|
|
||
| CSP03-XXA | ✅ 通过 | 1 | 一气呵成 | — |
|
||
| CSP03-XXB | ✅ 通过 | 2 | 调试改进 | WA×1 |
|
||
| CSP03-XXC | ❌ 未通过 | 2 | 遇到困难 | CE×1, WA×1 |
|
||
|
||
**📊 分析**: 完成2题，C题有尝试但尚未通过，建议课后继续完成。
|
||
**错误分布**: 答案错误1次，编译错误1次。
|
||
```
|
||
|
||
OJ数据板块中各字段直接从步骤3保存的分析JSON中提取：
|
||
- `completion` → "完成情况"
|
||
- `total_attempts` → "共X次提交"
|
||
- 每题 `solved` → 状态（✅通过 / ❌未通过 / ⬜未提交）
|
||
- 每题 `attempts` → 提交次数
|
||
- 每题 `pattern` → 思考模式
|
||
- 每题 `errors` → 错误类型（如 WA×2, CE×1）
|
||
- `total_errors` → 错误分布总结
|
||
|
||
**思考模式描述联动**：
|
||
- 如果学生有题目是"一气呵成"，在课堂表现中提到"思路清晰，代码一次通过"
|
||
- 如果"调试改进"，提到"能够自己发现并修正问题，调试能力不错"
|
||
- 如果"遇到困难"，在期望部分温和提出"希望课后多练习XX类型题目"
|
||
- 如果有未提交题目，建议"课后抽时间完成未提交的练习"
|
||
|
||
### 体验课 - 家长信格式·转化导向型
|
||
- 固定开头："家长好，今天体验的是《...》课程" + 课程价值介绍
|
||
- 突出"第一次"：强调新体验，降低焦虑，突出潜力
|
||
- 建立愿景：描述继续学习后孩子能达到的水平
|
||
- 自然引导报课：用期待和相信引导，不硬推销
|
||
- 鼓励结尾："期待在正式课堂上再次见到【姓名】！"
|
||
|
||
## ⏱️ 时间分配
|
||
|
||
### 批量生成模式
|
||
- 读取课程记录文档：2分钟
|
||
- **CSP班级OJ数据拉取**：3分钟（运行Python脚本）
|
||
- 按学生读取资料（可并行）：10分钟
|
||
- 逐一生成课评：20分钟
|
||
- 保存到个人汇总：3分钟
|
||
- 生成 output 周汇总文件：3分钟
|
||
- 更新出勤登记：2分钟
|
||
- **总计：约40-45分钟**
|
||
|
||
### 单条生成模式
|
||
- 准备阶段：5分钟
|
||
- 资料读取：10分钟
|
||
- 表现记录：5分钟
|
||
- 生成撰写：15分钟
|
||
- 保存归档：5分钟
|
||
- **总计：40分钟**
|
||
|
||
## 📝 示例课评
|
||
|
||
**AIGC课程 - 鼓励型**
|
||
> 李明今天虽然是第一次接触AI绘画，但我看到了你眼里的好奇，这就是最好的开始。你的描述很有画面感，"想要一个会眨眼的可爱猫咪"，这就是好的Prompt。虽然操作还有点生疏，但老师注意到你一直在尝试，这份坚持比做对题目更珍贵。下次可以把想法先写在便签纸上，分点列出，跟AI沟通会更顺畅。记住，编程最大的门槛不是英文或数学，是敢于尝试的勇气，你已经有了。继续和你的"AI搭档"对话吧，它会越来越懂你的。
|
||
|
||
**CSP03班 - 家长信格式·要求型（含OJ数据）**
|
||
> 家长好，本周学习的内容是《字符串处理》：
|
||
> 1. string 类型的声明与使用
|
||
> 2. 字符串的输入输出（cin / getline）
|
||
> 3. 字符串的拼接与比较操作
|
||
> 4. 常用字符串函数（size / substr / find）
|
||
> 5. 培养独立调试与耐心排查错误的能力
|
||
>
|
||
> 子煜状态在线，课堂互动积极，能够跟上老师的节奏。对于字符串的基本操作掌握得不错，在讲解 substr 和 find 函数时能迅速理解并动手尝试。
|
||
>
|
||
> ## 【OJ做题数据】
|
||
>
|
||
> **完成情况**: 2/3 (共5次提交)
|
||
>
|
||
> | 题目 | 状态 | 提交次数 | 思考模式 | 错误类型 |
|
||
> |------|------|----------|----------|----------|
|
||
> | CSP03-07A | ✅ 通过 | 1 | 一气呵成 | — |
|
||
> | CSP03-07B | ✅ 通过 | 2 | 调试改进 | WA×1 |
|
||
> | CSP03-07C | ❌ 未通过 | 2 | 遇到困难 | CE×1, WA×1 |
|
||
>
|
||
> **📊 分析**: 完成2题，C题有尝试但尚未通过，建议课后继续完成。
|
||
> **错误分布**: 答案错误2次，编译错误1次。
|
||
>
|
||
> A题一次通过说明课堂知识吸收得不错。B题虽然出了点小错但能自己调试改正，调试能力在进步。不过C题上卡住了，希望课后能抽时间继续思考C题，理解为什么编译出错、结果不对，而不是放着不管～加油呀！💪✨
|