16 KiB
16 KiB
课评输出格式规则 - 小学版（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（第3节、第7节） 补课/体验标记：补课学生输出格式为 "姓名 [补课]"，体验学生为 "姓名 [体验]"，系统自动识别处理 存储位置（课评规范标准）：
- 个人课评文件：
.claude/memory/class/{班级}/{学生名}/feedback/YYYYMMDD_课程编号-课次.md- 班级总结：
.claude/memory/class/{班级}/summaries/YYYYMMDD_课程编号-课次_班级反馈.md- 历史档案：
.claude/memory/class/{班级}/{学生名}/feedback/
整体风格定位
核心特点
- 专业简洁：准确使用编程术语（循环、条件、事件），但不堆砌
- 尊重平等：像对待小学习者一样尊重，不居高临下
- 启发性：指出问题同时给方向
- 具体性：不说"很棒"，说"自己检查出少了一个结束括号"
- 称呼规范：优先使用小名/昵称，其次去姓称名（如"昕乔"），禁用"宝贝"、"小朋友"等套话
- 措辞统一：禁用"今天"、"本周"，统一使用"本节课"
与学龄前版的语气差异
| 维度 | 学龄前版 | 小学版 |
|---|---|---|
| 语气 | 温暖亲切，画面感强 | 专业简洁，尊重平等 |
| 禁用词 | 宝贝、小天才 | 小天才、未来的程序员、秒杀同龄人 |
| 术语 | 避免专业术语 | 准确使用但不堆砌 |
| 建议 | 亲子游戏活动 | 自主练习任务 |
三段式结构模板
详细规范：三段式结构、字数弹性规则、Emoji使用规范详见 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 质量检查清单）
- 学生姓名正确、日期时间正确、课程主题正确
- 无错别字，语句通顺，格式统一
- 语气恰当，无其他学生负面信息
小学版专项检查
- 字数符合弹性范围（精简版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节。
小学版关键要点
- 基本信息字段：表现标签提炼3-5个关键词（如"圆周运动理解"、"创意改造"、"编程巩固"、"主动互动"），侧重编程和技术表现
- 情绪状态：综合判断本节课情绪基调（"积极/稳定"、"稳定"、"开心/稳定"等）
- 教师备注-亮点：提炼1-2个最有代表性的技术或思维亮点
- 本周表现分布：根据学生编程和搭建表现评估填写
- 共性观察：重点描述编程理解和变量掌握情况
与学龄前版对比
| 维度 | 学龄前版 | 小学版 |
|---|---|---|
| 适用课程 | TUBE/DISC/INVENT/CREATE | SPIKE/AICODE03 |
| 表情 | 3-5个，温暖活泼 | 3-5个，简洁专业 |
| 段落 | 3段（统一三段式） | 3段（统一三段式） |
| 语气 | 温暖亲切，画面感强 | 尊重平等，专业简洁 |
| 禁用词 | 宝贝、小天才 | 宝贝、小天才、未来的程序员 |
| 字数 | 弹性范围180-350字 | 弹性范围180-350字 |