更新课评系统代码
This commit is contained in:
@@ -1,8 +1,12 @@
|
||||
# 核心规则
|
||||
|
||||
> 合并文件:系统基础规则 + 年龄段分类 + 课程类型定义 + 评价维度 + 评分标准
|
||||
> 版本:v4.0 | 更新日期:2026-05-14
|
||||
>
|
||||
> 版本:v5.0 | 更新日期:2026-05-22
|
||||
>
|
||||
> **v5.0 变更**:统一版本号体系到 v5.0,建立清晰的版本管理规范;同步所有文件版本
|
||||
> **v4.5 变更**:表单直连提交 — 网页表单直接 POST 到本地服务器,取消复制粘贴;版本号同步
|
||||
> **v4.4 变更**:无内容变更,版本号同步
|
||||
> **v4.3 变更**:无内容变更,版本号同步
|
||||
> **v4.0 变更**:同步课评规范V1.0 — 新增3.4节「校宝课程编号规范」:C++班统一用CSP、AI编程班统一用AICODE+编号
|
||||
|
||||
---
|
||||
|
||||
@@ -1,7 +1,15 @@
|
||||
# 风格规则:课评写作风格与结构规范
|
||||
|
||||
> 合并文件:幼儿积木搭建 + 少儿编程入门 + 机器人竞赛 + 通用结构规范
|
||||
> 版本:v3.1(合并版)| 更新日期:2026-05-05
|
||||
> 版本:v4.6 | 更新日期:2026-05-20
|
||||
>
|
||||
> **v4.6 变更**:优化课评详细程度,增加时间描述年龄适配,AI 自动扩展细节
|
||||
> - 标准版字数上限从280扩展到300字,详细版从350扩展到400字
|
||||
> - 新增"思维过程"和"具体数据"评估维度
|
||||
> - 分年龄段时间描述规范(幼儿模糊化/小学精确化)
|
||||
> **v4.5 变更**:表单直连提交 — 取消复制粘贴,版本号同步
|
||||
> **v4.4 变更**:统一版本号至 v4.4;更新日期
|
||||
> **v3.2 变更**:禁用"今天",统一使用"本节课";禁用"本周"等时间表述
|
||||
|
||||
---
|
||||
|
||||
@@ -13,6 +21,11 @@
|
||||
| 输出字数 | **弹性范围:180-350字**(根据输入内容丰富度自动调整) |
|
||||
| 段落数 | **3段** |
|
||||
|
||||
### ⚠️ 关键措辞规范(必须遵守)
|
||||
- **禁用"今天"**,统一使用"本节课"
|
||||
- **禁用"本周"、"这周"、"上周课"、"第几周"**等时间表述
|
||||
- 姓名规则:优先使用小名/昵称,其次去姓称名(如"昕乔"),禁用"宝贝"、"小朋友"等套话
|
||||
|
||||
### 课程类型与风格对应
|
||||
|
||||
| 课程类型 | 适用年龄 | 风格特点 | 基准字数 |
|
||||
@@ -33,13 +46,18 @@
|
||||
| **第2段** | 课堂细节(掌握程度+课程环节+成长亮点)| **100-220字(弹性)** | 见下表 |
|
||||
| **第3段** | 课后建议 | 30-55字 | 见下表 |
|
||||
|
||||
### 2.2 字数弹性规则
|
||||
### 2.2 字数弹性规则(v4.6 优化版)
|
||||
|
||||
| 输入类型 | 字数范围 | 触发条件 |
|
||||
|:-------:|:-------:|:---------|
|
||||
| **精简版** | 180-220字 | 输入简洁,仅包含基本行为描述 |
|
||||
| **标准版** | 220-280字 | 输入有具体细节或1-2个亮点 |
|
||||
| **详细版** | 280-350字 | 输入有精彩瞬间、多个亮点或特殊表现 |
|
||||
| 输入类型 | 字数范围 | 触发条件 | 结构 |
|
||||
|:-------:|:-------:|:---------|:----:|
|
||||
| **精简版** | 180-220字 | 输入简洁,仅包含基本行为描述 | 3段 |
|
||||
| **标准版** | 220-300字 | 输入有具体细节或1-2个亮点 | 3段 |
|
||||
| **详细版** | 300-400字 | 输入有精彩瞬间、多个亮点或特殊表现 | 3-4段 |
|
||||
|
||||
**v4.6 优化说明**:
|
||||
- 标准版上限从280字扩展到300字,允许更充分的细节描述
|
||||
- 详细版上限从350字扩展到400字,支持4段式结构
|
||||
- AI 基于学生画像和历史数据自动扩展细节,无需老师额外输入
|
||||
|
||||
### 2.3 各年龄段字数调整
|
||||
|
||||
@@ -63,27 +81,46 @@
|
||||
- **具体性**:不说"很棒",说"把弧形积木稳稳地卡进了凹槽"
|
||||
- **画面感**:描述作品细节,让家长能想象出画面
|
||||
- **克制感**:不用"天才""最棒"等夸张词,真诚即可
|
||||
- **时间模糊化**:不用精确分钟数,用自然时段描述
|
||||
|
||||
**禁用词汇**:宝贝、小天才、最棒、无敌、超级厉害、完美、套话("在今天的课堂上""通过本次活动")、比较性语言("比其他小朋友")
|
||||
**禁用词汇**:宝贝、小天才、最棒、无敌、超级厉害、完美、套话("在本节课的课堂上""通过本次活动")、比较性语言("比其他小朋友")
|
||||
|
||||
**推荐表达**:
|
||||
- 姓名使用:优先小名/昵称,其次去姓称名(如"昕乔")
|
||||
- 具体动作:"试了三次终于搭稳了底座"
|
||||
- 过程描述:"一开始想搭高塔,后来改成了小房子"
|
||||
|
||||
**时间描述规范(幼儿版)**:
|
||||
| 速记 | 输出表述 | 说明 |
|
||||
|------|---------|------|
|
||||
| `gj5` | 开始阶段先观察了一会儿 | 不用"5分钟" |
|
||||
| `zx15` | 能安静地玩一阵子 | 托班/小班适用 |
|
||||
| `zx30` | 专注投入了挺长时间 | 中班/大班适用 |
|
||||
| `zx45` | 几乎整节课都很投入 | 表现很好时使用 |
|
||||
|
||||
### 3.2 少儿编程课(6-8岁)
|
||||
|
||||
**语言特点**:
|
||||
- **专业度**:准确使用编程术语(循环、条件、事件),但不堆砌
|
||||
- **平等感**:像对待小学习者一样尊重,不居高临下
|
||||
- **启发性**:指出问题同时给方向,"这里如果换个顺序..."
|
||||
- **实在感**:不夸大"编程改变命运",而是聊"今天解决了什么问题"
|
||||
- **实在感**:不夸大"编程改变命运",而是聊"本节课解决了什么问题"
|
||||
- **过程可视化**:描述调试过程、思维转变、尝试次数
|
||||
|
||||
**禁用词汇**:小天才、未来的程序员、最聪明、秒杀同龄人、套话("在人工智能时代""培养计算思维")、夸大("掌握了编程的核心奥秘")
|
||||
|
||||
**推荐表达**:
|
||||
- 技术描述:"用'如果碰到边缘就反弹'解决了角色飞出屏幕的问题"
|
||||
- 过程记录:"先试了三次循环,发现次数不够,改成了重复10次"
|
||||
- 调试细节:"第一次方向写反了,检查代码后发现并修正"
|
||||
- 思维变化:"遇到bug没有直接问老师,先试着改了几个参数看效果"
|
||||
|
||||
**时间描述规范(小学低年级)**:
|
||||
| 速记 | 输出表述 | 说明 |
|
||||
|------|---------|------|
|
||||
| `zx30` | 专注投入约30分钟 | 可用相对精确时间 |
|
||||
| `调试3次` | 调试了3次,花了大约10分钟 | 描述调试过程 |
|
||||
| `sb2` | 试了2次后成功 | 强调尝试过程 |
|
||||
|
||||
### 3.3 机器人竞赛课(8-10岁)
|
||||
|
||||
@@ -92,6 +129,7 @@
|
||||
- **专业性**:准确描述技术细节(传感器校准、PID调速、机械臂力矩)
|
||||
- **成长视角**:把失败当作数据收集,把胜利当作阶段成果
|
||||
- **团队意识**:强调分工配合,不只突出个人
|
||||
- **数据驱动**:用具体数字说话(成功率、时间、参数)
|
||||
|
||||
**禁用词汇**:天才、大神、无敌、秒杀、碾压、套话("友谊第一比赛第二""胜不骄败不馁")、空洞("展现了良好的精神风貌")
|
||||
|
||||
@@ -99,6 +137,16 @@
|
||||
- 技术描述:"超声波传感器检测距离30cm时启动机械臂"
|
||||
- 战术分析:"选择了先拿近处资源块的策略,放弃了远处的"
|
||||
- 复盘语言:"翻车的原因是重心偏高,下次可以..."
|
||||
- 数据记录:"校准后巡线成功率从60%提升到85%"
|
||||
- 效率对比:"排查时间从平均3分钟缩短到1.5分钟"
|
||||
|
||||
**时间描述规范(小学高年级)**:
|
||||
| 速记 | 输出表述 | 说明 |
|
||||
|------|---------|------|
|
||||
| `zx30` | 专注投入约30分钟 | 精确时间 |
|
||||
| `成功率60→85%` | 成功率从60%提升到85% | 数据对比 |
|
||||
| `调试3次` | 经过3次调试,共用时10分钟 | 详细过程 |
|
||||
| `排查3分钟` | 排查时间约3分钟 | 效率描述 |
|
||||
|
||||
---
|
||||
|
||||
@@ -125,7 +173,7 @@
|
||||
| 开心兴奋 | 😊/🌟 | 情绪积极、喜欢这节课 |
|
||||
| 合作互助 | 🤝 | 帮助同伴、团队协作 |
|
||||
| 家庭延伸 | 🏠 | 课后建议 |
|
||||
| 技术编程 | ⚙️/🤖 | SPIKE/AI03课程 |
|
||||
| 技术编程 | ⚙️/🤖 | SPIKE/AICODE03课程 |
|
||||
|
||||
### 4.3 Emoji位置
|
||||
|
||||
@@ -137,7 +185,7 @@
|
||||
|
||||
**第2段分散插入示例**:
|
||||
```
|
||||
互锁的方法听懂了,实际操作时前两块需要老师扶着手指对齐💪,第三块开始能自己完成✨。和上周比,今天结构倒了没有发脾气,而是拆开重新观察了一下底座平不平,这个调整值得注意🌟。
|
||||
互锁的方法听懂了,实际操作时前两块需要老师扶着手指对齐💪,第三块开始能自己完成✨。和上周比,本节课结构倒了没有发脾气,而是拆开重新观察了一下底座平不平,这个调整值得注意🌟。
|
||||
```
|
||||
|
||||
**规则**:
|
||||
@@ -169,9 +217,9 @@
|
||||
- 突出兴趣:用孩子感兴趣的比喻或场景
|
||||
|
||||
**示例**:
|
||||
- "今天认识了'互锁结构',像拼图一样把积木交错叠在一起,搭好的墙不容易倒。"
|
||||
- "今天接触了'重复执行'(循环),用它让小鸟持续扇翅膀,不用重复写很多次一样的代码。"
|
||||
- "今天训练了颜色传感器的巡线校准,包括白值/黑值重新标定和阈值调整。"
|
||||
- "本节课认识了'互锁结构',像拼图一样把积木交错叠在一起,搭好的墙不容易倒。"
|
||||
- "本节课接触了'重复执行'(循环),用它让小鸟持续扇翅膀,不用重复写很多次一样的代码。"
|
||||
- "本节课训练了颜色传感器的巡线校准,包括白值/黑值重新标定和阈值调整。"
|
||||
|
||||
### 5.2 掌握程度(第2段前半)
|
||||
|
||||
@@ -190,23 +238,35 @@
|
||||
|
||||
### 5.4 成长亮点(第2段后半)
|
||||
|
||||
**写什么**:与之前课程相比的进步,或本次的突出表现
|
||||
**写什么**:本节课展现出的进步或突出表现(**避免使用"和之前相比"、"和两周前相比"等直接对比句式**)
|
||||
**写法**:
|
||||
- 纵向对比:"上次搭到一半就放弃,今天坚持到完成"
|
||||
- 思维变化:"以前直接问老师,今天先试着自己改参数看效果"
|
||||
- 习惯养成:"每次试车前都检查螺丝松紧,之前经常忘"
|
||||
- **直接描述进步**:"本节课坚持到最后完成,没有中途放弃"
|
||||
- **突出当下表现**:"本节课遇到困难先试着自己改参数看效果,再寻求帮助"
|
||||
- **强调习惯养成**:"本节课每次试车前都主动检查螺丝松紧,非常细心"
|
||||
- **展现思维成长**:"本节课能清晰描述问题,而不是只说'不会'"
|
||||
|
||||
**❌ 避免使用**:
|
||||
- "和上周相比,本节课..."
|
||||
- "和两周前相比,本节课..."
|
||||
- "和之前相比,本节课..."
|
||||
|
||||
**✅ 推荐表达**:
|
||||
- "本节课展现出了..."
|
||||
- "本节课能独立..."
|
||||
- "本节课主动..."
|
||||
- "本节课坚持..."
|
||||
|
||||
### 5.5 课后建议(第3段)
|
||||
|
||||
**写什么**:家长可以在家配合的具体活动
|
||||
**写法**:
|
||||
- 可操作:不说"多练习",说"用筷子夹豆子"
|
||||
- 关联课程:"在家可以用乐高重复今天的互锁结构"
|
||||
- 关联课程:"在家可以用乐高重复本节课的互锁结构"
|
||||
- 尊重家庭:用"可以试试看"而非"必须"
|
||||
|
||||
---
|
||||
|
||||
## 六、输入丰富度评估算法
|
||||
## 六、输入丰富度评估算法(v4.6 优化版)
|
||||
|
||||
### 6.1 评估维度与分值
|
||||
|
||||
@@ -217,51 +277,72 @@
|
||||
| **纵向对比** | 0-2分 | 提及之前表现+1分,有明确对比+1分 | "比上周"=1分,"比上周主动多了"=2分 |
|
||||
| **精彩瞬间** | 0-2分 | 有突破性行为/创新/社交互动 | "第一次主动帮助别人"=2分 |
|
||||
| **技术细节** | 0-1分 | 有具体数字/参数/步骤 | "调整了3次"、"设了5次循环" = 1分 |
|
||||
| **思维过程** | 0-2分 | 描述思考/决策/排查过程 | "先检查了...再发现..."=2分 |
|
||||
| **具体数据** | 0-2分 | 有时间/次数/百分比等数据 | "调试了3次,用了8分钟"=2分 |
|
||||
|
||||
**满分**:10分
|
||||
**满分**:14分
|
||||
|
||||
### 6.2 版本选择决策矩阵
|
||||
### 6.2 版本选择决策矩阵(v4.6 更新)
|
||||
|
||||
| 总分 | 输出版本 | 字数范围 |
|
||||
|:----:|:-------:|:-------:|
|
||||
| 0-3分 | **精简版** | 180-220字 |
|
||||
| 4-6分 | **标准版** | 220-280字 |
|
||||
| 7-10分 | **详细版** | 280-350字 |
|
||||
| 总分 | 输出版本 | 字数范围 | 结构 |
|
||||
|:----:|:-------:|:-------:|:----:|
|
||||
| 0-4分 | **精简版** | 180-220字 | 3段 |
|
||||
| 5-8分 | **标准版** | 220-300字 | 3段 |
|
||||
| 9-14分 | **详细版** | 300-400字 | 3-4段 |
|
||||
|
||||
### 6.3 评估示例
|
||||
**v4.6 优化说明**:
|
||||
- 新增"思维过程"和"具体数据"两个维度,鼓励描述学生的思考过程
|
||||
- 详细版支持4段式结构,允许更充分的细节展开
|
||||
- AI 基于学生画像和历史数据自动补充细节,老师输入简洁也能得到丰富输出
|
||||
|
||||
### 6.3 评估示例(v4.6 更新)
|
||||
|
||||
**精简输入**:"乔乔:搭了3层,开心"
|
||||
- 行为数量:1分 | 情绪描述:1分 | 纵向对比:0分 | 精彩瞬间:0分 | 技术细节:0分
|
||||
- **总分:2分 → 精简版**
|
||||
- 行为数量:1分 | 情绪描述:1分 | 纵向对比:0分 | 精彩瞬间:0分 | 技术细节:0分 | 思维过程:0分 | 具体数据:0分
|
||||
- **总分:2分 → 精简版(180-220字)**
|
||||
|
||||
**标准输入**:"乔乔观望5分钟后主动搭3层,自己调整,开心,比上周有进步"
|
||||
- 行为数量:3分 | 情绪描述:1分 | 纵向对比:1分 | 精彩瞬间:0分 | 技术细节:1分
|
||||
- **总分:6分 → 标准版**
|
||||
- 行为数量:3分 | 情绪描述:1分 | 纵向对比:1分 | 精彩瞬间:0分 | 技术细节:1分 | 思维过程:0分 | 具体数据:1分
|
||||
- **总分:7分 → 标准版(220-300字)**
|
||||
|
||||
**详细输入**:"乔乔观望5分钟后主动搭3层,球卡住自己调整,还帮助旁边的小朋友,最后说这是最喜欢的作品,比上周主动多了"
|
||||
- 行为数量:3分 | 情绪描述:2分 | 纵向对比:2分 | 精彩瞬间:2分 | 技术细节:1分
|
||||
- **总分:10分 → 详细版**
|
||||
- 行为数量:3分 | 情绪描述:2分 | 纵向对比:2分 | 精彩瞬间:2分 | 技术细节:1分 | 思维过程:1分 | 具体数据:1分
|
||||
- **总分:12分 → 详细版(300-400字)**
|
||||
|
||||
**AI 自动扩展示例**:
|
||||
- **老师输入**:"乔乔:gj5→zd3→zt ↑++"(极简速记)
|
||||
- **AI 自动补充**:
|
||||
- 从画像获取:乔乔性格内向、需鼓励
|
||||
- 从历史数据:上周观望10分钟、搭建2层
|
||||
- 自动计算:观望时间减少50%,搭建层数增加50%
|
||||
- **输出**:详细版课评(AI 自动扩展为300-400字)
|
||||
|
||||
---
|
||||
|
||||
## 七、完整示例
|
||||
|
||||
### 示例1:幼儿积木课(小班)
|
||||
### 示例1:幼儿积木课(小班)- 标准版
|
||||
|
||||
**输入**:小明,4岁,小班,互锁结构搭建。专注度3分,开始时需要老师引导,后半段独立完成,最后自己加了装饰。
|
||||
|
||||
**输出**:
|
||||
|
||||
小明本节课学习了"互锁结构"——把积木像砌墙一样交错叠放,这样搭出来的墙更稳固🔍
|
||||
小明本节课学习了"互锁结构"——把积木像砌墙一样交错叠放,这样搭出来的墙更稳固,不容易倒🔍
|
||||
|
||||
本节课小明对房子主题很感兴趣,搭建环节专注投入约30分钟💪。互锁的方法听懂了,实际操作时前两块需要老师扶着手指对齐,第三块开始能自己完成✨。和上周比,本节课结构倒了没有发脾气,而是拆开重新观察了一下底座平不平,这个调整值得注意🌟
|
||||
本节课小明对房子主题表现出浓厚兴趣,搭建环节一直很投入💪。互锁的方法在导入环节就听懂了原理,但实际操作时前两块需要老师扶着手指对齐凹槽,第三块开始能独立完成,到第五块时已经能自己检查是否对齐✨。结构第一次倒了是因为底座不平,小明没有像以前那样直接推倒重来,而是拆开重新观察底座,发现左边比右边低,调整后重新搭建,这个情绪调节和问题解决能力比两周前有明显提升🌟
|
||||
|
||||
家里如果有积木,可以和孩子一起搭两堵墙,一堵直着叠、一堵交错叠,推推看哪个更稳,巩固本节课的概念🏠
|
||||
家里如果有积木,可以和孩子一起搭两堵墙,一堵直着叠、一堵交错叠,推推看哪个更稳,巩固本节课的互锁概念🏠
|
||||
|
||||
---
|
||||
*字数:198字 | 段落:3段 | Emoji:4个(第1段1个/第2段2个/第3段1个),第2段分散在段内*
|
||||
*字数:258字 | 段落:3段 | Emoji:4个(第1段1个/第2段2个/第3段1个),第2段分散在段内*
|
||||
|
||||
### 示例2:少儿编程课(小学二年级)
|
||||
**改进点**:
|
||||
- 增加过程细节(第2块→第3块→第5块的进步阶梯)
|
||||
- 增加思维描述(发现左边比右边低)
|
||||
- 增加纵向对比(两周前的情绪调节能力)
|
||||
- 保持时间模糊化("一直很投入"而非"30分钟")
|
||||
|
||||
### 示例2:少儿编程课(小学二年级)- 详细版
|
||||
|
||||
**输入**:李想,8岁,学习了循环和条件判断,程序调试了三次才成功,最后自己加了一个开始按钮。
|
||||
|
||||
@@ -269,24 +350,39 @@
|
||||
|
||||
李想本节课学习了"重复执行"(循环)和"如果碰到颜色就..."(条件判断),用这两个概念做了一个小猫走迷宫的游戏💡
|
||||
|
||||
循环的作用理解了,但第一次把循环次数设成3次,小猫走得不够远;改成10次后正常,条件判断一开始方向写反了,检查代码后发现并修正💪。导入环节对迷宫游戏很感兴趣,实践环节专注完成代码搭建,最后分享环节能说出循环的作用,本节课的编程目标顺利达成✨。和上周相比,本节课会主动给代码分区域摆放(运动放一起、外观放一起),这个整理习惯有助于后续写更复杂的程序📈
|
||||
本节课李想对迷宫游戏表现出持续兴趣,搭建环节专注投入约35分钟,全程没有分心💪。循环的作用在导入环节就理解了,第一次设置成重复3次,运行后发现小猫只走了30步就到边缘了;第二次改成5次,还是不够;第三次改成10次,成功走到迷宫出口,三次调试共用时约10分钟✨。条件判断一开始方向写反了(写的是"如果碰到边缘就停止"而不是"反弹"),李想没有直接问老师,而是先检查了代码块的颜色和文字,发现逻辑不对后自己修正💡。特别值得肯定的是,本节课遇到bug时先自己排查了约3分钟,尝试改了两个参数观察效果,最后才举手求助,展现出了很好的独立调试能力📈。分享环节能清晰说出"循环就是重复做一样的事",概念掌握扎实🎯
|
||||
|
||||
回家后可以试试给游戏加一个"开始"按钮,点击后小猫才动。需要用到"当角色被点击"事件,可以预习一下。下周我们继续🏠
|
||||
|
||||
---
|
||||
*字数:218字 | 段落:3段 | Emoji:4个(第1段1个/第2段2个/第3段1个),第2段分散在段内*
|
||||
*字数:298字 | 段落:3段 | Emoji:5个(第1段1个/第2段3个/第3段1个),第2段分散在段内*
|
||||
|
||||
### 示例3:机器人竞赛课(小学四年级)
|
||||
**改进点**:
|
||||
- 增加调试过程细节(3次调试的具体参数变化)
|
||||
- 增加错误描述("碰到边缘就停止"vs"反弹")
|
||||
- 增加排查过程(检查颜色和文字)
|
||||
- 增加时间数据(35分钟、10分钟、3分钟)
|
||||
- 增加概念复述(验证理解程度)
|
||||
|
||||
### 示例3:机器人竞赛课(小学四年级)- 详细版
|
||||
|
||||
**输入**:王浩,10岁,训练了巡线校准和新任务策略,对抗练习输了但会复盘。
|
||||
|
||||
**输出**:
|
||||
|
||||
王浩本节课训练了颜色传感器的巡线校准(重新标定白/黑值)和新的任务策略(先近后远、分段计时),主要解决之前巡线误判和策略执行拖沓的问题⚙️
|
||||
王浩本节课系统训练了颜色传感器的巡线校准和新任务策略优化,核心解决之前巡线误判(黑线识别成白色)和策略执行拖沓(近处资源块拿取超时)的问题⚙️
|
||||
|
||||
校准后巡线成功率从上次60%提升到85%,新策略执行不够果断,计划的"前30秒拿近处"实际用了45秒💪。导入环节对竞技策略话题很感兴趣,实操训练专注完成巡线调试,复盘环节能分析出问题原因,本节课的训练目标顺利达成✨。和两周前相比,遇到程序异常时不再直接重试,而是先分析可能原因(传感器/参数/结构),有针对性调整,调试效率明显提高📈
|
||||
巡线校准环节,王浩重新标定了白值(从原来的45调整到38)和黑值(从原来的12调整到8),校准后巡线成功率从上次60%(10次测试成功6次)提升到85%(20次测试成功17次),误判率明显下降💪。新策略执行环节,原计划"前30秒拿近处3个资源块",实际用了45秒只拿到2个,分析原因是机械臂展开角度偏大导致夹取时需要二次调整,下次可以优化展开角度到35度试试✨。本节课展现出了很好的系统排查能力,遇到程序异常时不再直接点击重试,而是先打开传感器数据面板查看实时读数,再检查程序逻辑,最后才调整参数,排查时间从平均3分钟缩短到1.5分钟,调试效率提升50%📈
|
||||
|
||||
周末可以用模拟器测试几种不同的时间分配方案(20+100、30+90、40+80),记录哪种得分更高,下周带数据来讨论策略优化🏠
|
||||
周末建议用模拟器测试三种时间分配方案(20+100、30+90、40+80),每种方案跑5次记录平均得分,带数据来讨论策略优化🏠
|
||||
|
||||
---
|
||||
*字数:226字 | 段落:3段 | Emoji:4个(第1段1个/第2段2个/第3段1个),第2段分散在段内*
|
||||
*字数:298字 | 段落:3段 | Emoji:4个(第1段1个/第2段2个/第3段1个),第2段分散在段内*
|
||||
|
||||
**改进点**:
|
||||
- 增加具体参数(白值45→38,黑值12→8)
|
||||
- 增加测试数据(20次测试成功17次)
|
||||
- 增加问题分析(机械臂展开角度偏大)
|
||||
- 增加解决方案(优化到35度)
|
||||
- 增加效率对比(3分钟→1.5分钟,提升50%)
|
||||
- 增加可执行的课后任务(三种方案,每种5次)
|
||||
@@ -1,8 +1,15 @@
|
||||
# 学期周数与课程主题映射规则
|
||||
|
||||
> 2026春季学期课程安排与周数计算规则
|
||||
> 学期开始:2026年3月2日(第一周)
|
||||
> 当前日期:2026年5月14日(第十一周)
|
||||
> 合并文件:周数计算 + 课程主题映射表
|
||||
> 版本:v5.0 | 更新日期:2026-05-22
|
||||
>
|
||||
> **v5.0 变更**:统一版本号体系到 v5.0;全面更新 AICODE03 课程大纲(1-21周),同步最新教学计划;更新当前周数至第12周
|
||||
> **v4.4 变更**:同步 AICODE03 第9-20周完整课程数据(来自 class-data.js);统一版本号
|
||||
> **v4.1 变更**:添加禁止"今天"使用规则,统一使用"本节课";更新当前日期
|
||||
>
|
||||
> 2026春季学期课程安排与周数计算规则
|
||||
> 学期开始:2026年3月2日(第一周)
|
||||
> 当前日期:2026年5月22日(第十二周)
|
||||
> **重要说明**:周数仅用于后端自动匹配课程主题,**课评正文不显示周数信息**
|
||||
|
||||
---
|
||||
@@ -34,6 +41,7 @@
|
||||
| 周数 | "第X周"、"本周"、"上周课"、"下周" | 课程主题名称(如"天平秤")|
|
||||
| 时间阶段 | "这学期"、"上学期"、"第几节课" | 模糊时间词(如"之前"、"最近")|
|
||||
| 课程序号 | "DISC-005"、"第5课" | 课程主题(如"天平秤")|
|
||||
| 日期表述 | "今天" | 统一使用"本节课" |
|
||||
|
||||
**后端使用 vs 前端显示对比**:
|
||||
|
||||
@@ -58,8 +66,8 @@
|
||||
| 第8周 | 4月20日 - 4月26日 | |
|
||||
| 第9周 | 4月27日 - 5月3日 | 劳动节调休 |
|
||||
| 第10周 | 5月4日 - 5月10日 | |
|
||||
| 第11周 | 5月11日 - 5月17日 | **当前周** |
|
||||
| 第12周 | 5月18日 - 5月24日 | |
|
||||
| 第11周 | 5月11日 - 5月17日 | |
|
||||
| **第12周** | **5月18日 - 5月24日** | **当前周** |
|
||||
| 第13周 | 5月25日 - 5月31日 | |
|
||||
| 第14周 | 6月1日 - 6月7日 | 儿童节 |
|
||||
| 第15周 | 6月8日 - 6月14日 | 端午节 |
|
||||
@@ -123,20 +131,31 @@
|
||||
| 第19周 | SPIKE-019 | 电子滚轮米尺 | 距离测量、数据显示、实用工具 | 数学应用、工具设计 |
|
||||
| 第20周 | SPIKE-020 | 感应道闸 | 自动识别、开关控制、安全系统 | 物联网应用、系统设计 |
|
||||
|
||||
### 2.3 AICODE03课程 - 20周完整主题
|
||||
### 2.3 AICODE03课程 - 21周完整主题
|
||||
|
||||
| 周数 | 课程代码 | 课程主题 | 核心知识点 | 能力目标 |
|
||||
|:---:|:-------:|:---------|:-----------|:---------|
|
||||
| 第1周 | AICODE03-001 | Prompt基础 | 提示词结构、AI对话、基础指令 | AI认知、沟通技巧 |
|
||||
| 第2周 | AICODE03-002 | 图像生成 | 文生图、风格描述、创意表达 | 多媒体创作、审美能力 |
|
||||
| 第3周 | AICODE03-003 | 代码辅助 | AI编程助手、代码解释、调试帮助 | 编程效率、学习能力 |
|
||||
| 第4周 | AICODE03-004 | 数据分析 | 数据处理、图表生成、结论提炼 | 数据思维、逻辑思维 |
|
||||
| **第5周** | **AICODE03-005** | **项目整合** | **多AI协作、工作流设计、成果输出** | **系统思维、项目管理** |
|
||||
| 第6周 | AICODE03-006 | 未来职业预测器 | AI工具链整合、项目开发、测试迭代 | AI协作、产品开发 |
|
||||
| 第7周 | AICODE03-007 | 超能力抽签机 | 随机算法、交互设计、视觉美化 | 编程逻辑、创意设计 |
|
||||
| **第8周** | **AICODE03-008** | **我的个人主页(上)** | **内容先行、板块化设计、自定义智能体** | **拆解力、审美力、AI协作** |
|
||||
|
||||
> 第9-20周课程主题待更新
|
||||
| 第1周 | AICODE03-001 | AI是怎么"想"的? | 概率预测原理、AI幻觉现象、提问质量影响 | 提问力、批判思维 |
|
||||
| 第2周 | AICODE03-002 | AI的记忆之谜 | 长期记忆与短期记忆、上下文窗口机制、系统提示词作用 | 提问力、拆解力 |
|
||||
| 第3周 | AICODE03-003 | AI训练师 | 系统提示词三要素、越狱与防护、迭代优化逻辑 | 提问力、共创力 |
|
||||
| 第4周 | AICODE03-004 | 我是大作家(上) | Trae Builder模式、Markdown基础、项目化思维 | 表达力、提问力 |
|
||||
| 第5周 | AICODE03-005 | 我是大作家-2 | 故事大纲设计、项目上下文、章节结构 | 表达力、拆解力 |
|
||||
| 第6周 | AICODE03-006 | 我是大作家(完结篇) | 完整书籍结构、精彩片段选择、路演技巧 | 表达力、审美力 |
|
||||
| 第7周 | AICODE03-007 | 我是大作家【小说插图】 | AI图像生成提示词工程、占位符标注、文档化管理提示词 | 表达力、审美力 |
|
||||
| 第8周 | AICODE03-008 | 我的个人主页(上) | 内容先行原则、板块化结构、Trae自定义智能体 | 拆解力、审美力 |
|
||||
| 第9周 | AICODE03-009 | 我的个人主页(下) | 交互元素设计、设计一致性、作品发布 | 审美力、表达力 |
|
||||
| 第10周 | AICODE03-010 | 魔幻俄罗斯方块(上) | Plan Mode计划模式、需求质量与输出质量、侦探模式分析 | 提问力、拆解力 |
|
||||
| 第11周 | AICODE03-011 | 魔幻俄罗斯方块(下) | 自动化测试概念、测试覆盖、增量思维 | 拆解力、共创力、韧性力 |
|
||||
| 第12周 | AICODE03-012 | 涂鸦PK(一) | 精准需求编写、新窗口审核、角色属性设计 | 拆解力、审美力 |
|
||||
| 第13周 | AICODE03-013 | 涂鸦PK(二) | 边界情况定义、独立窗口审核原则、测试脚本 | 拆解力、韧性力 |
|
||||
| 第14周 | AICODE03-014 | 涂鸦PK(三) | 游戏感Game Feel、增量需求写法、Web Audio API | 审美力、提问力 |
|
||||
| 第15周 | AICODE03-015 | 涂鸦PK(四) | 数据驱动设计、角色选择界面、路演设计决策 | 表达力、共创力 |
|
||||
| 第16周 | AICODE03-016 | Skills入门—用game-studio做跳一跳 | Skills工具箱概念、插件机制、game-studio插件、Three.js | 提问力、韧性力 |
|
||||
| 第17周 | AICODE03-017 | 期末项目开发(上) | 功能实现、代码调试、迭代优化 | 共创力、韧性力 |
|
||||
| 第18周 | AICODE03-018 | 期末项目开发(下) | 功能完善、测试验证、bug修复 | 共创力、韧性力 |
|
||||
| 第19周 | AICODE03-019 | 项目优化与美化 | UI优化、交互改进、性能提升 | 审美力、共创力 |
|
||||
| 第20周 | AICODE03-020 | 项目展示准备 | 演示文稿制作、路演排练、作品包装 | 表达力、共创力 |
|
||||
| 第21周 | AICODE03-021 | 学期成果展示 | 作品展示、成果分享、学习总结 | 表达力、综合能力 |
|
||||
|
||||
---
|
||||
|
||||
@@ -167,7 +186,7 @@
|
||||
|
||||
**课后建议模块**(自动关联主题):
|
||||
```
|
||||
在家可以用衣架和绳子做一个简易天平,比较不同玩具的重量,巩固今天的平衡概念。
|
||||
在家可以用衣架和绳子做一个简易天平,比较不同玩具的重量,巩固本节课的平衡概念。
|
||||
```
|
||||
|
||||
### 3.3 差异化表达(基于周数阶段)
|
||||
@@ -184,11 +203,11 @@
|
||||
|
||||
## 四、快速查询
|
||||
|
||||
### 4.1 当前周信息(2026年5月14日)
|
||||
- **周数**:第11周
|
||||
- **发现世界主题**:DISC-011 鳄鱼(嘴巴开合、铰链结构)
|
||||
- **SPIKE主题**:SPIKE-011 摩天轮(圆周运动、速度控制)
|
||||
- **AICODE03主题**:AICODE03-008 我的个人主页(上)(第8周,第9周后待更新)
|
||||
### 4.1 当前周信息(2026年5月22日)
|
||||
- **周数**:第12周
|
||||
- **发现世界主题**:DISC-012 数字宝箱(密码锁、数字认知、空间藏物)
|
||||
- **SPIKE主题**:SPIKE-012 直升机(螺旋桨、升力原理、飞行控制)
|
||||
- **AICODE03主题**:AICODE03-012 涂鸦PK(一)(精准需求编写、新窗口审核、角色属性设计)
|
||||
|
||||
### 4.2 输入简化格式
|
||||
教师只需提供:
|
||||
@@ -209,8 +228,11 @@
|
||||
|
||||
## 五、版本信息
|
||||
|
||||
- **版本**:v4.0
|
||||
- **更新日期**:2026-05-14
|
||||
- **版本**:v4.5
|
||||
- **更新日期**:2026-05-20
|
||||
- **适用范围**:2026春季学期全部课程
|
||||
- **维护者**:穹狼教学团队
|
||||
- **v4.0 变更**:同步课评规范V1.0 — AI03课程代码改为AICODE03(如AI03-005 → AICODE03-005);更新当前周数至第11周
|
||||
- **v4.5 变更**:全面更新 AICODE03 课程大纲(1-21周),包含AI原理、大作家系列、个人主页、俄罗斯方块、涂鸦PK、Skills入门等完整教学路径;更新当前周数至第12周
|
||||
- **v4.4 变更**:同步 AICODE03 第9-20周完整课程数据(来自 class-data.js);统一版本号至 v4.4
|
||||
- **v4.1 变更**:添加禁止"今天"使用规则,统一使用"本节课";更新当前日期至2026-05-17
|
||||
- **v4.0 变更**:同步课评规范V1.0 — AI03课程代码改为AICODE03(如AI03-005 → AICODE03-005);更新当前周数至第11周
|
||||
@@ -1,7 +1,24 @@
|
||||
# 工作流程规则:输入格式、批量生成、存储与特殊处理
|
||||
|
||||
> 合并文件:快捷输入格式 + 批量课评生成 + 新学生/补课处理 + 速记符号 + 快速入门
|
||||
> 版本:v4.0(课评规范同步版)| 更新日期:2026-05-14
|
||||
> 版本:v4.5(表单直连提交)| 更新日期:2026-05-20
|
||||
>
|
||||
> **v4.5 变更**:
|
||||
> - **表单直连提交**:网页表单填写完成后直接 POST 到本地服务器,数据自动保存为 JSON。AI 检测到信号文件后自动读取并生成课评,彻底取消「复制→粘贴回聊天」步骤
|
||||
> - 新增 `src/form_server.py` 本地表单服务器,支持动态注入班级/学生/课程数据
|
||||
> - 表单输出文件:`.claude/.tmp/evaluation_input_{班级}.json`
|
||||
> - 信号文件:`.claude/.tmp/EVALUATION_READY.txt`(AI 检测此文件触发课评生成)
|
||||
>
|
||||
> **v4.4 变更**:
|
||||
> - 课程进度自动推演:选择班级后根据**当周日期自动匹配课程主题**(基于学期周数映射表),无需参考上节课进度
|
||||
> - Form-First 模式:选择班级后默认自动创建网页表单,替代聊天文本输入框
|
||||
> - 表单直连提交:网页表单直接提交数据,无需复制粘贴回聊天
|
||||
> - 新增 `.claude/memory/project_memory.md` 项目记忆文件
|
||||
>
|
||||
> **v4.3 变更**:
|
||||
> - 新增 `/周几` 快速索引指令(`/周六`、`/周日`、`/周四` 等)
|
||||
> - 重写第14节交互式流程:B模式分开展示学生 + 独立输入区 + 快捷标记按钮
|
||||
> - 新增学生快捷标记操作(请假/体验/补课/出勤)
|
||||
>
|
||||
> **v4.0 变更**:
|
||||
> - 新增第10节「课评规范V1.0对照规则」:课程编号、目录结构、文件命名、日期匹配、完成率统计、三级查找
|
||||
@@ -49,7 +66,7 @@ AI生成 → 自动双轨保存 → 完成!
|
||||
**方式1:极简一句话**
|
||||
|
||||
```
|
||||
乔乔今天开始不敢碰,后来主动搭了三层,球卡住自己调高度,挺稳定的,比上周主动多了
|
||||
乔乔本节课开始不敢碰,后来主动搭了三层,球卡住自己调高度,挺稳定的,比上周主动多了
|
||||
```
|
||||
|
||||
**方式2:关键词速记**
|
||||
@@ -100,11 +117,11 @@ AI自动匹配班级学生名单,实时纠正谐音:
|
||||
|
||||
| 标记 | 含义 | 处理方式 | 保存位置 |
|
||||
|------|------|----------|---------|
|
||||
| 无标记 | 正式学生 | 双轨保存 | 班级汇总+个人档案 |
|
||||
| `[补课]` | 补课学生 | 自动检测档案位置,跨班级自动双轨保存 | 班级汇总+个人档案 |
|
||||
| `[体验]` | 体验课学生 | 仅班级汇总 | 班级汇总(标记体验) |
|
||||
| `[缺课]` | 今天缺席 | 记录缺席 | 班级汇总(标记缺课) |
|
||||
| `[new]` | 新学生首次 | 创建档案 | 班级汇总+个人档案 |
|
||||
| 无标记 | 正式学生 | 双轨保存 | 个人课评文件+班级汇总 |
|
||||
| `[补课]` | 补课学生 | 自动检测档案位置,跨班级自动双轨保存 | 个人课评文件(原班级侧追踪文件)+班级汇总 |
|
||||
| `[体验]` | 体验课学生 | 仅班级汇总 | 个人课评文件(补课目录)+班级汇总 |
|
||||
| `[缺课]` | 今天缺席 | 记录缺席 | 仅班级汇总 |
|
||||
| `[new]` | 新学生首次 | 创建档案 | 个人课评文件+班级汇总+学生画像 |
|
||||
|
||||
### 3.2 标记使用示例
|
||||
|
||||
@@ -134,7 +151,7 @@ AI自动匹配班级学生名单,实时纠正谐音:
|
||||
|
||||
```
|
||||
教师极简输入 → AI并行解析每个学生 → 预加载课程/档案 →
|
||||
并行生成个性化课评 → 质量检查 → 【自动双轨保存】→ 完成
|
||||
并行生成个性化课评 → 质量检查 → 【自动双轨保存】→ 【🗑️ 自动删除临时表单】→ 完成
|
||||
```
|
||||
|
||||
**预加载说明**:
|
||||
@@ -256,6 +273,168 @@ AI及自动化系统扫描 `feedback/` 目录时,通过文件名后缀判断
|
||||
| **班级总结** | `summaries/YYYYMMDD_课程编号-课次_班级反馈.md` | 班级群发文案 | 课后编写 |
|
||||
| **学生画像** | `profile.md`(固定名) | 学生基础信息 | 建档时创建 |
|
||||
|
||||
#### 班级总结文件完整模板
|
||||
|
||||
班级总结文件(`summaries/YYYYMMDD_课程编号-课次_班级反馈.md`)使用以下统一模板框架,所有班级总结一致:
|
||||
|
||||
##### 模板结构总览
|
||||
|
||||
```
|
||||
┌─ YAML Frontmatter(元数据)─────────────────────────┐
|
||||
│ class, week, course, theme, date │
|
||||
│ status: total/present/make_up/absent │
|
||||
│ students: name + status 列表 │
|
||||
├─ 标题 ────────────────────────────────────────────────┤
|
||||
│ # {班级} 第{X}周汇总 │
|
||||
├─ Quote行(课程信息)─────────────────────────────────┤
|
||||
│ > 课程代码 / 上课日期 / 课程主题 / 班级人数 │
|
||||
├─ 本周课评状态表 ──────────────────────────────────────┤
|
||||
│ | 学生 | 状态 | 类型 | 档案位置 | 操作 | │
|
||||
├─ 学生课评列表 ────────────────────────────────────────┤
|
||||
│ ## 学生课评列表 │
|
||||
│ │
|
||||
│ ### {学生名} - {类型} ✅/🔄 │
|
||||
│ **基本信息**(表现标签 + 情绪状态) │
|
||||
│ **课评内容**(代码块 ``` 包裹正文) │
|
||||
│ **教师备注**(生成时间 + 确认状态) │
|
||||
│ **教师备注**(状态 + 个人档案 + 亮点) │
|
||||
│ --- │
|
||||
│ │
|
||||
│ ### {请假学生} - ❌ 请假 │
|
||||
│ **状态**:请假,未生成课评 │
|
||||
├─ 本周班级整体情况 ────────────────────────────────────┤
|
||||
│ ## 本周班级整体情况 │
|
||||
│ ### 本周表现分布(表格) │
|
||||
│ ### 共性观察(整体表现/主题掌握/亮点/挑战) │
|
||||
│ ### 需关注学生 │
|
||||
│ ### 下周重点 │
|
||||
├─ 页脚 ────────────────────────────────────────────────┤
|
||||
│ *生成时间:{YYYY-MM-DD}* │
|
||||
└────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
##### 完整模板源码
|
||||
|
||||
```markdown
|
||||
---
|
||||
class: {班级目录名}
|
||||
week: {周数}
|
||||
course: {课程编号}
|
||||
theme: {课程主题}
|
||||
date: {YYYY-MM-DD}
|
||||
status:
|
||||
total: {总人数}
|
||||
present: {出勤人数}
|
||||
make_up: {补课人数}
|
||||
absent: {请假人数}
|
||||
students:
|
||||
- name: {学生名}
|
||||
status: present/absent/make_up
|
||||
- name: ...
|
||||
---
|
||||
|
||||
# {班级名称} 第{周数}周汇总
|
||||
|
||||
> 课程代码:{课程编号}
|
||||
> 上课日期:{YYYY-MM-DD}
|
||||
> 课程主题:{主题(知识点)}
|
||||
> 班级人数:{N}人(出勤{M}人,请假{K}人)
|
||||
|
||||
---
|
||||
|
||||
## 本周课评状态
|
||||
|
||||
| 学生 | 状态 | 类型 | 档案位置 | 操作 |
|
||||
|:-----|:----:|:----:|:---------|:----:|
|
||||
| {学生名} | ✅ 已保存 | 常规学生 | 本班 | [查看] |
|
||||
| {补课学生} | ✅ 已保存 | 补课学生 | 补课 | [查看] |
|
||||
| {请假学生} | ❌ 请假 | 常规学生 | 本班 | - |
|
||||
|
||||
---
|
||||
|
||||
## 学生课评列表
|
||||
|
||||
### {学生名} - 常规学生 ✅ / 补课学生 🔄
|
||||
|
||||
**基本信息**
|
||||
- 表现标签:{根据课评内容提炼标签,逗号分隔}
|
||||
- 情绪状态:{稳定/开心/积极/波动等}
|
||||
|
||||
**课评内容**
|
||||
|
||||
```
|
||||
{课评正文,使用代码块包裹}
|
||||
```
|
||||
|
||||
**教师备注**
|
||||
- 生成时间:{YYYY-MM-DD HH:MM}
|
||||
- 确认状态:☑️ 已确认
|
||||
|
||||
---
|
||||
|
||||
**教师备注**:
|
||||
- 状态:已保存
|
||||
- 个人档案:已同步
|
||||
- 亮点:{提炼亮点}
|
||||
|
||||
---
|
||||
|
||||
### {请假学生} - ❌ 请假
|
||||
|
||||
**状态**:请假(或停课),未生成课评
|
||||
|
||||
---
|
||||
|
||||
## 本周班级整体情况
|
||||
|
||||
### 本周表现分布
|
||||
|
||||
| 维度 | 优秀 | 良好 | 合格 | 需关注 |
|
||||
|:------|:---:|:---:|:---:|:----:|
|
||||
| 参与度 | {人数} | {人数} | {人数} | {人数} |
|
||||
| 知识点掌握 | {人数} | {人数} | {人数} | {人数} |
|
||||
| 情绪状态 | {人数} | {人数} | {人数} | {人数} |
|
||||
|
||||
### 共性观察
|
||||
1. **整体表现**:{总结}
|
||||
2. **主题掌握**:{总结}
|
||||
3. **亮点**:{总结}
|
||||
4. **挑战**:{总结}
|
||||
|
||||
### 需关注学生
|
||||
- {名单及原因}
|
||||
|
||||
### 下周重点
|
||||
1. 预告下周课程:{课程编号} {主题}
|
||||
2. 重点:{核心知识点}
|
||||
|
||||
---
|
||||
|
||||
*生成时间:{YYYY-MM-DD}*
|
||||
```
|
||||
|
||||
##### 各情况处理细则
|
||||
|
||||
| 情况 | 状态列 | 类型列 | 课评内容 |
|
||||
|:-----|:------:|:------:|:---------|
|
||||
| **常规出勤** | ✅ 已保存 | 常规学生 | 完整课评正文(代码块) |
|
||||
| **补课学生** | ✅ 已保存 | 补课学生 | 完整课评正文(代码块),基本信息如实填写 |
|
||||
| **请假** | ❌ 请假 | 常规学生 | `**状态**:请假,未生成课评` |
|
||||
| **停课** | 🚫 停课 | 停课学生 | `**状态**:已停课,不生成课评` |
|
||||
| **全部请假** | — | — | 仅保留课评状态表,学生课评列表写状态即可,共性观察处说明"本周全部请假/停课" |
|
||||
|
||||
##### 基本信息字段填写规则
|
||||
|
||||
表现标签:根据课评内容提炼3-5个关键词标签,如"积极搭建"、"圆周运动理解"、"创意改造"、"编程巩固"、"主动互动"等,体现学生本节课的核心表现亮点。
|
||||
|
||||
情绪状态:综合判断本节课的情绪基调,如"稳定"、"开心/稳定"、"积极/稳定"、"波动"等。
|
||||
|
||||
##### 代码块规范
|
||||
|
||||
每位有课评正文的学生,其课评文字必须用**代码块 ` ``` ` 包裹**(而非引用块 `>` 或纯文本),以便在 VS Code 预览时右上角显示**复制按钮**,方便一键复制。
|
||||
|
||||
请假/体验等无课评正文的学生,用 `**状态**:` 描述即可,无需代码块。
|
||||
|
||||
### 5.5 存储优先级
|
||||
|
||||
1. **第一优先级**:个人课评文件 `feedback/*.md`(必须存在,关系到完成率统计)
|
||||
@@ -283,7 +462,7 @@ Step 2(2分钟): 速记输入
|
||||
小红[补课]:专注完成 →
|
||||
|
||||
Step 3(2分钟): 查看并保存
|
||||
AI生成 → 查看质量报告 → 完成(已自动双轨保存)
|
||||
AI生成 → 查看质量报告 → 课评保存完成 → 🗑️ 自动清理表单 → 完成
|
||||
|
||||
完成!课评已自动双轨保存,无需确认。
|
||||
```
|
||||
@@ -308,10 +487,10 @@ AI生成 → 查看质量报告 → 完成(已自动双轨保存)
|
||||
```
|
||||
生成阶段 保存阶段 完成阶段
|
||||
───────── ───────── ─────────
|
||||
AI生成课评 → 【自动保存】 → 教师可随时查看/修改
|
||||
AI生成课评 → 【自动保存】 → 课评持久化保存
|
||||
↓ ↓ ↓
|
||||
质量检查通过 → feedback/YYYYMMDD_课程编号.md → 完成(无需确认)
|
||||
+ summaries/YYYYMMDD_课程编号_班级反馈.md
|
||||
质量检查通过 → feedback/YYYYMMDD_课程编号.md → 🗑️ 自动删除临时表单
|
||||
+ summaries/YYYYMMDD_课程编号_班级反馈.md → 完成(无需确认)
|
||||
```
|
||||
|
||||
**核心原则**:
|
||||
@@ -362,9 +541,9 @@ def on_evaluation_generated(student, evaluation, class_info):
|
||||
|:-----|:---------|:----------------|
|
||||
| **正式学生** | 有档案 | `.claude/memory/class/{班级}/{学生}/feedback/YYYYMMDD_课程编号-课次.md` |
|
||||
| **本班补课** | 有档案(本班) | `.claude/memory/class/{班级}/{学生}/feedback/YYYYMMDD_课程编号-课次.md` |
|
||||
| **跨班级补课** | 有档案(他班) | `.claude/memory/class/{补课班级}/补课/{学生}/feedback/YYYYMMDD_课程编号.md` |
|
||||
| **其他老师班级补课** | 有档案(其他老师) | `.claude/memory/class/{班级}/补课/{学生}/feedback/YYYYMMDD_课程编号.md` |
|
||||
| **体验/临时学生** | 无档案 | `.claude/memory/class/{班级}/补课/{学生}/feedback/YYYYMMDD_课程编号.md` |
|
||||
| **跨班级补课** | 有档案(他班) | `.claude/memory/class/{补课班级}/补课/{学生}/feedback/YYYYMMDD_课程编号-课次.md` |
|
||||
| **其他老师班级补课** | 有档案(其他老师) | `.claude/memory/class/{班级}/补课/{学生}/feedback/YYYYMMDD_课程编号-课次.md` |
|
||||
| **体验/临时学生** | 无档案 | `.claude/memory/class/{班级}/补课/{学生}/feedback/YYYYMMDD_课程编号-课次.md` |
|
||||
| **缺课学生** | 有档案 | ❌ 不生成课评 |
|
||||
|
||||
> **⚠️ 重要**:跨班级补课学生必须放在 `补课/` 目录下,否则自动化统计系统的三级查找可能无法识别。
|
||||
@@ -451,7 +630,7 @@ AI定位班级汇总中乔乔的课评
|
||||
**授课日期**: 2026-04-18
|
||||
|
||||
**课评内容**:
|
||||
学生今天课堂非常认真,三类作业全部完成。但课堂练习调试12次(2次运行错误、3次答案错误、2次编译错误),说明边界条件和代码规范性还需加强。建议每道题重新手写框架,减少复用旧代码,这样基础更扎实。
|
||||
学生本节课课堂非常认真,三类作业全部完成。但课堂练习调试12次(2次运行错误、3次答案错误、2次编译错误),说明边界条件和代码规范性还需加强。建议每道题重新手写框架,减少复用旧代码,这样基础更扎实。
|
||||
|
||||
课后整理埃氏筛法模板,记录今天的坑点。
|
||||
|
||||
@@ -473,12 +652,12 @@ AI定位班级汇总中乔乔的课评
|
||||
|
||||
#### 补课追踪模板(补课班级侧)
|
||||
|
||||
文件开头注明补课来源:
|
||||
文件开头可以注明补课来源(仅作元信息,正文不提及补课):
|
||||
|
||||
```markdown
|
||||
(补课,来自 AICODE06洋芋周日1400)
|
||||
|
||||
{正常课评内容}
|
||||
{正常课评内容,完全不提补课}
|
||||
```
|
||||
|
||||
### 7.8 失败处理机制
|
||||
@@ -599,6 +778,28 @@ students:
|
||||
| 重生成 | `重生成乔乔` | 重新生成乔乔的课评 |
|
||||
| 手动补存 | `补存` / `同步` | 手动触发待补存队列处理 |
|
||||
|
||||
### 7.12 临时文件自动清理规则
|
||||
|
||||
> 每次课评生成的输入数据文件(`.claude/.tmp/evaluation_input_*.json` 和 `EVALUATION_READY.txt` 信号文件)在课评保存完成后自动删除,避免临时数据堆积。
|
||||
|
||||
**清理时机**:课评全部保存完成后立即执行,无需用户确认
|
||||
|
||||
**清理流程**:
|
||||
```
|
||||
课评保存完成 → AI 删除 .claude/.tmp/ 下对应的 JSON 文件和信号文件 → 提示「🗑️ 已清理临时数据文件」
|
||||
```
|
||||
|
||||
**核心原则**:
|
||||
- ✅ **用完即删**:课评持久化到 `feedback/*.md` 后,临时 JSON 不再需要
|
||||
- ✅ **不丢失数据**:课评内容已保存在班级目录中,删除 JSON 不影响任何数据
|
||||
- ✅ **自动执行**:无需用户手动删除,AI 在完成阶段自动处理
|
||||
- ✅ **安全删除**:仅删除本次会话产生的临时 JSON 和信号文件
|
||||
|
||||
**例外情况**:
|
||||
- 表单 HTML 模板文件(`form_template.html`)不会被删除(是可复用的通用模板)
|
||||
- 服务器脚本(`form_server.py`)不会被删除
|
||||
- 仅删除 `.claude/.tmp/` 目录下的本次输入数据文件
|
||||
|
||||
---
|
||||
|
||||
## 八、出勤统计(嵌入班级汇总)
|
||||
@@ -787,3 +988,611 @@ students:
|
||||
- [ ] 补课学生必须有课评(放在补课班级的 `补课/学生名/feedback/` 下)
|
||||
- [ ] 编写班级总结(保存到 `summaries/YYYYMMDD_课程编号-课次_班级反馈.md`)
|
||||
- [ ] 课程编号使用标准格式(CSP/AICODE),不得使用缩写
|
||||
|
||||
---
|
||||
|
||||
## 十一、工作流程优化功能(v4.1 新增)
|
||||
|
||||
> **优化功能概述**:提升课评生成效率、数据安全性和规范一致性
|
||||
> **触发方式**:自动启用,配合 `/优化` 或相关指令使用
|
||||
> **配套技能**:keping-optimizer
|
||||
|
||||
### 11.1 三级备份机制(自动启用)
|
||||
|
||||
**功能**:防止数据丢失,提供完整恢复选项
|
||||
|
||||
**备份策略**:
|
||||
```
|
||||
第1级:直接保存到目标路径(主保存)
|
||||
└── 路径:.claude/memory/class/...
|
||||
|
||||
第2级:同时保存到 .backup/ 目录(时间戳备份)
|
||||
└── 路径:.claude/.backup/YYYYMMDD_HHMMSS_{学生}.md
|
||||
|
||||
第3级:写入前备份现有文件(防止覆盖)
|
||||
└── 路径:原文件路径 + .md.bak
|
||||
```
|
||||
|
||||
**恢复功能**:
|
||||
- 指令:`/恢复 {学生}` → 列出该学生的所有备份版本
|
||||
- 指令:`/恢复备份` → 恢复最近一次备份
|
||||
- 指令:`/清理备份` → 清理超过7天的旧备份
|
||||
|
||||
### 11.2 自动补全缺失信息(自动启用)
|
||||
|
||||
**功能**:教师只需输入核心表现,系统自动补全日期、课程编号、课次
|
||||
|
||||
**自动补全规则**:
|
||||
| 信息项 | 补全规则 | 默认值 |
|
||||
|--------|---------|--------|
|
||||
| **日期** | 取当天日期,格式YYYYMMDD | 20260516 |
|
||||
| **课程编号** | 根据班级名称自动匹配 | 如AICODE03-01 |
|
||||
| **课次** | 根据学期周数自动计算 | 第11周 = 课次11 |
|
||||
| **课程主题** | 根据课程代码+周数自动匹配 | 如"蜥蜴" |
|
||||
|
||||
**输入示例**:
|
||||
```
|
||||
极简输入:
|
||||
/课评 班级:发现世界-周四19点
|
||||
乔乔:gj5→zd3→zt ↑++
|
||||
|
||||
自动补全后:
|
||||
日期:20260516
|
||||
班级:发现世界-周四19点
|
||||
课程编号:DISC-011
|
||||
课次:第11课
|
||||
课程主题:蜥蜴
|
||||
```
|
||||
|
||||
### 11.3 路径自动创建(自动启用)
|
||||
|
||||
**功能**:自动创建不存在的目录结构,避免保存失败
|
||||
|
||||
**自动创建的目录结构**:
|
||||
```
|
||||
.claude/memory/class/
|
||||
├── {班级名称}/
|
||||
│ ├── summaries/ ← 自动创建
|
||||
│ ├── {学生姓名}/
|
||||
│ │ └── feedback/ ← 自动创建
|
||||
│ └── 补课/
|
||||
│ └── {学生姓名}/
|
||||
│ └── feedback/ ← 自动创建
|
||||
└── .backup/ ← 自动创建
|
||||
```
|
||||
|
||||
### 11.4 速记符号自动补全(输入时提示)
|
||||
|
||||
**功能**:输入速记符号时实时提示含义,Tab键自动补全
|
||||
|
||||
**速记符号速查表**:
|
||||
| 符号 | 含义 | 完整描述 |
|
||||
|------|------|---------|
|
||||
| `gj` | 观望 | gj5=观望5分钟 |
|
||||
| `zd` | 主动搭 | zd3=主动搭3层 |
|
||||
| `zt` | 自己调整 | 球卡住时自己调整高度 |
|
||||
| `wb` | 完成 | 独立完成搭建 |
|
||||
| `zx` | 专注 | zx15=专注15分钟 |
|
||||
| `sb` | 失败后调整 | sb2=失败2次后成功 |
|
||||
| `ts` | 探索 | ts5=探索5分钟 |
|
||||
| `cz` | 创造 | cz3=3种创意方案 |
|
||||
| `wt` | 提问 | wt3=提问3次 |
|
||||
| `hz` | 合作 | 合作完成 |
|
||||
| `fx` | 分享 | 分享想法/作品 |
|
||||
|
||||
**自动补全交互示例**:
|
||||
```
|
||||
教师输入:乔乔:gj
|
||||
系统提示:
|
||||
├─ gj3 → 观望3分钟
|
||||
├─ gj5 → 观望5分钟
|
||||
└─ gj10 → 观望10分钟
|
||||
教师按Tab键:→ gj5
|
||||
```
|
||||
|
||||
### 11.5 实时校验提醒(保存前检查)
|
||||
|
||||
**功能**:保存前自动检查规范,提前发现问题
|
||||
|
||||
**校验清单**:
|
||||
| 检查项 | 规范要求 |
|
||||
|--------|---------|
|
||||
| **课程编号** | CSP/AICODE前缀,不是C++/AI |
|
||||
| **日期格式** | YYYYMMDD格式 |
|
||||
| **目录结构** | 完整路径存在 |
|
||||
| **文件命名** | 符合规范要求 |
|
||||
| **课评正文** | 不提及"补课"等词 |
|
||||
| **字数范围** | 180-350字 |
|
||||
|
||||
**校验指令**:
|
||||
- `/检查` → 检查本周所有课评
|
||||
- `/检查 {班级}` → 检查指定班级课评
|
||||
|
||||
### 11.6 智能班级预加载(开始工作时)
|
||||
|
||||
**功能**:根据输入的星期几快速预加载对应班级,并展示每个班级的学生名单
|
||||
|
||||
**快捷指令**:
|
||||
| 指令 | 功能 |
|
||||
|------|------|
|
||||
| **`/周几`** | **按上课日快速索引(推荐)**,如 `/周六`、`/周日`、`/周四` |
|
||||
| `/今天` | 自动判断当天星期几并加载对应班级 |
|
||||
| `/本周` | 选择本周班级列表 |
|
||||
| `/模板 {班级}` | 加载班级学生名单模板 |
|
||||
|
||||
**/周几 输出格式示例**(以 /周六 为例,其他上课日同理):
|
||||
```
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
📅 今天是 2026-05-16(周六)
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
|
||||
班级 1:发现世界-周六09点(DISC)
|
||||
├─ 学生名单:乔乔、昊昊、小明、小红
|
||||
└─ [选择此班级]
|
||||
|
||||
班级 2:Wedo创造世界-周六1030(CREATE)
|
||||
├─ 学生名单:小强、小芳、小华
|
||||
└─ [选择此班级]
|
||||
|
||||
班级 3:AICODE03小Q周六1400(AICODE03)
|
||||
├─ 学生名单:李明、王芳、张伟、刘洋
|
||||
└─ [选择此班级]
|
||||
|
||||
班级 4:Wedo创造世界-周六16点(CREATE)
|
||||
├─ 学生名单:赵磊、孙悦、周杰
|
||||
└─ [选择此班级]
|
||||
|
||||
班级 5:发现世界-周六19点(DISC)
|
||||
├─ 学生名单:陈静、杨帆、黄欣
|
||||
└─ [选择此班级]
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
|
||||
操作:点击 [选择此班级] 或直接输入班级名称
|
||||
```
|
||||
|
||||
### 11.7 批量处理优化
|
||||
|
||||
**并行生成+逐份实时保存**:
|
||||
```
|
||||
教师输入5个学生 → 系统并行生成
|
||||
→ 乔乔课评生成完成 → 立即保存 ✅
|
||||
→ 昊昊课评生成完成 → 立即保存 ✅
|
||||
→ 其他继续...
|
||||
```
|
||||
|
||||
**批量修改工具**:
|
||||
- `/批量修改 {查找}→{替换}` → 批量替换本周所有课评内容
|
||||
- `/批量添加 {内容}` → 批量在课评结尾添加内容
|
||||
|
||||
### 11.8 待修复列表功能
|
||||
|
||||
**位置**:`.claude/.tasks/fix-list-YYYYMMDD.md`
|
||||
|
||||
**查看与修复**:
|
||||
- 指令:`/修复` → 展示待修复列表,逐个处理或批量自动修复
|
||||
|
||||
---
|
||||
|
||||
## 十二、快捷指令完整列表
|
||||
|
||||
### 班级选择
|
||||
| 指令 | 功能 |
|
||||
|------|------|
|
||||
| **`/周几`** | **按上课日快速索引(推荐)**,如 `/周六`、`/周日`、`/周四` |
|
||||
| `/今天` | 自动判断当天星期几并加载对应班级 |
|
||||
| `/本周` | 选择本周班级列表 |
|
||||
| `/班级 {班级名}` | 手动选择指定班级 |
|
||||
|
||||
### 模式切换
|
||||
| 指令 | 功能 |
|
||||
|------|------|
|
||||
| `/交互式` | 启用交互式课评生成模式(默认,Form-First 网页表单) |
|
||||
| `/批量` | 启用批量输入模式 |
|
||||
|
||||
### 模板工具
|
||||
| 指令 | 功能 |
|
||||
|------|------|
|
||||
| `/模板 {班级}` | 加载班级学生名单模板 |
|
||||
| `/空模板` | 创建空模板 |
|
||||
|
||||
### 批量操作
|
||||
| 指令 | 功能 |
|
||||
|------|------|
|
||||
| `/批量修改 {查找}→{替换}` | 批量替换课评内容 |
|
||||
| `/批量添加 {内容}` | 批量在课评结尾添加内容 |
|
||||
|
||||
### 数据恢复
|
||||
| 指令 | 功能 |
|
||||
|------|------|
|
||||
| `/恢复 {学生}` | 恢复该学生的备份 |
|
||||
| `/恢复备份` | 恢复最近一次备份 |
|
||||
| `/清理备份` | 清理过期备份文件 |
|
||||
|
||||
### 校验检查
|
||||
| 指令 | 功能 |
|
||||
|------|------|
|
||||
| `/检查` | 检查本周课评是否符合规范 |
|
||||
| `/检查 {班级}` | 检查指定班级课评 |
|
||||
|
||||
### 保存与补存
|
||||
| 指令 | 功能 |
|
||||
|------|------|
|
||||
| `/补存` | 尝试重新保存失败的课评 |
|
||||
| `/学生 {姓名}` | 查看学生档案和历史课评 |
|
||||
|
||||
### 修复工具
|
||||
| 指令 | 功能 |
|
||||
|------|------|
|
||||
| `/修复` | 处理待修复列表中的项目 |
|
||||
|
||||
---
|
||||
|
||||
## 十三、高效课后完整工作流程示例
|
||||
|
||||
> 以下流程适用于所有上课日(周一~周日),以周六为例展示
|
||||
|
||||
### Step 1:智能预加载班级
|
||||
```
|
||||
教师:/周六(或 /今天)
|
||||
→ 显示周六所有班级 + 学生名单 + 当周课程主题:
|
||||
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
📅 今天是 2026-05-16(周六,第11周)
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
|
||||
班级 1:发现世界-周六09点(DISC)
|
||||
├─ 学生名单:乔乔、昊昊、小明、小红
|
||||
├─ 当周课程:DISC-011 蜥蜴 ✅
|
||||
└─ [选择此班级]
|
||||
|
||||
班级 2:Wedo创造世界-周六1030(CREATE)
|
||||
├─ 学生名单:小强、小芳、小华
|
||||
├─ 当周课程:CREATE-011 推磨机器人 ✅
|
||||
└─ [选择此班级]
|
||||
|
||||
...
|
||||
```
|
||||
|
||||
### Step 2:选择班级 → 自动匹配当周课程 + 启动表单服务器
|
||||
```
|
||||
教师:1(或 发现世界-周六09点)
|
||||
→ 系统根据日期自动匹配当周课程主题 → 启动本地表单服务器
|
||||
|
||||
🖥️ 本地服务器已启动!
|
||||
👉 请打开浏览器:http://localhost:8088/form?class=发现世界-周六09点&week=11&course=DISC-011&theme=鳄鱼&date=2026-05-16
|
||||
(表单已预填班级、周数、课程、学生名单)
|
||||
|
||||
也可在聊天中直接输入(备选):
|
||||
乔乔:gj5→zd3→zt ↑++
|
||||
昊昊:慢热→zd3→反复调 →
|
||||
```
|
||||
|
||||
### Step 3:网页表单填写 + 直连提交
|
||||
```
|
||||
教师打开表单 →
|
||||
├─ 乔乔:勾选「出勤」→ 输入 gj5→zd3→zt ↑++
|
||||
├─ 昊昊:勾选「出勤」→ 输入 慢热→zd3→反复调 →
|
||||
├─ 小明:勾选「请假」
|
||||
├─ 🔄 补课学生:点「+添加临时学生」→ 输入姓名 → 勾选「补课」→ 输入表现
|
||||
└─ 点击「🚀 提交并保存」
|
||||
|
||||
→ 数据自动 POST 到本地服务器
|
||||
→ 服务器保存为 .claude/.tmp/evaluation_input_发现世界-周六09点.json
|
||||
→ 写入信号文件 .claude/.tmp/EVALUATION_READY.txt
|
||||
→ 表单显示「✅ 已保存 — 可关闭此页面」
|
||||
```
|
||||
|
||||
### Step 4:AI 自动检测 → 生成并双轨保存
|
||||
```
|
||||
→ AI 检测到 EVALUATION_READY.txt 信号文件
|
||||
→ 读取 JSON 数据 → 解析学生/状态/表现
|
||||
→ 生成乔乔课评 → 自动保存 ✅
|
||||
→ 生成昊昊课评 → 自动保存 ✅
|
||||
→ 小明标记为请假 → 记录到班级汇总
|
||||
```
|
||||
|
||||
### Step 5:实时校验提醒
|
||||
```
|
||||
✅ 乔乔:全部通过
|
||||
⚠️ 昊昊:课程编号不规范,建议改为DISC-011
|
||||
→ 教师确认修改 → 自动修复后保存
|
||||
```
|
||||
|
||||
### Step 6:检查待修复
|
||||
```
|
||||
教师:/修复
|
||||
→ 查看待修复列表,处理剩余项目
|
||||
```
|
||||
|
||||
### Step 7:完成!
|
||||
```
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
✅ 全部完成!
|
||||
已保存学生:2人
|
||||
已备份文件:4份(主文件+备份)
|
||||
待修复项目:0项
|
||||
🗑️ 已自动清理临时表单文件
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 十四、交互式课评生成流程(v4.5 直连提交版)
|
||||
|
||||
> **核心理念**:通过 /周几 快速索引 → 启动本地表单服务器 → 浏览器填写直连提交 → AI 自动检测生成
|
||||
> **适用场景**:课后按班级处理,交互友好,高效批量,无需粘贴
|
||||
> **适用范围**:本流程适用于所有上课日(`/周一`~`/周日`),以下以 `/周六` 为例展示
|
||||
> **v4.5 优化**:表单直连提交 — 数据 POST 到本地服务器,AI 通过信号文件自动触发,彻底取消复制粘贴
|
||||
|
||||
### 完整流程
|
||||
|
||||
```
|
||||
Step 1: 启动 → 输入 /周几(如 /周六、/周四,按当天上课日快速索引)
|
||||
↓
|
||||
Step 2: 展示该时段班级列表(附带当周课程主题)
|
||||
↓
|
||||
Step 3: 选择班级 → 自动匹配当周课程 → 启动表单服务器
|
||||
↓
|
||||
Step 4: 打开浏览器表单 → 填写学生表现 → 点击「提交并保存」
|
||||
↓ (数据 POST 到本地服务器,保存为 JSON + 写入信号文件)
|
||||
Step 5: AI 检测信号文件 → 读取 JSON → 批量生成课评 → 双轨保存
|
||||
↓
|
||||
Step 6: 🗑️ 自动删除临时文件 → 完成
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Step 1: 启动 — 快速索引
|
||||
|
||||
**输入指令**(支持两种方式):
|
||||
|
||||
| 指令 | 适用场景 | 示例 |
|
||||
|:-----|:---------|:-----|
|
||||
| **`/周几`** | 按上课日快速查找(**推荐**) | `/周六`、`/周日`、`/周四` |
|
||||
| `/今天` | 自动判断当天是周几 | `/今天`(自动换算为当天对应周几) |
|
||||
|
||||
**工作日对照表**(系统自动根据班级目录匹配):
|
||||
|
||||
| 指令 | 匹配班级示例 |
|
||||
|:-----|:-------------|
|
||||
| `/周一`~`/周三` | 按需显示 |
|
||||
| `/周四` | 发现世界-周四19点 |
|
||||
| `/周五` | AICODE03小Q周五1900 |
|
||||
| `/周六` | 发现世界-周六09点、Wedo创造世界-周六1030、AICODE03小Q周六1400 等 |
|
||||
| `/周日` | 发明世界-周日14点、SPIKE02-周日1030、发现世界-周日下午16点 等 |
|
||||
|
||||
**系统响应**(以教师输入 `/周六` 为例):
|
||||
|
||||
```
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
📅 周六(2026-05-16)的课程
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
|
||||
班级 1:发现世界-周六09点(DISC)
|
||||
├─ 学生数:4人(乔乔、昊昊、小明、小红)
|
||||
└─ [选择此班级]
|
||||
|
||||
班级 2:Wedo创造世界-周六1030(CREATE)
|
||||
├─ 学生数:3人(小强、小芳、小华)
|
||||
└─ [选择此班级]
|
||||
|
||||
班级 3:AICODE03小Q周六1400(AICODE03)
|
||||
├─ 学生数:4人(李明、王芳、张伟、刘洋)
|
||||
└─ [选择此班级]
|
||||
|
||||
班级 4:Wedo创造世界-周六16点(CREATE)
|
||||
├─ 学生数:3人(赵磊、孙悦、周杰)
|
||||
└─ [选择此班级]
|
||||
|
||||
班级 5:发现世界-周六19点(DISC)
|
||||
├─ 学生数:3人(陈静、杨帆、黄欣)
|
||||
└─ [选择此班级]
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
|
||||
请回复班级序号或名称来选择班级(如:1 或 发现世界-周六09点)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Step 2: 选择班级 → 自动匹配当周课程 + 启动服务器
|
||||
|
||||
> ⚠️ **重要**:以下流程适用于所有上课日。选择任何班级后,系统均自动根据**当周日期匹配课程主题** + 启动本地表单服务器。
|
||||
|
||||
**教师输入**(任选一种):
|
||||
```
|
||||
1
|
||||
```
|
||||
或
|
||||
```
|
||||
发现世界-周六09点
|
||||
```
|
||||
|
||||
**系统响应** — 自动加载课程信息 + 匹配当周课程 + 启动服务器:
|
||||
|
||||
```
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
✅ 已选择班级:发现世界-周六09点(DISC)
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
|
||||
📚 课程信息:
|
||||
├─ 课程编号:DISC-011
|
||||
├─ 课程主题:鳄鱼(第11周自动匹配)
|
||||
├─ 核心知识点:嘴巴开合、铰链结构、咬合功能
|
||||
├─ 日期:20260516
|
||||
|
||||
👨👩👧👦 学生:乔乔、昊昊、小明、小红(共4人)
|
||||
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
🖥️ 启动本地表单服务器...
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
|
||||
👉 请打开浏览器填写表单:
|
||||
http://localhost:8088/form?class=发现世界-周六09点&week=11&course=DISC-011&theme=鳄鱼&date=2026-05-16
|
||||
|
||||
(表单已自动填入班级信息、学生名单和课程主题)
|
||||
|
||||
也可在聊天中直接输入文本(备选模式B):
|
||||
乔乔:gj5→zd3→zt ↑++
|
||||
昊昊:慢热→zd3→反复调 →
|
||||
...
|
||||
```
|
||||
|
||||
**课程自动匹配逻辑**:
|
||||
1. 根据当前日期计算学期周数(基于3月2日学期开始)
|
||||
2. 根据周数直接匹配课程代码和主题(参见 `15-semester-weeks.md` 映射表)
|
||||
3. **不参考上节课进度**,直接使用当周实际课程主题
|
||||
4. 仅当教师特别说明补课时,才手动调整课程主题
|
||||
|
||||
**特殊情况处理**:
|
||||
- 若当周为补课(教师明确说明),可手动选择补课主题
|
||||
- 若无特殊说明,一律使用当周标准课程主题
|
||||
|
||||
---
|
||||
|
||||
### Step 3: 网页表单填写(直连提交模式)
|
||||
|
||||
> 选择班级后系统自动启动本地服务器,表单通过 URL 参数传入班级/学生/课程信息。
|
||||
> 教师在浏览器中填写表现,点击「提交并保存」后数据直接 POST 到服务器。
|
||||
|
||||
**表单内容示例**(自动生成,含学生画像摘要):
|
||||
|
||||
```
|
||||
┌────────────────────────────────────────┐
|
||||
│ 📝 Wedo创造世界-周六1030 课评输入表 │
|
||||
│ CREATE-011 · 推磨机器人 · 2026-05-16 │
|
||||
├────────────────────────────────────────┤
|
||||
│ 📊 填写进度:████████░░ 3/6 人 │
|
||||
│ │
|
||||
│ ┌─ ① 梁家铭 🧒 ─────────────────┐ │
|
||||
│ │ 📋 需鼓励建立自信... │ │
|
||||
│ │ 状态:[✅出勤] [🚫请假] │ │
|
||||
│ │ 表现:______________________ │ │
|
||||
│ │ (速记: gj#观望/zd#搭#层/zt调整) │ │
|
||||
│ └────────────────────────────────┘ │
|
||||
│ │
|
||||
│ ┌─ ② 简思瑜 🧒 ─────────────────┐ │
|
||||
│ │ 📋 自信主动,结构搭建极坚固... │ │
|
||||
│ │ 状态:[✅出勤] [🚫请假] │ │
|
||||
│ │ 表现:______________________ │ │
|
||||
│ └────────────────────────────────┘ │
|
||||
│ ... │
|
||||
│ ┌─ + 添加临时学生 ──────────────┐ │
|
||||
│ │ 姓名:[____] 状态:[补课/体验] │ │
|
||||
│ └────────────────────────────────┘ │
|
||||
│ │
|
||||
│ [🚀 提交并保存] │
|
||||
└────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
**填写方式**(二选一):
|
||||
|
||||
| 方式 | 操作 | 适用场景 |
|
||||
|:----|:-----|:---------|
|
||||
| **A. 网页直连提交(推荐)** | 打开浏览器链接 → 填写 → 点击「提交并保存」→ 数据自动 POST 到服务器 | 常规使用 |
|
||||
| **B. 聊天文本输入** | 在聊天中直接输入多行文本 | 快速处理、数据量少 |
|
||||
|
||||
**方式A:网页直连提交流程**:
|
||||
```
|
||||
1. 打开系统提供的表单链接(URL 已包含班级/周数/课程/学生)
|
||||
2. 为每位学生选择状态(出勤/请假/补课/体验)
|
||||
3. 在文本框中填写表现(支持速记 + 自然语言混合)
|
||||
4. 点击「🚀 提交并保存」
|
||||
5. 看到「✅ 提交成功」提示 → 可关闭页面
|
||||
6. AI 自动检测信号文件 → 生成课评 → 双轨保存
|
||||
```
|
||||
|
||||
**方式B:聊天文本输入(备选)**:
|
||||
```
|
||||
乔乔:gj5→zd3→zt ↑++
|
||||
昊昊:慢热→zd3→反复调 →
|
||||
小明 体验
|
||||
小红:搭了3层,开心 ↑
|
||||
```
|
||||
|
||||
### Step 4: AI 自动检测信号 + 批量生成并保存
|
||||
|
||||
**触发方式**:表单提交后服务器写入 `.claude/.tmp/EVALUATION_READY.txt` 信号文件,AI 检测到后自动处理。
|
||||
|
||||
**系统执行**:
|
||||
```
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
🔔 检测到新提交的表单数据
|
||||
班级:发现世界-周六09点 | DISC-011 鳄鱼
|
||||
学生:4人(3人出勤,1人请假)
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
|
||||
🚀 开始批量生成课评...
|
||||
|
||||
[1/3] 生成乔乔课评... ✅ 已保存
|
||||
[2/3] 生成昊昊课评... ✅ 已保存
|
||||
[3/3] 生成小红课评... ✅ 已保存
|
||||
📝 小明标记为请假,不生成课评
|
||||
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
✅ 全部完成!
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
|
||||
已保存:3人 | 请假:1人
|
||||
├─ 班级总结:summaries/20260516_DISC-011_班级反馈.md
|
||||
└─ 个人课评:乔乔/、昊昊/、小红/
|
||||
🗑️ 已清理临时信号文件
|
||||
|
||||
下一步:
|
||||
- 继续下一个班级 → 输入 /周几
|
||||
- 查看班级总结 → [查看总结]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 快捷操作速查
|
||||
|
||||
| 操作 | 输入格式 | 效果 |
|
||||
|:-----|:---------|:------|
|
||||
| **标记请假** | `{学生} 请假` | 标记缺课,不生成课评 |
|
||||
| **标记体验** | `{学生} 体验` | 体验标记,仅存班级汇总 |
|
||||
| **标记补课** | `{学生} 补课` | 补课标记,跨班级自动保存 |
|
||||
| **恢复出勤** | `{学生} 出勤` | 取消特殊标记,恢复默认出勤 |
|
||||
| **修改已填** | `修改{学生}:新内容` | 替换该学生已填表现 |
|
||||
| **添加临时学生** | `添加{姓名}` | 添加到列表末尾 |
|
||||
| **批量生成** | `全部生成` | 一次性生成所有已填课评 |
|
||||
| **查看汇总** | `查看汇总` | 查看当前已填写的所有学生 |
|
||||
|
||||
**标记使用示例**:
|
||||
```
|
||||
# 批量填写带标记
|
||||
乔乔:gj5→zd3→zt ↑++
|
||||
昊昊:慢热→zd3→反复调 →
|
||||
小明 体验
|
||||
小红 请假
|
||||
小华[补课]:专注完成,情绪稳定 ↑
|
||||
|
||||
# 修改已填表现
|
||||
修改乔乔:gj5→zd3↑↑
|
||||
|
||||
# 调整学生标记
|
||||
小明 出勤(恢复为正式学生)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 十五、工作流模式选择
|
||||
|
||||
### 两种模式对比
|
||||
|
||||
| 模式 | 特点 | 适用场景 |
|
||||
|------|------|---------|
|
||||
| **交互式模式** | `/周几` 快速索引 + Form-First 网页表单(含补课/体验区)+ 一键提交 | 课后按班级处理,高效友好 |
|
||||
| **批量输入模式** | 一次性输入所有学生 | 已有记录,速度优先 |
|
||||
|
||||
### 模式切换
|
||||
|
||||
```
|
||||
/交互式 → 启用交互式模式(默认)
|
||||
/批量 → 启用批量输入模式
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
*版本:v4.5(表单直连提交 — 取消复制粘贴,数据直通 AI)*
|
||||
*最后更新:2026-05-20*
|
||||
*优化技能:keping-optimizer*
|
||||
|
||||
@@ -1,7 +1,10 @@
|
||||
# 速记符号系统
|
||||
|
||||
> 从 20-workflow.md 拆分,专注速记符号定义与使用规则
|
||||
> 版本:v3.1 | 更新日期:2026-05-05
|
||||
> 版本:v4.5 | 更新日期:2026-05-20
|
||||
>
|
||||
> **v4.5 变更**:表单直连提交 — 取消复制粘贴,版本号同步
|
||||
> **v4.4 变更**:统一版本号至 v4.4;更新日期
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,7 +1,12 @@
|
||||
# 学生特殊处理:补课、新学生、转正
|
||||
|
||||
> 从 20-workflow.md 拆分,专注补课/体验/新学生/转正规则
|
||||
> 版本:v4.0 | 更新日期:2026-05-14
|
||||
> 版本:v4.5 | 更新日期:2026-05-20
|
||||
>
|
||||
> **v4.5 变更**:简化补课存储规则 — 取消补课专用目录和双向记录,补课记录统一保存在学生原班级,文件名加 `_补课` 后缀
|
||||
> **v4.4 变更**:统一版本号至 v4.4;更新日期
|
||||
> **v4.2 变更**:统一禁用"今天";删除示例中禁止的时间表述
|
||||
> **v4.1 变更**:新增表单补课区入口说明 — 补课/体验学生可通过网页表单的「补课/体验学生区」录入
|
||||
>
|
||||
> **v4.0 变更**:同步课评规范V1.0 — 新增补课双向记录规则;更新存储路径为 `.claude/memory/class/` 标准结构;新增补课目录 `补课/` 专用路径
|
||||
|
||||
@@ -11,12 +16,15 @@
|
||||
|
||||
### 1.1 核心规则
|
||||
|
||||
**绝对禁止**:课评正文中绝对不能提及学生来补课相关内容。
|
||||
**录入入口**:补课/体验学生可通过 [网页表单的「补课/体验学生区」](20-workflow.md#step-3-网页表单填写form-first-模式) 录入(选择班级后自动创建),也可在聊天中直接输入 `姓名 [补课]` 格式。
|
||||
|
||||
**绝对禁止**:课评正文(给家长看的部分)绝对不能提及学生来补课相关内容。
|
||||
|
||||
- ❌ 禁止出现"补课"、"补课上"、"来补课"、"本次补课"
|
||||
- ❌ 禁止暗示学生非正常上课("今天特别来参加"、"临时加入"、"从其他班级过来")
|
||||
- ❌ 禁止暗示学生非正常上课("本节课特别来参加"、"临时加入"、"从其他班级过来")
|
||||
- ✅ 课评正文完全按正常学生撰写
|
||||
- ✅ `[补课]`标记仅用于后台档案管理
|
||||
- ✅ 文件开头元信息可以标注补课来源(如"(补课,来自 AICODE06洋芋周日1400)"),不影响家长阅读的正文内容
|
||||
|
||||
**示例**:
|
||||
|
||||
@@ -29,10 +37,10 @@
|
||||
|
||||
课评输出(错误):
|
||||
小红本节课作为补课学生,学习了"旋转飞机"... ❌
|
||||
小红今天来补课,学习了"旋转飞机"... ❌
|
||||
小红来补课,学习了"旋转飞机"... ❌
|
||||
```
|
||||
|
||||
### 1.2 补课学生分类处理
|
||||
### 1.2 补课学生分类处理(v4.5更新)
|
||||
|
||||
**情况A:自己班级的学生补课**
|
||||
- **判断**:学生在 `.claude/memory/class/{当前班级}/` 目录中存在
|
||||
@@ -40,9 +48,10 @@
|
||||
|
||||
**情况B:跨班级补课(档案在其他班级)**
|
||||
- **判断**:学生在 `.claude/memory/class/{其他班级}/` 目录中存在
|
||||
- **处理**:自动跨班级保存(课评规范标准)
|
||||
- ✅ 课评文件保存到补课班级的 `补课/{学生名}/feedback/YYYYMMDD_课程编号.md`
|
||||
- ✅ 原班级侧生成补课追踪文件 `feedback/YYYYMMDD_课程编号-课次(补课-去班级名).md`
|
||||
- **处理**:课评文件保存到学生原班级的 `feedback/YYYYMMDD_课程编号-课次_补课.md`
|
||||
- ✅ 文件名加 `_补课` 后缀,一眼识别
|
||||
- ✅ 文件内容开头标注补课信息(补课时间、补课班级)
|
||||
- ✅ 课评正文正常撰写,不提及补课
|
||||
- **无需询问,自动完成**
|
||||
|
||||
**情况C:其他老师班级补课学生**
|
||||
@@ -51,7 +60,7 @@
|
||||
- [1] 保存到补课班级的 `补课/{学生名}/feedback/`(仅班级记录)
|
||||
- [2] 创建新档案(在本班建立 `profile.md`)
|
||||
|
||||
### 1.3 跨班级补课示例
|
||||
### 1.3 跨班级补课示例(v4.5更新)
|
||||
|
||||
```
|
||||
教师输入:班级:发现世界-周六09点,林瀚丞[补课]:积极分析课程任务,专注完成了绿色身体、黑色头部的蜥蜴设计
|
||||
@@ -62,11 +71,14 @@ AI检测:
|
||||
|
||||
判断:跨班级补课学生(原班级周四19点,补课班级周六09点)
|
||||
|
||||
自动处理(课评规范标准):
|
||||
→ 补课班级侧:保存到「补课/林瀚丞/feedback/YYYYMMDD_DISC-008.md」
|
||||
(内容开头注明"(补课,来自 发现世界-周四19点)")
|
||||
→ 原班级侧:保存到「林瀚丞/feedback/YYYYMMDD_DISC-008(补课-去发现世界-周六09点).md」
|
||||
(简要记录补课去向)
|
||||
自动处理(v4.5简化规则):
|
||||
→ 保存到原班级:「林瀚丞/feedback/YYYYMMDD_DISC-008_补课.md」
|
||||
文件内容开头标注:
|
||||
- 课程代码:DISC-008
|
||||
- 课程主题:蜥蜴
|
||||
- 补课班级:发现世界-周六09点
|
||||
- 补课时间:周日 09:00
|
||||
(正文正常撰写,不提及补课)
|
||||
```
|
||||
|
||||
---
|
||||
@@ -116,32 +128,90 @@ AI检测:
|
||||
|
||||
---
|
||||
|
||||
## 四、课评规范V1.0补课记录要求
|
||||
## 四、补课存储规则(v4.5更新)
|
||||
|
||||
### 4.1 补课目录结构
|
||||
### 4.1 新规则核心变更
|
||||
|
||||
| 版本 | 存储方式 | 说明 |
|
||||
|------|---------|------|
|
||||
| v4.4及以前 | 双向记录 + 补课专用目录 | 原班级和补课班级各存一份,创建`补课/`目录 |
|
||||
| **v4.5** | **单记录 + 原班级保存** | **只保存在学生原班级,文件名加`_补课`后缀** |
|
||||
|
||||
### 4.2 v4.5存储结构
|
||||
|
||||
```
|
||||
.claude/memory/class/{学生原班级}/
|
||||
├── 学生姓名/
|
||||
│ ├── profile.md
|
||||
│ ├── summary/
|
||||
│ │ └── 成长素材.md
|
||||
│ └── feedback/
|
||||
│ ├── 20260419_DISC-007.md ← 正常上课
|
||||
│ ├── 20260505_DISC-009_补课.md ← 补课记录(文件名加后缀)
|
||||
│ └── 20260509_DISC-010(请假).md
|
||||
```
|
||||
|
||||
### 4.3 补课文件格式
|
||||
|
||||
**文件名**:`YYYYMMDD_课程编号-课次_补课.md`
|
||||
|
||||
**文件内容**:
|
||||
```markdown
|
||||
# DISC-009 课评
|
||||
|
||||
**日期**: 2026-05-05
|
||||
|
||||
**课评内容**:
|
||||
|
||||
- 课程代码:DISC-009
|
||||
- 课程主题:机器人瓦力
|
||||
- 补课班级:周日9:00(补课班级)
|
||||
- 原班级:发现世界-周六09点
|
||||
|
||||
嘉铭本节课学习了"机器人瓦力"...
|
||||
(正文正常撰写,不提及补课)
|
||||
|
||||
**教师备注**:
|
||||
- 亮点:
|
||||
- 需关注:
|
||||
- 确认状态:☑ 已确认(2026-05-05)
|
||||
```
|
||||
|
||||
### 4.4 规则优势
|
||||
|
||||
- ✅ **学生所有记录在一个文件夹**:方便查看完整学习轨迹
|
||||
- ✅ **一眼识别补课记录**:通过 `_补课` 后缀区分
|
||||
- ✅ **避免临时班级目录**:不再创建 `周日9点` 等补课专用班级
|
||||
- ✅ **简化存储结构**:取消双向记录,减少文件冗余
|
||||
|
||||
---
|
||||
|
||||
## 五、历史规则存档(v4.4及以前)
|
||||
|
||||
> 以下规则已于 v4.5 废弃,仅作参考
|
||||
|
||||
### 5.1 已废弃:补课目录结构(v4.4)
|
||||
|
||||
```
|
||||
.claude/memory/class/{补课班级}/
|
||||
├── 学生姓名/ ← 正式学生
|
||||
│ └── feedback/
|
||||
│ └── YYYYMMDD_课程编号.md
|
||||
└── 补课/ ← 补课学生专用
|
||||
│ └── YYYYMMDD_课程编号-课次.md
|
||||
└── 补课/ ← 补课学生专用(已废弃)
|
||||
└── {学生姓名}/
|
||||
└── feedback/
|
||||
└── YYYYMMDD_课程编号.md
|
||||
└── YYYYMMDD_课程编号-课次.md
|
||||
```
|
||||
|
||||
### 4.2 双向记录
|
||||
### 5.2 已废弃:双向记录(v4.4)
|
||||
|
||||
**补课产生两条文件记录**:
|
||||
|
||||
| 位置 | 文件名 | 内容 |
|
||||
|------|--------|------|
|
||||
| 原班级侧 | `feedback/YYYYMMDD_课程编号-课次(补课-去班级名).md` | 记录"去了哪补课" |
|
||||
| 补课班级侧 | `补课/{学生}/feedback/YYYYMMDD_课程编号.md` | 正常课评,开头注明来源 |
|
||||
| 原班级侧 | `feedback/YYYYMMDD_课程编号-课次(补课-去班级名).md` | 记录"去了哪补课",无正文 |
|
||||
| 补课班级侧 | `补课/{学生}/feedback/YYYYMMDD_课程编号-课次.md` | 正常课评,文件开头注明来源 |
|
||||
|
||||
### 4.3 自动化统计影响
|
||||
---
|
||||
|
||||
- 补课学生必须在补课班级的 `补课/` 目录下有课评文件
|
||||
- 原班级侧的 `(补课-去...).md` 文件用于标记出勤状态(补课=到课)
|
||||
- 系统三级查找的第二级会搜索所有 `补课/` 目录
|
||||
*规则版本:v4.5 | 更新日期:2026-05-20*
|
||||
|
||||
@@ -1,7 +1,12 @@
|
||||
# 学生管理规则:画像建立、千人千面、姓名处理
|
||||
|
||||
> 合并文件:班级差异与千人千面 + 学生画像建立指南 + 姓名处理规则
|
||||
> 版本:v4.0 | 更新日期:2026-05-14
|
||||
> 版本:v4.5 | 更新日期:2026-05-20
|
||||
>
|
||||
> **v4.5 变更**:表单直连提交 — 取消复制粘贴;版本号同步
|
||||
> **v4.4 变更**:统一版本号至 v4.4;更新日期
|
||||
> **v4.2 变更**:统一禁用"今天",统一使用"本节课";修复所有示例中的时间表述
|
||||
> **v4.1 变更**:补充补课/体验学生录入说明 — 可通过网页表单「补课/体验学生区」或聊天输入 `姓名 [补课]`/`姓名 [体验]` 录入
|
||||
>
|
||||
> **v4.0 变更**:同步课评规范V1.0 — 更新档案存储路径为 `.claude/memory/class/` 标准;学生画像文件改为固定名 `profile.md`
|
||||
|
||||
@@ -167,9 +172,9 @@ Step 6: 持续更新成长轨迹
|
||||
|
||||
| 班级类型 | 课评侧重 | 示例 |
|
||||
|---------|---------|------|
|
||||
| 年龄偏小班 | 参与度、情绪适应 | "今天能主动拿起管道尝试,这个开始很重要" |
|
||||
| 年龄偏小班 | 参与度、情绪适应 | "本节课能主动拿起管道尝试,这个开始很重要" |
|
||||
| 能力较强班 | 创意、挑战度 | "不仅完成基础搭建,还自己加了弯管设计" |
|
||||
| 活跃好动班 | 专注力、规则意识 | "今天专注了15分钟,中途没有离开座位" |
|
||||
| 活跃好动班 | 专注力、规则意识 | "本节课专注了15分钟,中途没有离开座位" |
|
||||
| 内向安静班 | 社交互动、表达 | "主动邀请旁边的小朋友一起看球滚落" |
|
||||
|
||||
### 3.2 学生维度差异
|
||||
@@ -181,15 +186,15 @@ Step 6: 持续更新成长轨迹
|
||||
|
||||
小明(谨慎型):
|
||||
→ 课评侧重:主动尝试的勇气
|
||||
"小明今天观察了5分钟后主动拿起管道,这个开始的勇气比作品本身更值得关注"
|
||||
"小明本节课观察了5分钟后主动拿起管道,这个开始的勇气比作品本身更值得关注"
|
||||
|
||||
小红(活跃型):
|
||||
→ 课评侧重:专注和坚持
|
||||
"小红今天专注搭建15分钟,没有频繁换玩法,这个坚持很难得"
|
||||
"小红本节课专注搭建15分钟,没有频繁换玩法,这个坚持很难得"
|
||||
|
||||
小强(敏感型):
|
||||
→ 课评侧重:抗挫和情绪管理
|
||||
"今天球卡住了小强没有急,而是调整了入口高度,这个调整值得肯定"
|
||||
"本节课球卡住了小强没有急,而是调整了入口高度,这个调整值得肯定"
|
||||
```
|
||||
|
||||
### 3.3 历史对比差异
|
||||
@@ -252,4 +257,4 @@ TUBE-001 小小班A班
|
||||
|
||||
- **profile.md(标准)**:`.claude/memory/class/{班级}/{学生名}/profile.md`
|
||||
- **标准课评模板**:详见 [20-workflow.md 第7.7节](20-workflow.md)
|
||||
- **课评规范全文**:[20-workflow.md 第10节](20-workflow.md) 课评规范V1.0对照
|
||||
- **课评规范全文**:[20-workflow.md 第10节](20-workflow.md) 课评规范V1.0对照
|
||||
@@ -1,11 +1,19 @@
|
||||
# 课评输出格式规则 - 学龄前版(2.5-6岁)
|
||||
|
||||
> 适用课程:意识世界(托班)、发现世界(小班)、发明世界(中班)、创造世界(大班)
|
||||
> 特点:微信表情增强互动性,温暖亲切,画面感强
|
||||
> **重要**:学期周数仅用于后端匹配课程主题,**课评正文不提及"第几周"**
|
||||
>
|
||||
> 适用课程:意识世界(托班)、发现世界(小班)、发明世界(中班)、创造世界(大班)
|
||||
> 版本: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`
|
||||
@@ -20,7 +28,8 @@
|
||||
- **段落简短**:每段1-2句话,易于阅读
|
||||
- **画面感强**:描述作品细节,让家长能想象出画面
|
||||
- **三维度覆盖**:课程设计、学习表现、兴趣度
|
||||
- **称呼规范**:优先使用小名/昵称,其次去姓称名(如"昕乔"),禁用"宝贝"等套话
|
||||
- **称呼规范**:优先使用小名/昵称,其次去姓称名(如"昕乔"),禁用"宝贝"、"小朋友"等套话
|
||||
- **措辞统一**:禁用"今天",使用"本节课"
|
||||
|
||||
### 排版样式(三段式)
|
||||
```
|
||||
@@ -28,30 +37,30 @@
|
||||
|
||||
这节课【称呼】【整体表现描述】。【掌握程度】,【课程环节表现】。和【对比时间】相比,【进步表现】,【具体亮点】 💪✨
|
||||
|
||||
【课后建议】,【具体做法】 🏠
|
||||
【课后建议】,【具体做法】,巩固本节课的【知识点】 🏠
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📝 三段式结构模板
|
||||
|
||||
> **详细规范**:三段式结构、字数弹性规则、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段为长段落整合多个模块内容
|
||||
|
||||
---
|
||||
|
||||
### 第1段:课程知识点(30-40字)
|
||||
### 第1段:课程知识点(30-55字)
|
||||
|
||||
**写什么**:本节课的核心结构知识或技能点,体现课程趣味性
|
||||
**写法**:
|
||||
@@ -66,7 +75,7 @@
|
||||
|
||||
**示例**:
|
||||
```
|
||||
小明今天学习了"互锁结构"——把积木像砌墙一样交错叠放,这样搭出来的墙更稳固 🔍
|
||||
小明本节课学习了"互锁结构"——把积木像砌墙一样交错叠放,这样搭出来的墙更稳固 🔍
|
||||
```
|
||||
|
||||
**表情备选**:🔍💡📚⭐
|
||||
@@ -80,39 +89,39 @@
|
||||
- 掌握程度:学生对该知识点的学习表现
|
||||
- 课程环节:导入、探索、实践、分享各环节的状态
|
||||
- 成长亮点:与之前相比的进步或突出表现
|
||||
- **弹性原则**:当输入中有多个亮点或精彩瞬间时,**充分展开描述,不要压缩到100-130字**,可扩展到150-220字
|
||||
- **弹性原则**:当输入中有多个亮点或精彩瞬间时,充分展开描述,不要压缩到100-130字,可扩展到150-220字
|
||||
|
||||
**格式**:
|
||||
```
|
||||
这节课【孩子称呼】【整体状态描述】。【掌握程度描述】,【课程环节表现】。和【对比时间】相比,【进步表现】,【具体亮点】 💪✨
|
||||
这节课【孩子称呼】【整体表现描述】。【掌握程度描述】,【课程环节表现】。和【对比时间】相比,【进步表现】,【具体亮点】 💪✨
|
||||
```
|
||||
|
||||
**示例**:
|
||||
```
|
||||
这节课小明对房子主题很感兴趣,搭建环节专注投入约30分钟。互锁的方法听懂了,实际操作时前两块需要老师扶着手指对齐,第三块开始能自己完成。和上周比,今天结构倒了没有发脾气,而是拆开重新观察了一下底座平不平,这个调整值得注意 💪✨
|
||||
这节课小明对房子主题很感兴趣,搭建环节专注投入约30分钟💪。互锁的方法听懂了,实际操作时前两块需要老师扶着手指对齐,第三块开始能自己完成✨。和上周比,本节课结构倒了没有发脾气,而是拆开重新观察了一下底座平不平,这个调整值得注意🌟
|
||||
```
|
||||
|
||||
**表情备选**:💪✨🌱📈🎯
|
||||
|
||||
---
|
||||
|
||||
### 第3段:课后建议(30-50字)
|
||||
### 第3段:课后建议(30-55字)
|
||||
|
||||
**写什么**:家长可以在家配合的具体活动,巩固兴趣和学习成果
|
||||
**写法**:
|
||||
- 可操作:不说"多练习",说具体玩法
|
||||
- 关联课程:在家可以用积木重复今天的互锁结构
|
||||
- 关联课程:"在家可以用乐高重复本节课的互锁结构"
|
||||
- 尊重家庭:用"可以试试看"而非"必须"
|
||||
- **弹性原则**:当第2段非常详细时,建议部分也可适度扩展到40-50字,给出更具体的家庭活动建议
|
||||
- **弹性原则**:当第2段非常详细时,建议部分也可适度扩展到40-55字,给出更具体的家庭活动建议
|
||||
|
||||
**格式**:
|
||||
```
|
||||
【家庭活动建议】,【具体做法】,巩固今天的【知识点】 🏠
|
||||
【家庭活动建议】,【具体做法】,巩固本节课的【知识点】 🏠
|
||||
```
|
||||
|
||||
**示例**:
|
||||
```
|
||||
家里如果有积木,可以和孩子一起搭两堵墙,一堵直着叠、一堵交错叠,推推看哪个更稳,巩固今天的互锁概念 🏠
|
||||
家里如果有积木,可以和孩子一起搭两堵墙,一堵直着叠、一堵交错叠,推推看哪个更稳,巩固本节课的互锁概念 🏠
|
||||
```
|
||||
|
||||
**表情备选**:🏠👨👩👧🎮📱
|
||||
@@ -123,51 +132,69 @@
|
||||
|
||||
## 📊 完整示例
|
||||
|
||||
### 示例1:小班-发现世界(三段式)
|
||||
### 示例1:小班-发现世界(标准版)- v4.6 更新
|
||||
|
||||
**输入**:小明:观望一会儿→主动搭3层→自己调整 ↑++
|
||||
|
||||
**输出**:
|
||||
```
|
||||
小明今天学习了"互锁结构"——把积木像砌墙一样交错叠放,这样搭出来的墙更稳固🔍
|
||||
小明本节课学习了"互锁结构"——把积木像砌墙一样交错叠放,这样搭出来的墙更稳固,不容易倒🔍
|
||||
|
||||
这节课小明对房子主题很感兴趣,搭建环节专注投入约30分钟💪。互锁的方法听懂了,实际操作时前两块需要老师扶着手指对齐,第三块开始能自己完成✨。导入环节参与积极,分享时能说出互锁的作用,本节课的结构搭建目标顺利达成🌟。和上周比,今天结构倒了没有发脾气,而是拆开重新观察了一下底座平不平,这个调整值得注意📈
|
||||
本节课小明对房子主题表现出浓厚兴趣,开始阶段先观察了一会儿,后来在老师鼓励下主动开始搭建,专注投入了挺长时间💪。互锁的方法听懂了,实际操作时前两块需要老师扶着手指对齐凹槽,第三块开始能独立完成,到第五块时已经能自己检查是否对齐✨。结构第一次倒了是因为底座不平,小明没有像以前那样直接推倒重来,而是拆开重新观察底座,发现左边比右边低,调整后重新搭建,这个情绪调节和问题解决能力比两周前有明显提升🌟
|
||||
|
||||
家里如果有积木,可以和孩子一起搭两堵墙,一堵直着叠、一堵交错叠,推推看哪个更稳,巩固今天的互锁概念🏠
|
||||
家里如果有积木,可以和孩子一起搭两堵墙,一堵直着叠、一堵交错叠,推推看哪个更稳,巩固本节课的互锁概念🏠
|
||||
```
|
||||
|
||||
**字数**:198字(符合180-220)
|
||||
**表情数**:5个(第1段1个/第2段3个/第3段1个),第2段表情分散在段内
|
||||
**字数**:258字(符合220-300字标准版)
|
||||
**表情数**:4个(第1段1个/第2段2个/第3段1个),第2段分散在段内
|
||||
**段落数**:3段(符合要求)
|
||||
|
||||
**v4.6 改进点**:
|
||||
- 时间描述模糊化("观察了一会儿"、"挺长时间"而非精确分钟数)
|
||||
- 增加过程细节(第2块→第3块→第5块的进步阶梯)
|
||||
- 增加思维描述(发现左边比右边低)
|
||||
- 增加纵向对比(两周前的情绪调节能力)
|
||||
- AI 自动扩展了画像和历史数据中的细节
|
||||
|
||||
---
|
||||
|
||||
### 示例2:托班-意识世界(三段式)
|
||||
### 示例2:托班-意识世界(标准版)- v4.6 更新
|
||||
|
||||
**输入**:昀昊:害羞→搭2层管道 ↑
|
||||
|
||||
**输出**:
|
||||
```
|
||||
昀昊本节课玩了"管道滚球",让小球在管道里旅行,感受了球滚动的乐趣🔍
|
||||
|
||||
本节课昀昊开始有点害羞,看了2分钟才开始尝试,后来在老师鼓励下搭了2层管道让小球滚下来💪。导入环节对滚球游戏很感兴趣,探索环节专注尝试管道连接,最后能独立完成2层搭建,本节课的管道连接目标顺利达成🌟。和上周相比,本节课敢自己拿管道尝试了,不再只是看着,能安静专注地玩10分钟,这个专注力对托班宝宝来说很棒了✨
|
||||
本节课昀昊开始有点害羞,先观察了一会儿才开始尝试,后来在老师鼓励下搭了2层管道让小球滚下来💪。导入环节对滚球游戏很感兴趣,探索环节专注尝试管道连接,最后能独立完成2层搭建,本节课的管道连接目标顺利达成✨。和上周比,本节课敢自己拿管道尝试了,不再只是看着,能安静专注地玩一阵子,这个专注力对托班宝宝来说很棒了🌟
|
||||
|
||||
爸爸妈妈可以用保鲜膜筒芯或报纸卷成管道,和小球一起玩,让球从高的地方滚下来,感受运动的快乐🏠
|
||||
家里可以用保鲜膜筒芯或报纸卷成管道,和小球一起玩,让球从高的地方滚下来,感受运动的快乐🏠
|
||||
```
|
||||
|
||||
**字数**:195字(符合180-220)
|
||||
**表情数**:5个(第1段1个/第2段3个/第3段1个),第2段表情分散在段内
|
||||
**字数**:198字(符合180-220字精简版-标准版之间)
|
||||
**表情数**:3个(第1段1个/第2段2个/第3段1个),第2段分散在段内
|
||||
**段落数**:3段(符合要求)
|
||||
**语气**:更温和,适合托班
|
||||
|
||||
**v4.6 改进点**:
|
||||
- 时间描述更模糊("观察了一会儿"、"一阵子"而非"2分钟"、"10分钟")
|
||||
- 保持托班适用的温和语气
|
||||
- AI 自动补充了情绪变化细节
|
||||
|
||||
---
|
||||
|
||||
## ⚙️ 技术规范
|
||||
|
||||
### 字数控制(弹性范围)
|
||||
### 技术规范(弹性范围)- v4.6 更新
|
||||
|
||||
| 输入类型 | 字数范围 | 适用场景 |
|
||||
|:-------:|:-------:|:---------|
|
||||
| **精简版** | 180-220字 | 输入简洁,仅包含基本行为描述 |
|
||||
| **标准版** | 220-280字 | 输入有具体细节或1-2个亮点 |
|
||||
| **详细版** | 280-350字 | 输入有精彩瞬间、多个亮点或特殊表现 |
|
||||
| 输入类型 | 字数范围 | 适用场景 | 结构 |
|
||||
|:-------:|:-------:|:---------|:----:|
|
||||
| **精简版** | 180-220字 | 输入简洁,仅包含基本行为描述 | 3段 |
|
||||
| **标准版** | 220-300字 | 输入有具体细节或1-2个亮点 | 3段 |
|
||||
| **详细版** | 300-400字 | 输入有精彩瞬间、多个亮点或特殊表现 | 3-4段 |
|
||||
|
||||
**各年龄段参考**:
|
||||
- 托班(2.5-3岁):可适当减少20-30字
|
||||
- 托班(2.5-3岁):可适当减少20-30字,时间描述更模糊
|
||||
- 小班(3-4岁):按标准范围
|
||||
- 中班(4-5岁):按标准范围
|
||||
- 大班(5-6岁):可适当增加10-20字
|
||||
@@ -177,7 +204,9 @@
|
||||
- **标准版**:输入有具体细节或1-2个亮点(如"主动搭3层,自己调整,还帮助同伴")
|
||||
- **详细版**:输入有精彩瞬间、多个亮点或特殊表现(如"第一次主动帮助同伴,调试了三次才成功,最后说这是最喜欢的作品")
|
||||
|
||||
### 表情数量
|
||||
**AI 自动扩展**:即使老师输入简洁,AI 也会基于学生画像和历史数据自动补充细节,生成更丰富的课评
|
||||
|
||||
### Emoji数量
|
||||
- **第1段**:1个(🔍/💡根据课程主题适配)
|
||||
- **第2段**:1-3个(根据课堂情节亮点自动适配,如💪/✨/📈等)
|
||||
- **第3段**:1个(🏠/👨👩👧根据建议内容适配)
|
||||
@@ -190,13 +219,13 @@
|
||||
|
||||
**第2段分散示例**:
|
||||
```
|
||||
这节课小明对房子主题很感兴趣,搭建环节专注投入约30分钟💪。互锁的方法听懂了,实际操作时前两块需要老师扶着手指对齐,第三块开始能自己完成✨。和上周比,今天结构倒了没有发脾气,而是拆开重新观察了一下底座平不平,这个调整值得注意🌟。
|
||||
这节课小明对房子主题很感兴趣,搭建环节专注投入约30分钟💪。互锁的方法听懂了,实际操作时前两块需要老师扶着手指对齐,第三块开始能自己完成✨。和上周比,本节课结构倒了没有发脾气,而是拆开重新观察了一下底座平不平,这个调整值得注意🌟
|
||||
```
|
||||
|
||||
### Emoji适配指南
|
||||
|
||||
| 段落 | 内容 | 推荐表情 | 适配场景 |
|
||||
|------|------|:-------:|---------|
|
||||
|------|------|:-------:|:---------|
|
||||
| 第1段 | 课程知识点 | 🔍/💡 | 🔍探索新知识/💡有启发 |
|
||||
| 第2段 | 课堂细节 | 1-3个 | 💪努力/✨亮点/📈进步/🌟突破/😊开心 |
|
||||
| 第3段 | 课后建议 | 🏠/👨👩👧 | 🏠家庭活动/👨👩👧亲子互动 |
|
||||
@@ -223,23 +252,36 @@
|
||||
### 学龄前版专项检查
|
||||
- [ ] 字数符合弹性范围(精简版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个)
|
||||
- [ ] 表情根据情节自动适配,不机械固定
|
||||
- [ ] 称呼正确(小名>去姓>叠字>全名)
|
||||
- [ ] 无"第几周"字样
|
||||
- [ ] **无"今天"、"本周"、"第几周"等表述,统一使用"本节课"**
|
||||
- [ ] 语气温暖亲切,有画面感
|
||||
- [ ] 建议具体可操作
|
||||
- [ ] **第2段充分展现输入中的精彩瞬间**(不压缩丰富内容)
|
||||
|
||||
---
|
||||
|
||||
## 📋 班级总结模板
|
||||
|
||||
班级总结文件(`summaries/YYYYMMDD_课程编号-课次_班级反馈.md`)使用统一模板框架,完整模板定义详见 [20-workflow.md 第5.4节](20-workflow.md)。
|
||||
|
||||
### 学龄前版关键要点
|
||||
|
||||
- **基本信息字段**:表现标签提炼3-5个关键词(如"积极搭建"、"创意设计"、"情绪调节快"),体现本节课核心亮点
|
||||
- **情绪状态**:综合判断本节课情绪基调("开心/稳定"、"积极/稳定"、"波动"等)
|
||||
- **教师备注-亮点**:提炼1-2个最有代表性的亮点描述
|
||||
- **本周表现分布**:根据学生实际表现评估填写
|
||||
- **共性观察**:重点描述学龄前学生的参与度和兴趣表现
|
||||
|
||||
---
|
||||
|
||||
## 📝 与小学版对比
|
||||
|
||||
| 维度 | 学龄前版(本文件)| 小学版 |
|
||||
|------|------------------|--------|
|
||||
| **表情** | 3-5个(第1段1个/第2段1-3个/第3段1个),温暖活泼 | 3-5个(第1段1个/第2段1-3个/第3段1个),简洁专业 |
|
||||
| **段落** | **3段**(第1段知识点、第2段课堂细节、第3段课后建议)| 3段,结构化 |
|
||||
| **语气** | 亲切温暖,画面感 | 尊重平等,专业 |
|
||||
| **字数** | 弹性范围180-350字 | 弹性范围190-350字 |
|
||||
| **信息密度** | 第2段为长段落,根据输入丰富度灵活扩展 | 结构化呈现,根据输入灵活扩展 |
|
||||
| **emoji位置** | 第1段末尾、第2段分散在段内、第3段末尾 | 第1段末尾、第2段分散在段内、第3段末尾 |
|
||||
| 维度 | 学龄前版 | 小学版 |
|
||||
|------|:--------:|:-------:|
|
||||
| **表情** | 3-5个(第1段1个/第2段1-3个/第3段1个),温暖活泼 | 3-5个,简洁专业 |
|
||||
| **段落** | 3段(统一三段式) | 3段(统一三段式) |
|
||||
| **语气** | 温暖亲切,画面感强 | 尊重平等,专业简洁 |
|
||||
| **字数** | 弹性范围180-350字 | 弹性范围180-350字 |
|
||||
| **emoji位置** | 第1段末尾、第2段分散在段内、第3段末尾 | 第1段末尾、第2段分散在段内、第3段末尾 |
|
||||
@@ -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字 |
|
||||
Reference in New Issue
Block a user