更新课评系统代码

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

View File

@@ -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+编号
---

View File

@@ -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段 | Emoji4个第1段1个/第2段2个/第3段1个第2段分散在段内*
*字数:258字 | 段落3段 | Emoji4个第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段 | Emoji4第1段1个/第2段2个/第3段1个第2段分散在段内*
*字数298字 | 段落3段 | Emoji5第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段 | Emoji4个第1段1个/第2段2个/第3段1个第2段分散在段内*
*字数298字 | 段落3段 | Emoji4个第1段1个/第2段2个/第3段1个第2段分散在段内*
**改进点**
- 增加具体参数白值45→38黑值12→8
- 增加测试数据20次测试成功17次
- 增加问题分析(机械臂展开角度偏大)
- 增加解决方案优化到35度
- 增加效率对比3分钟→1.5分钟提升50%
- 增加可执行的课后任务三种方案每种5次

View File

@@ -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周

View File

@@ -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 22分钟: 速记输入
小红[补课]:专注完成 →
Step 32分钟: 查看并保存
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
├─ 学生名单:乔乔、昊昊、小明、小红
└─ [选择此班级]
班级 2Wedo创造世界-周六1030CREATE
├─ 学生名单:小强、小芳、小华
└─ [选择此班级]
班级 3AICODE03小Q周六1400AICODE03
├─ 学生名单:李明、王芳、张伟、刘洋
└─ [选择此班级]
班级 4Wedo创造世界-周六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 蜥蜴 ✅
└─ [选择此班级]
班级 2Wedo创造世界-周六1030CREATE
├─ 学生名单:小强、小芳、小华
├─ 当周课程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 4AI 自动检测 → 生成并双轨保存
```
→ 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人乔乔、昊昊、小明、小红
└─ [选择此班级]
班级 2Wedo创造世界-周六1030CREATE
├─ 学生数3人小强、小芳、小华
└─ [选择此班级]
班级 3AICODE03小Q周六1400AICODE03
├─ 学生数4人李明、王芳、张伟、刘洋
└─ [选择此班级]
班级 4Wedo创造世界-周六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*

View File

@@ -1,7 +1,10 @@
# 速记符号系统
> 从 20-workflow.md 拆分,专注速记符号定义与使用规则
> 版本v3.1 | 更新日期2026-05-05
> 版本v4.5 | 更新日期2026-05-20
>
> **v4.5 变更**:表单直连提交 — 取消复制粘贴,版本号同步
> **v4.4 变更**:统一版本号至 v4.4;更新日期
---

View File

@@ -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*

View File

@@ -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对照

View File

@@ -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段末尾 |

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个表情
- 禁止:段落开头、连续多个表情、负面表情(😡😤💢)
---
## 完整示例
### 示例1SPIKE-颜色传感器巡线
### 示例1SPIKE-颜色传感器巡线(详细版)- 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分钟
- 增加原理描述(反射光强度差异)
- 增加排查步骤(数据面板→程序逻辑→参数调整)
- 增加可执行的课后任务(三种速度参数测试)
---
### 示例2AICODE03-Prompt编写
### 示例2AICODE03-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次才达到预期
- 增加分享细节(举例说明"红色"和"草地"的作用)
- 增加求助描述(具体问题的例子)
- 增加课后任务的可执行性(逐步添加描述词,记录影响最大的词)
---
### 示例3AICODE03-代码调试(详细版)
### 示例3AICODE03-代码调试(详细版)- 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字 |