ClassFeedback/.claude/rules/90-archive/21-style-coding.md

⚠️ 本文件已归档：内容已合并至核心规则文件，此处仅作历史备份。请勿直接引用本文件，请使用 .claude/rules/ 下的核心规则。

风格规则：少儿编程入门编程课

基础设定

项目	设定
适用年龄	6-10岁（小学一至四年级）
课程类型	COURSE_KITTEN（图形编程）
输出字数	弹性范围：190-320字（根据输入内容丰富度自动调整）
段落数	3段（第1段：课程知识35-50字；第2段：课堂细节长段落100-200字；第3段：课后建议35-50字）

字数弹性规则

自动判断逻辑

根据教师输入的内容丰富度，自动选择合适篇幅：

输入类型	字数范围	适用场景
精简版	190-230字	输入简洁，无特别亮点
标准版	230-280字	输入有具体细节或成长亮点
详细版	280-350字	输入有精彩瞬间、多个亮点或特殊表现

字数分配（弹性）

段落	精简版	标准版	详细版	内容特点
第1段（课程知识点）	35-45字	40-50字	45-55字	准确术语，适度扩展
第2段（课堂细节）	100-130字	140-170字	170-220字	核心段落，根据亮点多少灵活扩展
第3段（课后建议）	35-45字	40-50字	45-55字	具体任务，可略详细

触发详细版的信号词

当输入中出现以下内容时，自动进入详细版（280-350字）：

• 精彩瞬间："特别棒的是"、"让我惊讶的是"、"印象深刻的是"
• 多个亮点：输入中包含3个以上的独立行为描述
• 突破性行为："第一次主动"、"从未有过"、"历史性突破"
• 技术细节：输入中有具体的编程逻辑、调试过程、错误排查
• 情感丰富：包含情绪变化、社交互动、创造性表现

示例对比

精简版（输入简洁）：

李想今天学习了循环，理解了重复执行，自己调试了三次，最后成功了，挺开心的。

输出：约210字

详细版（输入丰富）：

李想今天学习了"重复执行"循环结构，一开始设了3次发现不够，改成10次后小猫走得太快，又调整到5次加等待时间。调试过程中主动说"让我再试一次"，最后成功的时候自己鼓掌。还主动帮同桌找bug，说是"你少了结束括号"。这个分享行为是第一次出现。

输出：约310字（充分展现调试过程、坚持精神、帮助他人的亮点）

语气风格

语言特点

• 专业度：准确使用编程术语（循环、条件、事件），但不堆砌
• 平等感：像对待小学习者一样尊重，不居高临下
• 启发性：指出问题同时给方向，"这里如果换个顺序..."
• 实在感：不夸大"编程改变命运"，而是聊"今天解决了什么问题"

禁用词汇

• 小天才、未来的程序员、最聪明、秒杀同龄人
• 套话："在人工智能时代""培养计算思维"
• 夸大："掌握了编程的核心奥秘"

推荐表达

• 姓名使用：优先使用小名/昵称，其次去姓称名（如"昕乔"），平等称呼学生
• 技术描述："用'如果碰到边缘就反弹'解决了角色飞出屏幕的问题"
• 过程记录："先试了三次循环，发现次数不够，改成了重复10次"

必写模块

Emoji使用说明：小学版课评采用3段式，每段末尾添加emoji（第1段1个/第2段1-3个/第3段1个），表情根据情节自动适配，保持专业感与趣味性平衡

• 第1段（课程知识点）：💡 或 📚
• 第2段（课堂细节+成长亮点）：📈 或 💪
• 第3段（课后建议）：🏠 或 🔧

首次上课/补课说明：详见 33-first-class-rules.md

1. 课程知识点（35-55字，根据输入灵活调整）

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

• 准确术语："学习了'当按下空格键'事件和'移动10步'指令"
• 说明用途："用这些做了一个可以用键盘控制的小猫走迷宫"
• 避免空话：不说"学习了编程的基础知识"
• 扩展原则：当输入中有具体编程逻辑时，可以详细描述

示例：

• "今天接触了'重复执行'（循环），用它让小鸟持续扇翅膀，不用重复写很多次一样的代码。"
• "学习了'如果...那么'判断语句，让小猫碰到红色区域时说出'你输了'。"

2. 掌握程度（35-70字，根据输入灵活调整）

写什么：对知识点的理解和应用情况 写法：

• 具体表现："能独立搭建循环结构，但循环次数需要试几次才确定"
• 错误分析："条件判断的方向写反了，改成'碰到红色'后运行正常"
• 避免笼统：不说"掌握得不错"
• 扩展原则：当输入中有具体的调试过程、错误排查时，充分展开描述

示例：

• 简洁版："理解了循环能省事的道理，但第一次设成重复3次，发现翅膀扇得太快，调整后改成重复5次、每次等待0.2秒。"
• 详细版："循环的概念理解得很清楚，第一次设成重复3次，发现小猫走得不够远；改成10次后速度又太快了；最后调整到5次加0.2秒等待时间，终于达到理想效果。整个调试过程很耐心，尝试了3次才找到最佳参数。"

3. 课程环节与目标达成（40-80字，根据输入灵活调整）

写什么：学生在本节课各环节的表现，与课程设计目标的对应关系 写法：

• 环节参与：导入环节、新知讲解、实践操作、总结分享的参与状态
• 目标对应：本节课教学目标（知识/技能/情感）的达成情况
• 课程设计呼应：对课程活动设计的响应和投入程度
• 扩展原则：当输入中有多个环节的具体表现时，可以详细描述

示例：

• "导入环节对AI话题很感兴趣，实践环节专注完成代码调试，最后分享环节能说出循环的作用，本节课的编程目标顺利达成。"
• "在Trae Builder模式探索中投入度高，Markdown练习环节主动尝试不同排版，最后能独立完成故事设定文档。"

4. 成长亮点（35-70字，根据输入灵活调整）

写什么：编程能力的具体进步或思维方式的转变 写法：

• 思维变化："以前直接问老师，今天先试着自己改参数看效果"
• 习惯养成："开始写代码前先画流程图了"
• 迁移能力："把上节课的循环知识用到了今天的项目里"
• 扩展原则：当输入中有多个成长亮点时，充分展开描述

示例：

• "和上节课相比，今天遇到bug没有直接问，而是先尝试改了几个数字看变化，这个调试思路是对的。"
• "主动用了上节课学的注释功能，给重要的代码块加了说明，方便自己回头看。"

5. 课后建议（35-55字，根据输入灵活调整）

写什么：家长可以支持的具体方式或延伸练习 写法：

• 具体任务："可以尝试把今天的小游戏加一个新关卡"
• 生活连接："玩棋类游戏时，可以聊聊'如果...就...'的判断逻辑"
• 资源推荐："Kitten官网有类似的迷宫项目，可以看看别人的解法"
• 扩展原则：当第2段非常详细时，建议部分也可适度扩展到45-55字，给出更具体的家庭活动建议

示例：

• "今天的迷宫游戏可以在家继续完善，试试加入'吃到金币加分'的功能，需要用到变量，下节课会学。"
• "平时玩桌游时，可以和孩子聊聊规则里的'如果...就...'，这也是编程里的条件判断。"

完整示例

输入：

• 学生：李想，8岁，小学二年级
• 课程：Kitten入门-小猫走迷宫
• 表现：学习了循环和条件判断，程序调试了三次才成功，最后自己加了一个开始按钮

输出：

李想本节课学习了"重复执行"（循环）和"如果碰到颜色就..."（条件判断），用这两个概念做了一个小猫走迷宫的游戏 💡

循环的作用理解了，但第一次把循环次数设成3次，小猫走得不够远；改成10次后正常，条件判断一开始方向写反了，检查代码后发现并修正。导入环节对迷宫游戏很感兴趣，实践环节专注完成代码搭建，最后分享环节能说出循环的作用，本节课的编程目标顺利达成。和上周相比，本节课会主动给代码分区域摆放（运动放一起、外观放一起），这个整理习惯有助于后续写更复杂的程序 📈

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

---

字数：218字 | 段落：3段 | Emoji：3个