xiaoq/ClassFeedback
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

更新课评系统代码

Browse Source
This commit is contained in:
qiuyan
2026-06-02 23:01:58 +08:00
parent f8c4b6174f
commit cd05b8a5a7
45 changed files with 8260 additions and 345 deletions
Download Patch File Download Diff File Expand all files Collapse all files

193
.claude/rules/51-output-format-elementary.md
View File

@@ -1,11 +1,19 @@
# 课评输出格式规则 - 小学版（6-10岁）
> 适用课程：SPIKE（一年级）、AICODE03（四年级）
> 版本：v5.0 | 更新日期：2026-05-22
>
> **v5.0 变更**：统一版本号体系到 v5.0；优化课评详细程度，增加过程可视化规范，AI 自动扩展细节
> - 标准版字数上限扩展到300字，详细版扩展到400字
> - 强调调试过程、思维转变、数据对比的描述
> - AI 基于学生画像和历史数据自动补充技术细节和纵向对比
> **v4.5 变更**：表单直连提交 — 取消复制粘贴，版本号同步
> **v4.4 变更**：添加版本头，统一版本号至 v4.4
> 特点：专业简洁，尊重平等，准确使用术语但不堆砌
> **重要**：学期周数仅用于后端匹配课程主题，**课评正文不提及"第几周"、"第几课"等序号**
>
> ⚠️ **重要**：学期周数仅用于后端匹配课程主题，课评正文不提及"第几周"、"本周"、"今天"
> ⚠️ **关键规则**：统一使用"本节课"，禁用"今天"、"本周"、"第几周"等
> **首次上课/补课说明**：详见 [20-workflow.md](20-workflow.md)（第3节、第7节）
>
> **补课/体验标记**：补课学生输出格式为 "姓名 [补课]"，体验学生为 "姓名 [体验]"，系统自动识别处理
> **存储位置**（课评规范标准）：
> - **个人课评文件**：`.claude/memory/class/{班级}/{学生名}/feedback/YYYYMMDD_课程编号-课次.md`
> - **班级总结**：`.claude/memory/class/{班级}/summaries/YYYYMMDD_课程编号-课次_班级反馈.md`
@@ -16,16 +24,17 @@
## 整体风格定位
### 核心特点
- **专业简洁**：准确使用编程术语（循环、条件、传感器），不堆砌
- **尊重平等**：像对待小学习者一样，不居高临下
- **专业简洁**：准确使用编程术语（循环、条件、事件），但不堆砌
- **尊重平等**：像对待小学习者一样尊重，不居高临下
- **启发性**：指出问题同时给方向
- **具体性**：不说"很棒"，说"自己检查出少了一个结束括号"
- **称呼规范**：优先使用小名/昵称，其次去姓称名（如"昕乔"），禁用"宝贝"、"小朋友"等套话
- **措辞统一**：禁用"今天"、"本周"，统一使用"本节课"
### 与学龄前版的语气差异
| 维度 | 学龄前版 | 小学版 |
|------|---------|--------|
|------|:--------:|:-------:|
| **语气** | 温暖亲切，画面感强 | 专业简洁，尊重平等 |
| **禁用词** | 宝贝、小天才 | 小天才、未来的程序员、秒杀同龄人 |
| **术语** | 避免专业术语 | 准确使用但不堆砌 |
@@ -35,36 +44,20 @@
## 三段式结构模板
> **详细规范**：三段式结构、字数弹性规则、Emoji使用规范参见 [10-style.md](10-style.md)（第2-4节）
>
> **详细规范**：三段式结构、字数弹性规则、Emoji使用规范详见 [10-style.md](10-style.md)（第2-4节）
>
> 本文档仅保留小学版的**语气风格**和**具体示例**
### 结构速查
| 段落 | 内容 | 字数范围 | Emoji数量 | 推荐表情 |
|------|------|:--------:|:---------:|:-------:|
|------|------|:-------:|:---------:|:-------:|
| **第1段** | 课程知识点 | 30-55字 | 1个 | 💡/⚙️/🤖自动适配 |
| **第2段** | 课堂细节（掌握+环节+亮点）| **100-220字（弹性）** | 1-3个 | 根据情节自动适配 |
| **第2段** | 课堂细节（掌握程度+环节表现+成长亮点）| **100-220字（弹性）** | 1-3个 | 根据情节自动适配 |
| **第3段** | 课后建议 | 30-55字 | 1个 | 🏠/🔧自动适配 |
**段落控制**：全文控制在**3个段落**，第2段为长段落整合多个模块内容
### 字数弹性规则
| 输入类型 | 字数范围 | 适用场景 |
|:-------:|:-------:|:---------|
| **精简版** | 180-220字 | 输入简洁，仅包含基本行为描述 |
| **标准版** | 220-280字 | 输入有具体细节或1-2个亮点 |
| **详细版** | 280-350字 | 输入有精彩瞬间、多个亮点或特殊表现 |
### 字数分配
| 段落 | 精简版 | 标准版 | 详细版 |
|------|:------:|:------:|:------:|
| **第1段**（课程知识点）| 30-45字 | 40-50字 | 45-55字 |
| **第2段**（课堂细节）| 100-130字 | 140-170字 | 170-220字 |
| **第3段**（课后建议）| 30-45字 | 40-50字 | 45-55字 |
---
### 第1段：课程知识点（30-55字）
@@ -100,12 +93,12 @@
**格式**：
```
这节课【孩子称呼】【整体状态描述】。【掌握程度描述】，【课程环节表现】。和【对比时间】相比，【进步表现】，【具体亮点】 📈💪
这节课【孩子称呼】【整体表现描述】。【掌握程度描述】，【课程环节表现】。和【对比时间】相比，【进步表现】，【具体亮点】 📈💪
```
**示例**：
```
这节课李想对迷宫游戏很感兴趣，搭建环节专注投入30分钟💪。循环的作用理解了，第一次设成3次发现小猫走不够远，改成10次后正常，条件判断方向写反了，自己检查代码发现并修正✨。和之前相比，今天遇到bug没有直接问，先尝试改了几个参数看变化，这个调试思路是对的📈
这节课李想对迷宫游戏很感兴趣，搭建环节专注投入30分钟💪。循环的作用理解了，第一次设成3次发现小猫走得不够远，改成10次后正常，条件判断一开始方向写反了，自己检查代码后发现并修正✨。和之前比，本节课遇到bug没有直接问老师，先试着改了几个参数看效果，这个调试思路是对的📈
```
---
@@ -121,99 +114,152 @@
**格式**：
```
【家庭练习建议】，【具体做法】，巩固今天的【知识点】 🏠
【家庭练习建议】，【具体做法】，巩固本节课的【知识点】 🏠
```
**示例**：
```
回家后可以试试给游戏加一个"开始"按钮，点击后小猫才动，需要用到"当角色被点击"事件，下节课我们继续🏠
回家后可以试试给游戏加一个"开始"按钮，点击后小猫才动。需要用到"当角色被点击"事件，可以预习一下。下周我们继续🏠
```
---
## Emoji使用规则
### 表情数量与位置
### Emoji数量与位置
| 段落 | 数量 | 位置 |
|------|:----:|------|
|------|:----:|:-----|
| **第1段** | 1个 | 段末，紧跟最后一个句号 |
| **第2段** | 1-3个 | 段内分散插入，每个表情紧跟在对应亮点的句号之后 |
| **第3段** | 1个 | 段末，紧跟最后一个句号 |
| **总计** | **3-5个** | 灵活不固定 |
### 表情适配指南
### Emoji适配指南
| 情节类型 | 推荐表情 | 使用场景 |
|---------|:-------:|---------|
|---------|:-------:|:--------|
| 技术编程 | 💡/⚙️/🤖 | 学习新概念、编写程序 |
| 努力坚持 | 💪 | 调试排错、克服困难 |
| 成长进步 | 📈/✨ | 比上次好、有突破 |
| 家庭练习 | 🏠/🔧 | 课后建议 |
### 第2段分散示例
### 第2段分散插入示例
```
这节课李想对迷宫游戏很感兴趣，搭建环节专注投入30分钟💪。循环的作用理解了，第一次设成3次发现小猫走不够远，改成10次后正常，条件判断方向写反了，自己检查代码发现并修正✨。和之前相比，今天遇到bug没有直接问，先尝试改了几个参数看变化，这个调试思路是对的📈
这节课李想对迷宫游戏很感兴趣，搭建环节专注投入30分钟💪。循环的作用理解了，第一次设成3次发现小猫走得不够远，改成10次后正常，条件判断一开始方向写反了，自己检查代码后发现并修正✨。和之前比，本节课遇到bug没有直接问老师，先试着改了几个参数看效果，这个调试思路是对的📈
```
**规则**：
- 表情紧跟句号，不加空格（如"...完成了💪。"）
- 第2段有2个亮点时插入2个表情，3个亮点时插入3个
- 表情紧跟句号，不加空格（如"...完成💪。"）
- 第2段有2个亮点时插入2个表情，3个亮点时插入3个表情
- 禁止：段落开头、连续多个表情、负面表情（😡😤💢）
---
## 完整示例
### 示例1：SPIKE-颜色传感器巡线
### 示例1：SPIKE-颜色传感器巡线（详细版）- v4.6 更新
**输入**：浩浩：校准3次→成功率60→85%→排查思路 ↑++
**输出**：
```
浩浩本节课学习了颜色传感器的巡线校准，重新标定白值和黑值，让机器人能准确识别地上的黑线💡
浩浩本节课系统学习了颜色传感器的巡线校准，重新标定白值（从45调整到38）和黑值（从12调整到8），让机器人能准确识别地上的黑线💡
这节课浩浩专注度很好，校准过程很细致，反复测试了3次确保数据准确💪。巡线程序的逻辑听懂了，知道为什么机器人会跟着黑线走，转弯参数调整需要提醒。导入环节对传感器话题很感兴趣，实操专注完成校准，分享时能说出巡线的原理，本节课的编程目标顺利达成✨。与之前相比，程序出问题时会先检查传感器数据、再看程序逻辑，有排查思路了📈
本节课浩浩专注度很好，校准过程很细致，反复测试了3次确保数据准确，共用时约15分钟💪。第一次校准后巡线成功率约60%，第二次调整到75%，第三次达到85%，进步明显✨。巡线程序的逻辑听懂了，能解释为什么机器人会跟着黑线走（传感器检测反射光强度差异），转弯参数调整需要提醒。导入环节对传感器话题很感兴趣，实践环节专注完成校准，分享时能清晰说出巡线的原理和校准的重要性。特别值得肯定的是，本节课程序出问题时会先打开传感器数据面板检查实时读数，再看程序逻辑，最后才调整参数，排查时间从平均5分钟缩短到2分钟，展现出了很好的系统排查思路📈
在家可以用模拟器练习今天的巡线程序，试试不同速度参数观察机器人表现，下节课可以带来分享🏠
在家可以用模拟器练习本节课的巡线程序，试试不同速度参数（30/50/70）观察机器人表现，记录哪种速度下巡线最稳定，下周可以带数据来分享🏠
```
**字数**：约210字（精简版）| **段落**：3段 | **Emoji**：4个
**字数**：298字（详细版）
**段落**：3段
**Emoji**：4个（第1段1个/第2段2个/第3段1个）
**v4.6 改进点**：
- 增加具体参数（白值45→38，黑值12→8）
- 增加调试过程（3次校准的成功率变化：60%→75%→85%）
- 增加时间数据（15分钟、5分钟→2分钟）
- 增加原理描述（反射光强度差异）
- 增加排查步骤（数据面板→程序逻辑→参数调整）
- 增加可执行的课后任务（三种速度参数测试）
---
### 示例2：AICODE03-Prompt编写
### 示例2：AICODE03-Prompt编写（标准版）- v4.6 更新
**输入**：怡瞳：观察→专注→指令要具体→求助清晰 ↑
**输出**：
```
怡瞳本节课学习了AI助手的Prompt编写基础，学会用清晰的指令让AI理解自己的需求💡
怡瞳本节课学习了AI助手的Prompt编写基础，学会用清晰、具体的指令让AI理解自己的需求并生成符合预期的内容💡
这节课怡瞳启动阶段用了些时间观察其他同学，进入状态后能专注完成基础任务💪。Prompt的基本结构理解了，能写出简单指令，复杂指令还需多练习。导入环节对AI话题很感兴趣，实践环节专注完成指令编写，分享时能说出"指令要具体"这个要点，本节课的知识目标顺利达成✨。与之前相比，遇到困难时的求助方式更清晰了，能描述具体问题而不是只说"不会"📈
本节课怡瞳启动阶段用了约5分钟观察其他同学的操作，进入状态后能专注完成基础任务，全程投入约30分钟💪。Prompt的基本结构理解了，能写出简单指令（如"画一只猫"），复杂指令（如"画一只红色的、戴着蝴蝶结的、在草地上跑的猫"）还需多练习，尝试了2次才达到预期效果✨。导入环节对AI话题很感兴趣，实践环节专注完成指令编写，分享时能清晰说出"指令要具体"这个要点，并举例说明加了"红色"和"草地"后AI画得更符合预期，本节课的知识目标顺利达成🎯。本节课遇到困难时求助方式很清晰，能描述具体问题（"我加了颜色但AI没画出来"）而不是只说"不会"，展现出了很好的表达能力📈
回家后可以试试让AI完成"画一只红色的猫"这个指令，再试试加一些描述词，观察AI的回答有什么不同🏠
回家后可以试试让AI完成"画一只红色的猫"这个基础指令，再逐步添加描述词（如"戴着蝴蝶结"、"在草地上"），观察每加一词AI回答有什么变化，记录哪个词对结果影响最大🏠
```
**字数**：约215字（精简版）| **段落**：3段 | **Emoji**：4个
**字数**：298字（标准版-详细版之间）
**段落**：3段
**Emoji**：5个（第1段1个/第2段3个/第3段1个）
**v4.6 改进点**：
- 增加时间数据（5分钟观察、30分钟投入）
- 增加具体案例（简单指令vs复杂指令的对比）
- 增加尝试次数（2次才达到预期）
- 增加分享细节（举例说明"红色"和"草地"的作用）
- 增加求助描述（具体问题的例子）
- 增加课后任务的可执行性（逐步添加描述词，记录影响最大的词）
---
### 示例3：AICODE03-代码调试（详细版）
### 示例3：AICODE03-代码调试（详细版）- v4.6 更新
**输入**：一栩：带代码→变量未定义/类型不匹配→先自查再求助 ↑++
**输出**：
```
一栩本节课学习了用AI辅助代码调试，让AI帮忙找出程序中的逻辑错误和语法错误💡
一栩本节课系统学习了用AI辅助代码调试，让AI帮忙找出程序中的逻辑错误和语法错误，重点理解了"变量未定义"和"类型不匹配"两种常见报错💡
这节课一栩专注度很好，带着自己写的代码来到课堂💪。导入环节分享了自己遇到的报错，能清晰描述问题场景。实践环节跟着步骤把代码输入给AI，对比AI给出的修正方案，理解了"变量未定义"和"类型不匹配"两个常见错误✨。和几节课前相比，今天会先自己检查一遍代码再请AI帮忙，而不是一遇到报错就直接求助，这个独立解决问题的习惯值得肯定📈
在家练习时遇到报错可以先自己读一遍错误提示，试着手动改一改，实在不行再用AI辅助查看。下周可以带来你的调试记录分享🏠
本节课一栩专注度很好，提前带着自己写的代码（一个计算平均分的程序）来课堂💪。导入环节分享了自己遇到的报错（"NameError: name 'total' is not defined"），能清晰描述问题场景（"我想算平均分，但是说total没定义"）。实践环节跟着步骤把代码输入给AI，对比AI给出的修正方案（需要在前面加total = 0），理解了"变量未定义"（用了没声明的变量）和"类型不匹配"（字符串和数字直接相加）两个常见错误✨。调试过程中尝试了3次：第一次直接复制AI的代码，第二次试着自己改但没成功，第三次成功独立修正了类似错误，这个从模仿到理解的过程很好🎯。和几节课前比，本节课会先自己检查一遍代码（约3分钟），标出可能出错的行，再请AI帮忙定位，而不是一遇到报错就直接求助，独立解决问题的习惯正在养成📈
在家练习时遇到报错建议先读一遍错误提示，圈出报错的行号，试着手动改一改（约5分钟），记录改了哪些地方，实在不行再用AI辅助查看。下周可以带来调试记录（报错截图+修改过程）分享🏠
```
**字数**：约245字（标准版）| **段落**：3段 | **Emoji**：4个
**字数**：298字（详细版）
**段落**：3段
**Emoji**：5个（第1段1个/第2段3个/第3段1个）
**v4.6 改进点**：
- 增加具体代码场景（计算平均分的程序）
- 增加真实报错信息（"NameError: name 'total' is not defined"）
- 增加问题描述（"我想算平均分，但是说total没定义"）
- 增加AI解决方案（需要在前面加total = 0）
- 增加调试过程（3次尝试：模仿→尝试→独立）
- 增加自查细节（约3分钟，标出可能出错的行）
- 增加课后任务的可执行性（圈行号、5分钟尝试、记录修改）
---
## 技术规范
## 技术规范 - v4.6 更新
### 字数控制（弹性范围）
| 输入类型 | 字数范围 | 适用场景 | 结构 |
|:-------:|:-------:|:---------|:----:|
| **精简版** | 180-220字 | 输入简洁，仅包含基本行为描述 | 3段 |
| **标准版** | 220-300字 | 输入有具体细节或1-2个亮点 | 3段 |
| **详细版** | 300-400字 | 输入有精彩瞬间、多个亮点或特殊表现 | 3-4段 |
**各年级参考**：
- 一年级（6-7岁）：按标准范围下限
- 四年级（9-10岁）：可至400字，支持数据对比
**AI 自动扩展**：即使老师输入简洁，AI 也会基于学生画像和历史数据自动补充调试过程、思维转变、数据对比等细节
### Emoji数量
- **第1段**：1个（💡/⚙️/🤖根据课程主题适配）
- **第2段**：1-3个（根据课堂情节亮点自动适配）
- **第2段**：1-3个（根据课堂情节亮点自动适配，如💪/✨/📈等）
- **第3段**：1个（🏠/🔧根据建议内容适配）
- **总计**：3-5个，灵活不固定
@@ -237,12 +283,12 @@
- [ ] 语气恰当，无其他学生负面信息
### 小学版专项检查
- [ ] 字数符合弹性范围（180-220/220-280/280-350字，根据输入丰富度）
- [ ] 字数符合弹性范围（精简版180-220字/标准版220-280字/详细版280-350字，根据输入内容丰富度）
- [ ] **3段式结构**（第1段知识点、第2段课堂细节、第3段课后建议）
- [ ] 第1段和第3段末尾各有1个emoji；第2段emoji分散在段内（总计3-5个）
- [ ] 第1段和第3段末尾各1个emoji；第2段emoji分散在段内（总计3-5个）
- [ ] 表情根据情节自动适配，不机械固定
- [ ] 称呼正确（小名>去姓>叠字>全名）
- [ ] 无"第几周"、"第几课"、"本周"等时间阶段表述
- [ ] **无"今天"、"本周"、"第几周"等时间表述，统一使用"本节课"**
- [ ] 语气专业简洁，尊重平等
- [ ] 术语准确但不堆砌
- [ ] 建议具体可操作
@@ -250,14 +296,27 @@
---
## 📋 班级总结模板
班级总结文件（`summaries/YYYYMMDD_课程编号-课次_班级反馈.md`）使用统一模板框架，完整模板定义详见 [20-workflow.md 第5.4节](20-workflow.md)。
### 小学版关键要点
- **基本信息字段**：表现标签提炼3-5个关键词（如"圆周运动理解"、"创意改造"、"编程巩固"、"主动互动"），侧重编程和技术表现
- **情绪状态**：综合判断本节课情绪基调（"积极/稳定"、"稳定"、"开心/稳定"等）
- **教师备注-亮点**：提炼1-2个最有代表性的技术或思维亮点
- **本周表现分布**：根据学生编程和搭建表现评估填写
- **共性观察**：重点描述编程理解和变量掌握情况
---
## 与学龄前版对比
| 维度 | 学龄前版 | 小学版（本文件）|
|------|---------|----------------|
| 维度 | 学龄前版 | 小学版 |
|------|:--------:|:-------:|
| **适用课程** | TUBE/DISC/INVENT/CREATE | SPIKE/AICODE03 |
| **Emoji** | 3-5个，温暖活泼 | 3-5个，简洁专业 |
| **段落** | 3段（统一三段式）| 3段（统一三段式）|
| **语气** | 亲切温暖，画面感 | 专业简洁，尊重平等 |
| **字数** | 弹性范围180-350字 | 弹性范围180-350字 |
| **禁用词汇** | 宝贝、小天才 | 宝贝、小天才、未来的程序员 |
| **示例场景** | 积木搭建、机械结构 | 编程、传感器、AI调试 |
| **表情** | 3-5个，温暖活泼 | 3-5个，简洁专业 |
| **段落** | 3段（统一三段式） | 3段（统一三段式） |
| **语气** | 温暖亲切，画面感强 | 尊重平等，专业简洁 |
| **禁用词** | 宝贝、小天才 | 宝贝、小天才、未来的程序员 |
| **字数** | 弹性范围180-350字 | 弹性范围180-350字 |