Files

chengzi 2e7878007c 为课评系统添加家长视角和交互式功能：- 新增家长视角板块，包含核心知识、必学内容、家庭建议和作业要求 - 更新所有课程评语风格文件，支持家长视角内容 - 添加交互式提问机制，通过提问获取更具体的课评内容 - 更新学生画像模板，增加家校沟通信息 - 新增示例文件展示完整的家长视角课评

2026-05-06 19:15:56 +08:00

21 KiB

Raw Blame History

name, description, type

name	description	type
课评生成	根据课程记录文档批量生成个性化课评，支持单条生成和批量生成两种模式	skill

🎯 课评生成器技能包

📁 文件结构

课评生成/
├── 技能说明.md         # 本文件（完整技能指南）
└── 使用模板/          # 存放各类模板和示例
    ├── 学生画像模板.md
    ├── 课评示例.md
    └── 课程记录模板.md   # 批量生成用的课程记录文档模板

🌟 功能说明

本技能包专为穹狼科创编程课程设计，支持两种生成模式：

批量生成（推荐）：用户提供课程记录 md 文档，自动解析学生名单并批量生成课评
单条生成：针对单个学生逐一确认信息、读取资料、生成课评

综合学生用户画像、教学方案、过往表现和课程特点，生成约200字的个性化课评。支持C++、AIGC、Kitten、体验课四大课程，按班级匹配专属评语风格。所有课评统一汇总到 课评汇总-2026春季.md，便于查阅和归档。

⚠️ 执行规则：

初始阶段如果信息不足，会通过提问获取更具体的内容
信息充分后自动完成所有步骤
提问过程确保生成更精准、更个性化的课评内容

📋 模式一：批量课评生成（推荐）

使用流程

1. 用户提供课程记录文档 → 2. 解析学生名单与表现 → 3. 按学生读取资料 → 4. 逐一生成课评 → 5. 保存到个人汇总（按课次顺序追加） → 6. 生成 output 周汇总文件

1. 课程记录文档格式

用户提供的课程记录文档（md 格式）应包含以下内容：

# 第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. 解析与处理流程

读取课程记录文档：解析出周次、日期范围、各班级、学生名单及表现
过滤状态：只处理 状态为「✅ 出勤」 的学生，跳过请假/缺勤学生

OJ数据自动获取（仅CSP班级）：如果是CSP班级，调用Python脚本拉取所有出勤学生的OJ做题数据。此步骤必须执行，不可跳过。

步骤3.1：确定参数

课程代码：CSP03-<课次编号>（从课次提取，如"第7课"→CSP03-07，注意补零到两位数）
班级目录名（--class-name 参数），映射关系：

课程记录中的班级名	--class-name 参数
周六早上0830CSP03班	橙子周六0830CSP03
周六下午1400CSP03班	橙子周六1400CSP03
周日早上1030CSP03班	橙子周日1030CSP03

日期：YYYYMMDD 格式（从课程记录中提取）
学生名单：所有出勤学生姓名，逗号分隔

步骤3.2：执行脚本（一次性拉取所有出勤学生数据）

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 各几次）

按学生循环处理：
- 读取该学生的用户画像（.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做题数据，生成个性化课评
保存课评：将新课评按课次顺序追加到个人汇总文件末尾（详见下方保存规则），CSP班级的课评会自动包含OJ数据部分
更新出勤登记：为出勤学生添加出勤记录

3. 保存课评（按课次顺序追加）

目标文件路径： .claude/memory/class/[班级]/[姓名]/feedback/课评汇总-2026春季.md

操作步骤：

检查汇总文件是否存在，不存在则按模板创建
读取现有文件的全部内容
按课次顺序追加新课评到文件末尾：
- 找到文件最后一个课评条目
- 在其后追加新条目，编号为 最后一条编号 + 1
- 新条目编号与 lesson 文件夹中的课程顺序一一对应
无需重新编号：原有条目编号保持不变
新条目格式：

## 第[N]条：[课程名称]

**授课日期**：[日期]

**课评内容**：

[课评正文]

---

示例（追加前）：

# 李梓宁 课评汇总（2026春季）

**班级**：周五下午1700AI03班
**学生**：李梓宁

---

## 第1条：AI是怎么想的

**授课日期**：2026-03-08

**课评内容**：...

---

## 第2条：AI的记忆之谜

...

示例（追加后）：

# 李梓宁 课评汇总（2026春季）

**班级**：周五下午1700AI03班
**学生**：李梓宁

---

## 第1条：AI是怎么想的

**授课日期**：2026-03-08

**课评内容**：...

---

## 第2条：AI的记忆之谜

...

---

## 第3条：AI大作家（下）

**授课日期**：2026-04-17

**课评内容**：

[新课评正文]

---

4. 生成 output 周汇总文件

所有学生课评生成完毕后，汇总本周所有课评到一个markdown文件：

文件路径：output/第[X]周课评汇总.md

如果 output 文件夹不存在，自动创建
如果目标文件不存在，自动新建；如果已存在，覆盖写入最新内容

文件格式（按日期倒叙排列，最新课程在前）：

# 第X周课评汇总
📅 日期范围：[日期范围]

---

## 【周日下午 1400 AI03班】（4人上课）

### 贺楚悦
**课程**：AI大作家插图生成  
**日期**：2026-04-19

[课评正文]

---

### 林俊宇
**课程**：AI大作家插图生成  
**日期**：2026-04-19

[课评正文]

---

## 【周日早上 0845 AI03班】（3人上课，1人缺勤）

### 卢皓霖
⏸ 请假  
**备注**：请家长督促在家复习本周知识点

---

### 黄俊博
**课程**：AI大作家插图生成  
**日期**：2026-04-19

[课评正文]

---

### 穹狼科创 · 2026春季学期 ✨

排序规则（倒叙）：

按班级分组，日期最晚的班级排在最前面（倒叙排列）
同一班级内，学生顺序保持课程记录文档中的顺序
请假/缺勤学生也列出，标注状态和备注

生成步骤：

读取课程记录文档，按日期从晚到早排序班级（倒叙）
对每个班级，输出班级标题和人数信息
对出勤学生，从个人课评汇总文件中提取最新一条课评内容
对请假/缺勤学生，输出状态说明和复习建议
检查 output 文件夹是否存在，不存在则创建
保存到 output/第[X]周课评汇总.md

📋 模式二：单条课评生成（备用）

当不需要批量生成，只需要为单个学生写课评时使用。

使用流程

1. 确认学生/课程/课次 → 2. 自动获取OJ数据（仅CSP班级，运行Python脚本）→ 3. 读取相关资料 → 4. 交互式收集表现（通过提问获取具体信息）→ 5. 生成课评（CSP班级自动整合OJ数据）→ 6. 保存到学生文件夹（按课次顺序追加）

4. 交互式收集表现（新功能）

目的：如果初始信息不够具体，通过提问获取更详细、更个性化的内容。

触发条件：

初始描述过于笼统（如"表现很好"、"很认真"）
缺乏具体行为细节
没有成长对比信息
缺少家长视角的内容

提问策略：

获取具体行为
- "能具体说说嘉博在哪个环节表现最突出吗？"
- "他有没有什么特别让人印象深刻的行为？"
- "完成作品时，他是怎么做的？"
挖掘细节信息
- "他在调试时遇到了什么具体问题？"
- "花了多长时间完成？"
- "有没有主动提出什么有趣的想法？"
了解成长变化
- "相比上节课，他在哪些方面有明显进步？"
- "有没有保持好的习惯，或者需要改进的地方？"
- "课堂专注度有什么变化？"
收集家长需求
- "家长最关心孩子的哪个方面？"
- "在家可以做什么来帮助巩固本周所学？"
- "希望培养孩子的什么能力？"

信息整合原则：

每个回答都要写入课评，确保"言之有物"
将具体行为与能力培养联系起来
结合家长期望给出针对性建议
生成包含"家长视角"板块的完整课评

1. 确认基本信息

学生姓名：_______
班级：_______
课程类型：□CPP □AIGC □KITTEN □体验课
本节课次：第_______课
课评风格：根据班级自动匹配
- AI03班 → 温暖鼓励型
- K4班 → 家长信格式·温和鼓励型
- CSP03班 → 家长信格式·要求型
- 体验课 → 家长信格式·转化导向型

2. OJ数据获取（仅CSP班级，必须执行）

如果课程类型为CPP且班级为CSP03班，运行以下命令获取该学生的OJ做题数据：

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课 | ✅ 出勤 | |

操作步骤：

检查出勤登记文件是否存在，不存在则从模板创建
查找日期列，如果已有今日记录则更新，否则在表格末尾添加新行
状态标记为"✅ 出勤"
备注栏留空

🎨 学生类型速查

观察点	鼓励型学生	激励型学生
语言特征	"我不会"、"对不对"、"好难"	"我会了"、"太简单"、"够用了"
课堂表现	专注但沉默、需要确认、害怕出错	反应快、爱抢答、满足现状
作品完成	慢但认真、反复确认	快但粗糙、不愿优化
提问方式	被动等待老师发现	主动但缺乏深度

💡 生成技巧

AI03班 - 温暖鼓励型

多用"很棒"、"特别棒"、"超棒"和波浪号"～"
描述具体行为："一字一字打字"、"和AI聊了一节课"
温和建议用"要是...就更好啦～"
固定结尾："老师会继续关注【姓名】的表现，期待看到更多精彩！🌟💡"

K4班 - 家长信格式·温和鼓励型

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

CSP03班 - 家长信格式·要求型

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

CSP03班 OJ数据板块格式（必须包含）

课评正文后、鼓励结尾前，插入以下格式的OJ做题数据板块：

## 【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数据）

家长好，本周学习的内容是《字符串处理》：

string 类型的声明与使用

字符串的输入输出（cin / getline）

字符串的拼接与比较操作

常用字符串函数（size / substr / find）

培养独立调试与耐心排查错误的能力

子煜状态在线，课堂互动积极，能够跟上老师的节奏。对于字符串的基本操作掌握得不错，在讲解 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题，理解为什么编译出错、结果不对，而不是放着不管～加油呀！💪✨

题目	状态	提交次数	思考模式	错误类型
CSP03-07A	✅ 通过	1	一气呵成	—
CSP03-07B	✅ 通过	2	调试改进	WA×1
CSP03-07C	❌ 未通过	2	遇到困难	CE×1, WA×1

21 KiB Raw Blame History Unescape Escape

🎯 课评生成器技能包

📁 文件结构

🌟 功能说明

📋 模式一：批量课评生成（推荐）

使用流程

1. 课程记录文档格式

2. 解析与处理流程

3. 保存课评（按课次顺序追加）

4. 生成 output 周汇总文件

📋 模式二：单条课评生成（备用）

使用流程

4. 交互式收集表现（新功能）

1. 确认基本信息

2. OJ数据获取（仅CSP班级，必须执行）

3. 读取参考资料

4. 收集本次表现（交互式确认）

5. 生成课评（约200字，基于具体信息）

6. 保存课评（按课次顺序追加）

7. 更新出勤登记（自动）

🎨 学生类型速查

💡 生成技巧

AI03班 - 温暖鼓励型

K4班 - 家长信格式·温和鼓励型

CSP03班 - 家长信格式·要求型

CSP03班 OJ数据板块格式（必须包含）

体验课 - 家长信格式·转化导向型

⏱️ 时间分配

批量生成模式

单条生成模式

📝 示例课评

【OJ做题数据】

21 KiB

Raw Blame History