# 课评输出格式规则 - 小学版（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`
> - **历史档案**：`.claude/memory/class/{班级}/{学生名}/feedback/`

---

## 整体风格定位

### 核心特点
- **专业简洁**：准确使用编程术语（循环、条件、事件），但不堆砌
- **尊重平等**：像对待小学习者一样尊重，不居高临下
- **启发性**：指出问题同时给方向
- **具体性**：不说"很棒"，说"自己检查出少了一个结束括号"
- **称呼规范**：优先使用小名/昵称，其次去姓称名（如"昕乔"），禁用"宝贝"、"小朋友"等套话
- **措辞统一**：禁用"今天"、"本周"，统一使用"本节课"

### 与学龄前版的语气差异

| 维度 | 学龄前版 | 小学版 |
|------|:--------:|:-------:|
| **语气** | 温暖亲切，画面感强 | 专业简洁，尊重平等 |
| **禁用词** | 宝贝、小天才 | 小天才、未来的程序员、秒杀同龄人 |
| **术语** | 避免专业术语 | 准确使用但不堆砌 |
| **建议** | 亲子游戏活动 | 自主练习任务 |

---

## 三段式结构模板

> **详细规范**：三段式结构、字数弹性规则、Emoji使用规范详见 [10-style.md](10-style.md)（第2-4节）
>
> 本文档仅保留小学版的**语气风格**和**具体示例**

### 结构速查

| 段落 | 内容 | 字数范围 | Emoji数量 | 推荐表情 |
|------|------|:-------:|:---------:|:-------:|
| **第1段** | 课程知识点 | 30-55字 | 1个 | 💡/⚙️/🤖自动适配 |
| **第2段** | 课堂细节（掌握程度+环节表现+成长亮点）| **100-220字（弹性）** | 1-3个 | 根据情节自动适配 |
| **第3段** | 课后建议 | 30-55字 | 1个 | 🏠/🔧自动适配 |

**段落控制**：全文控制在**3个段落**，第2段为长段落整合多个模块内容

---

### 第1段：课程知识点（30-55字）

**写什么**：本节课学习的编程概念或技能点

**写法**：
- 准确术语："学习了'当按下空格键'事件和'移动10步'指令"
- 说明用途："用这些做了一个可以用键盘控制的小猫走迷宫"
- 避免空话：不说"学习了编程的基础知识"

**格式**：
```
【孩子称呼】本节课学习了"【主题】"，【核心知识点描述】 💡
```

**示例**：
```
李想本节课学习了"重复执行"（循环），用它让小鸟持续扇翅膀，不用重复写很多次一样的代码💡
```

---

### 第2段：课堂细节长段落（100-220字，根据内容丰富度灵活调整）

**写什么**：整合掌握程度、课程环节表现、成长亮点的详细描述

**写法**：
- 掌握程度：对知识点的理解和应用情况，可以数据化
- 课程环节：导入、探索、实践、分享各环节的状态
- 成长亮点：与之前相比的进步或突出表现
- **弹性原则**：当输入中有多个亮点或精彩瞬间时，充分展开描述，可扩展到150-220字

**格式**：
```
这节课【孩子称呼】【整体表现描述】。【掌握程度描述】，【课程环节表现】。和【对比时间】相比，【进步表现】，【具体亮点】 📈💪
```

**示例**：
```
这节课李想对迷宫游戏很感兴趣，搭建环节专注投入30分钟💪。循环的作用理解了，第一次设成3次发现小猫走得不够远，改成10次后正常，条件判断一开始方向写反了，自己检查代码后发现并修正✨。和之前比，本节课遇到bug没有直接问老师，先试着改了几个参数看效果，这个调试思路是对的📈
```

---

### 第3段：课后建议（30-55字）

**写什么**：家长可以支持的具体练习任务

**写法**：
- 具体任务："可以试试给游戏加一个'开始'按钮"
- 生活连接："玩棋类游戏时可以聊聊'如果...就...'的判断逻辑"
- 尊重家庭：用"可以试试看"而非"必须"

**格式**：
```
【家庭练习建议】，【具体做法】，巩固本节课的【知识点】 🏠
```

**示例**：
```
回家后可以试试给游戏加一个"开始"按钮，点击后小猫才动。需要用到"当角色被点击"事件，可以预习一下。下周我们继续🏠
```

---

## Emoji使用规则

### Emoji数量与位置

| 段落 | 数量 | 位置 |
|------|:----:|:-----|
| **第1段** | 1个 | 段末，紧跟最后一个句号 |
| **第2段** | 1-3个 | 段内分散插入，每个表情紧跟在对应亮点的句号之后 |
| **第3段** | 1个 | 段末，紧跟最后一个句号 |
| **总计** | **3-5个** | 灵活不固定 |

### Emoji适配指南

| 情节类型 | 推荐表情 | 使用场景 |
|---------|:-------:|:--------|
| 技术编程 | 💡/⚙️/🤖 | 学习新概念、编写程序 |
| 努力坚持 | 💪 | 调试排错、克服困难 |
| 成长进步 | 📈/✨ | 比上次好、有突破 |
| 家庭练习 | 🏠/🔧 | 课后建议 |

### 第2段分散插入示例

```
这节课李想对迷宫游戏很感兴趣，搭建环节专注投入30分钟💪。循环的作用理解了，第一次设成3次发现小猫走得不够远，改成10次后正常，条件判断一开始方向写反了，自己检查代码后发现并修正✨。和之前比，本节课遇到bug没有直接问老师，先试着改了几个参数看效果，这个调试思路是对的📈
```

**规则**：
- 表情紧跟句号，不加空格（如"...完成💪。"）
- 第2段有2个亮点时插入2个表情，3个亮点时插入3个表情
- 禁止：段落开头、连续多个表情、负面表情（😡😤💢）

---

## 完整示例

### 示例1：SPIKE-颜色传感器巡线（详细版）- v4.6 更新

**输入**：浩浩：校准3次→成功率60→85%→排查思路 ↑++

**输出**：
```
浩浩本节课系统学习了颜色传感器的巡线校准，重新标定白值（从45调整到38）和黑值（从12调整到8），让机器人能准确识别地上的黑线💡

本节课浩浩专注度很好，校准过程很细致，反复测试了3次确保数据准确，共用时约15分钟💪。第一次校准后巡线成功率约60%，第二次调整到75%，第三次达到85%，进步明显✨。巡线程序的逻辑听懂了，能解释为什么机器人会跟着黑线走（传感器检测反射光强度差异），转弯参数调整需要提醒。导入环节对传感器话题很感兴趣，实践环节专注完成校准，分享时能清晰说出巡线的原理和校准的重要性。特别值得肯定的是，本节课程序出问题时会先打开传感器数据面板检查实时读数，再看程序逻辑，最后才调整参数，排查时间从平均5分钟缩短到2分钟，展现出了很好的系统排查思路📈

在家可以用模拟器练习本节课的巡线程序，试试不同速度参数（30/50/70）观察机器人表现，记录哪种速度下巡线最稳定，下周可以带数据来分享🏠
```

**字数**：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编写（标准版）- v4.6 更新

**输入**：怡瞳：观察→专注→指令要具体→求助清晰 ↑

**输出**：
```
怡瞳本节课学习了AI助手的Prompt编写基础，学会用清晰、具体的指令让AI理解自己的需求并生成符合预期的内容💡

本节课怡瞳启动阶段用了约5分钟观察其他同学的操作，进入状态后能专注完成基础任务，全程投入约30分钟💪。Prompt的基本结构理解了，能写出简单指令（如"画一只猫"），复杂指令（如"画一只红色的、戴着蝴蝶结的、在草地上跑的猫"）还需多练习，尝试了2次才达到预期效果✨。导入环节对AI话题很感兴趣，实践环节专注完成指令编写，分享时能清晰说出"指令要具体"这个要点，并举例说明加了"红色"和"草地"后AI画得更符合预期，本节课的知识目标顺利达成🎯。本节课遇到困难时求助方式很清晰，能描述具体问题（"我加了颜色但AI没画出来"）而不是只说"不会"，展现出了很好的表达能力📈

回家后可以试试让AI完成"画一只红色的猫"这个基础指令，再逐步添加描述词（如"戴着蝴蝶结"、"在草地上"），观察每加一词AI回答有什么变化，记录哪个词对结果影响最大🏠
```

**字数**：298字（标准版-详细版之间）
**段落**：3段
**Emoji**：5个（第1段1个/第2段3个/第3段1个）

**v4.6 改进点**：
- 增加时间数据（5分钟观察、30分钟投入）
- 增加具体案例（简单指令vs复杂指令的对比）
- 增加尝试次数（2次才达到预期）
- 增加分享细节（举例说明"红色"和"草地"的作用）
- 增加求助描述（具体问题的例子）
- 增加课后任务的可执行性（逐步添加描述词，记录影响最大的词）

---

### 示例3：AICODE03-代码调试（详细版）- v4.6 更新

**输入**：一栩：带代码→变量未定义/类型不匹配→先自查再求助 ↑++

**输出**：
```
一栩本节课系统学习了用AI辅助代码调试，让AI帮忙找出程序中的逻辑错误和语法错误，重点理解了"变量未定义"和"类型不匹配"两种常见报错💡

本节课一栩专注度很好，提前带着自己写的代码（一个计算平均分的程序）来课堂💪。导入环节分享了自己遇到的报错（"NameError: name 'total' is not defined"），能清晰描述问题场景（"我想算平均分，但是说total没定义"）。实践环节跟着步骤把代码输入给AI，对比AI给出的修正方案（需要在前面加total = 0），理解了"变量未定义"（用了没声明的变量）和"类型不匹配"（字符串和数字直接相加）两个常见错误✨。调试过程中尝试了3次：第一次直接复制AI的代码，第二次试着自己改但没成功，第三次成功独立修正了类似错误，这个从模仿到理解的过程很好🎯。和几节课前比，本节课会先自己检查一遍代码（约3分钟），标出可能出错的行，再请AI帮忙定位，而不是一遇到报错就直接求助，独立解决问题的习惯正在养成📈

在家练习时遇到报错建议先读一遍错误提示，圈出报错的行号，试着手动改一改（约5分钟），记录改了哪些地方，实在不行再用AI辅助查看。下周可以带来调试记录（报错截图+修改过程）分享🏠
```

**字数**：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个（根据课堂情节亮点自动适配，如💪/✨/📈等）
- **第3段**：1个（🏠/🔧根据建议内容适配）
- **总计**：3-5个，灵活不固定

### 段落长度
- **每段**：1-3句话
- **换行**：段间空一行

### 禁用表情
❌ 避免使用：
- 负面表情（😡😤💢）
- 过于成人化（🍺💰💼）
- 可能引起误解（👻💀🤡）

---

## 质量检查清单

### 通用检查（详见 [00-core.md](00-core.md) 质量检查清单）
- [ ] 学生姓名正确、日期时间正确、课程主题正确
- [ ] 无错别字，语句通顺，格式统一
- [ ] 语气恰当，无其他学生负面信息

### 小学版专项检查
- [ ] 字数符合弹性范围（精简版180-220字/标准版220-280字/详细版280-350字，根据输入内容丰富度）
- [ ] **3段式结构**（第1段知识点、第2段课堂细节、第3段课后建议）
- [ ] 第1段和第3段末尾各1个emoji；第2段emoji分散在段内（总计3-5个）
- [ ] 表情根据情节自动适配，不机械固定
- [ ] 称呼正确（小名>去姓>叠字>全名）
- [ ] **无"今天"、"本周"、"第几周"等时间表述，统一使用"本节课"**
- [ ] 语气专业简洁，尊重平等
- [ ] 术语准确但不堆砌
- [ ] 建议具体可操作
- [ ] **第2段充分展现输入中的精彩瞬间**（不压缩丰富内容）

---

## 📋 班级总结模板

班级总结文件（`summaries/YYYYMMDD_课程编号-课次_班级反馈.md`）使用统一模板框架，完整模板定义详见 [20-workflow.md 第5.4节](20-workflow.md)。

### 小学版关键要点

- **基本信息字段**：表现标签提炼3-5个关键词（如"圆周运动理解"、"创意改造"、"编程巩固"、"主动互动"），侧重编程和技术表现
- **情绪状态**：综合判断本节课情绪基调（"积极/稳定"、"稳定"、"开心/稳定"等）
- **教师备注-亮点**：提炼1-2个最有代表性的技术或思维亮点
- **本周表现分布**：根据学生编程和搭建表现评估填写
- **共性观察**：重点描述编程理解和变量掌握情况

---

## 与学龄前版对比

| 维度 | 学龄前版 | 小学版 |
|------|:--------:|:-------:|
| **适用课程** | TUBE/DISC/INVENT/CREATE | SPIKE/AICODE03 |
| **表情** | 3-5个，温暖活泼 | 3-5个，简洁专业 |
| **段落** | 3段（统一三段式） | 3段（统一三段式） |
| **语气** | 温暖亲切，画面感强 | 尊重平等，专业简洁 |
| **禁用词** | 宝贝、小天才 | 宝贝、小天才、未来的程序员 |
| **字数** | 弹性范围180-350字 | 弹性范围180-350字 |