ClassFeedback/CLAUDE.md

穹狼乐高编程AI课评生成系统

为2.5岁-小学4年级学生自动生成个性化课程评价

项目架构

小Q的课评反馈系统/
├── claude.md                   # 本文件：全局索引与快速入口
├── .claude/                    # 配置目录
│   ├── rules/                  # 规则配置（核心）
│   │   ├── 00-system.md        # 系统基础规则：角色定义、核心原则、约束条件、输出格式
│   │   ├── 01-student-ages.md  # 年龄段规则：托/小/中/大班、小学低/中年级定义
│   │   ├── 02-course-types.md  # 课程类型规则：7种课程类型
│   │   ├── 03-evaluation-dimensions.md  # 评价维度：5大维度20+指标
│   │   ├── 06-scoring.md       # 评分标准：五级评分制
│   │   ├── 15-semester-weeks.md    # **学期周数与主题映射：20周课程安排**
│   │   ├── 20-style-building.md    # 风格①：幼儿积木搭建（180-220字）
│   │   ├── 21-style-coding.md      # 风格②：少儿编程入门（190-230字）
│   │   ├── 22-style-robotics.md    # 风格③：机器人竞赛（200-240字）
│   │   ├── 25-template-preschool-detailed.md  # 辅助模板：学龄前详细课评模板（手动撰写版）
│   │   ├── 30-input-format.md      # 操作①：快捷输入格式（极简输入）
│   │   ├── 31-class-differentiation.md  # 操作②：班级差异与千人千面
│   │   └── 32-batch-generation.md   # 操作③：批量课评生成
│   ├── prompts/                # 提示词模板（预留）
│   └── output/                 # 输出生成目录（预留）
├── memory/                     # 记忆存储目录
│   ├── lesson/                 # 课程教案库（本学期6门课程）
│   │   ├── 00-意识世界-管道/       # TUBE-001~999 (托班 9076+9090)
│   │   ├── 01-发现世界-螺丝刀/     # DISC-001~999 (小班 45002)
│   │   ├── 02-发明世界-智能笔/     # INVENT-001~999 (中班 威儿2+9656)
│   │   ├── 03-创造世界-WEDO/       # CREATE-001~999 (大班 WEDO)
│   │   ├── 08-SPIKE/              # SPIKE-001~999 (一年级)
│   │   ├── 09-AI03-AICODE/         # AI03-001~999 (四年级)
│   │   ├── 2026春季学期课程总览.md  # 本学期授课计划
│   │   └── README.md              # 课程存储规范
│   ├── student/                # 学生档案（小Q老师33名学生）
│   │   ├── 发现世界-周四19点/      # 2人：梁昕乔、钟昀昊
│   │   ├── AICODE-03-周五19点/    # 3人：李怡瞳、沙佩琪、黄榆斐
│   │   ├── 发现世界-周六09点/      # 5人：林瀚丞、杨佳兴、余韫（袋袋）、林嘉铭、胡翰铭
│   │   ├── 发现世界-周六19点/      # 1人：赖韵恬
│   │   ├── Wedo创造世界-周六1030/  # 6人：梁家铭、简思瑜、简思霖、黄晓瑜、罗钧龄、黄馨宸
│   │   ├── AICODE-03-周六14点/    # 6人：陈昕柔、曾乐凯、李汶浩、李欣蓉、谢善诺、俊博
│   │   ├── Wedo创造世界-周六16点/  # **4人**：马悦然、郭景鸣、冯彦哲、胡悦珩
│   │   ├── SPIKE02-周日1030/       # 7人：吴浩洋、吴浩骏、王骏诚、洪一栩、邓琬曦、邓琬颖、方柳莫
│   │   ├── 用户画像模板.md
│   │   ├── 历史课评记录模板.md
│   │   ├── 成长素材模板.md
│   │   └── README.md              # 学生档案说明
│   ├── class-evaluation-summary/   # **班级周汇总（新增）- 按周期分班级**
│   │   ├── 第7周/                   # 当前周期文件夹
│   │   │   ├── 发现世界-周四19点.md  # 班级当周课评汇总
│   │   │   ├── 发现世界-周六09点.md
│   │   │   └── ...                  # 8个班级各一个文件
│   │   └── README.md                # 汇总使用说明
│   └── 教育理念.md              # 核心教育观+6门课程发展目标
├── src/                        # 源代码目录（预留）
│   ├── input-parser/           # 输入解析模块
│   ├── evaluation-engine/      # 评价生成引擎
│   └── output-generator/       # 输出生成器
└── data/                       # 数据目录（预留）
    ├── students/               # 学生信息
    ├── courses/                # 课程信息
    └── templates/              # 历史模板

快速入口

核心文档

文档	文件路径
教育理念	memory/教育理念.md
课程教案规范	memory/lesson/README.md
2026春季学期课程总览	memory/lesson/2026春季学期课程总览.md
学生档案总览	memory/student/README.md
班级周汇总	memory/class-evaluation-summary/
班级学期总览	模板-班级学期总览.md
个人成长时间线	模板-成长时间线.md

基础规则（00-09）

用途	文件路径
系统核心规则	.claude/rules/00-system.md
年龄段分类	.claude/rules/01-student-ages.md
课程类型定义	.claude/rules/02-course-types.md
评价维度指标	.claude/rules/03-evaluation-dimensions.md
学期周数与主题	.claude/rules/15-semester-weeks.md
评分标准体系	.claude/rules/06-scoring.md

当前周信息速查（2026-04-25）

班级	周数	课程代码	主题	核心知识点
发现世界（周四19点）	第8周	DISC-008	蜥蜴	关节连接、可动结构、仿生设计
SPIKE（周日10:30）	第8周	SPIKE-008	留声机	记录播放、循环结构、复古设计
AI03（周五19点/周六14点）	第8周	AI03-008	我的个人主页（上）	内容先行、板块化设计、自定义智能体

风格规则（20-29）

课程类型	文件路径	字数	适用年龄
幼儿积木搭建	.claude/rules/20-style-building.md	弹性：180-320字	2.5-6岁
少儿编程入门	.claude/rules/21-style-coding.md	弹性：190-350字	6-10岁
机器人竞赛	.claude/rules/22-style-robotics.md	弹性：200-400字	8-10岁

辅助模板（25-29）

用途	文件路径	说明
学龄前详细模板	.claude/rules/25-template-preschool-detailed.md	教师手动撰写参考（300-400字详细版）

操作规则（30-39，优化版）

用途	文件路径	说明	版本
快捷输入格式	.claude/rules/30-input-format.md	极简输入+速记符号+标记驱动	v4.0优化
班级差异与千人千面	.claude/rules/31-class-differentiation.md	同课程不同班级/学生的差异化	v1.0
批量课评生成	.claude/rules/32-batch-generation.md	批量一键确认+自动质量检查	v2.0优化
新学生/补课处理	.claude/rules/33-first-class-rules.md	首次上课与补课学生标记规则	v1.1优化
速记阶梯学习	.claude/rules/36-shorthand-learning.md	三级速记+智能推荐	v1.0新增
状态管理面板	.claude/rules/37-status-panel.md	待确认可视化+自动提醒	v1.0新增
快速编辑功能	.claude/rules/38-quick-edit.md	小修改直接编辑	v1.0新增
画像建立指南	.claude/rules/35-画像建立指南.md	建档流程+问卷+更新频率	v1.0

快速入门与姓名处理（40-69，优化版）

用途	文件路径	说明	版本
课评快速入门	.claude/rules/40-keping-快速入门.md	3分钟上手指南：速记符号+批量一键确认	v3.0优化
课评称呼方式	.claude/rules/60-name-processing.md	优先级：小名＞去姓称名＞叠字称呼＞全名	v1.1

输出格式规则（50-59）

课程名称	班级	教具套装	时长	目录
意识世界	小小班（托班）	乐高9076+9090管道	60分钟	00-意识世界-管道/
发现世界	小班	乐高45002螺丝刀	60分钟	01-发现世界-螺丝刀/
发明世界	中班	威儿2+乐高9656	90分钟	02-发明世界-智能笔/
创造世界	大班	WEDO套装	90分钟	03-创造世界-WEDO/
SPIKE	一年级	SPIKE-PRIME科创	90分钟	08-SPIKE/
AI03	四年级	AICODE03平台	90分钟	09-AI03-AICODE/

核心规则速查

年龄段代码

代码	学段	年龄	课程
AGE_TB	托班	2.5-3岁	意识世界（管道）
AGE_XB	小班	3-4岁	发现世界（螺丝刀）
AGE_ZB	中班	4-5岁	发明世界（智能笔）
AGE_DB	大班	5-6岁	创造世界（WEDO）
AGE_PS_LOW	小学低年级	6-8岁	SPIKE
AGE_PS_MID	小学中年级	8-10岁	AI03

课程代码

代码	类型	班级	教具
TUBE	管道探索	小小班	9076+9090
DISC	工具发现	小班	45002
INVENT	智能笔编程	中班	威儿2+9656
CREATE	WEDO编程	大班	WEDO
SPIKE	SPIKE编程	一年级	SPIKE-PRIME
AI03	AI协作开发	四年级	AICODE03

课程时长标准

班级	时长	说明
托班、小班	60分钟	含导入+探索+引导+总结
中班及以上	90分钟	含项目展示/调试时间

评分等级

分值	等级	评级
4.5-5.0	优秀	A+
3.5-4.4	良好	A/A-

课评模板结构（5模块覆盖3维度）

重要说明：学期周数仅用于后端自动匹配课程主题，课评正文不显示"第几周"

详细写作规则参见风格规则文件（20/21/22-style-building/coding/robotics.md）

五模块速查

模块	字数范围	核心维度	Emoji
1. 课程知识点	30-50字（弹性）	兴趣度	🔍💡⚙️
2. 掌握程度	30-70字（弹性）	学习表现	✨✓📊
3. 课程环节与目标达成	40-80字（弹性）	目标达成	🎯✅
4. 成长亮点	40-70字（弹性）	成长发展	🌱💪📈
5. 课后建议	30-50字（弹性）	延伸学习	🏠🎮🔧

段落结构（3段，字数弹性）

• 第1段：课程知识点（30-50字）
• 第2段：课堂细节长段落（掌握程度+课程环节+成长亮点，100-220字，根据输入丰富度灵活扩展）
• 第3段：课后建议（30-50字）
• 字数弹性原则：输入越丰富，课评越详细（精简版180-220字/标准版220-280字/详细版280-350字）
• Emoji使用：每段末尾添加，幼儿版每段1-2个，小学版每段1个

---

快捷输入格式（v4.0优化版）

支持极简输入、速记符号、自然语言、批量表格等多种方式。

详细规则：参见 .claude/rules/30-input-format.md

速记符号速查

速记	含义	示例
gj5	观望5分钟	gj5→zd3→zt
zd3	主动搭3层	观望→主动搭3层→自己调整
↑	开心	↑++ = 开心，比上周进步
[体验]	体验课学生	张小明[体验]
[补课]	补课学生	李小红[补课]

快速示例

/课评 班级：发现世界-周四19点
乔乔：gj5→zd3→zt ↑++
昊昊：慢热→zd3→反复调 →
小明[体验]：搭3层 ↑

系统自动：解析速记→匹配课程→生成课评→自动保存

千人千面实现方式

输入时标记班级和学生特点，AI自动差异化生成。

详细规则：参见 .claude/rules/31-class-differentiation.md

核心策略：

• 班级维度：谨慎班侧重鼓励尝试，活跃班侧重专注力
• 学生维度：谨慎型侧重勇气，活跃型侧重坚持
• 历史维度：自动对比上节课表现

处理流程（优化后：并行生成 + 批量确认 + 自动双轨保存）

教师极简输入 → AI并行解析 → 预加载课程/档案 → 
并行生成个性化课评 → 自动保存班级汇总 → 质量检查 → 
【教师批量确认】 → 自动双轨保存 → 发送家长
                              ↓
                      [一键发送] [标记修改] [取消]

存储双轨制（自动保存）

存储位置	用途	使用场景	自动/手动
class-evaluation-summary/第X周/{班级}.md	班级视角：每周全班课评汇总	周回顾、班级分析、备课参考	自动生成
student/{班级}/{学生}/历史课评记录.md	个人视角：学生完整课评历程	家长沟通、学期总结、成长追踪	确认后自动

学生类型自动处理（更新）

类型	标记	处理方式	保存位置
正式学生	无标记	自动双轨保存	班级+个人
补课学生（自己班级）	[补课] + 当前班级档案存在	自动双轨保存	班级+个人
补课学生（其他班级）	[补课] + 当前班级档案不存在	询问后决定	班级+（可选）个人
体验学生	[体验]	仅班级汇总	仅班级
缺课学生	[缺课]	记录缺席	仅班级

[补课]学生处理逻辑（关键更新）：

当学生标记[补课]时：
1. 先检查 memory/student/{当前班级}/{学生名}/ 是否存在
2. 如存在 → 该学生为本班级补课 → 正常双轨保存
3. 如不存在 → 可能是其他老师班级学生 → 询问处理方式
   [1] 仅保存到班级汇总（其他老师学生）
   [2] 创建档案（新转班学生）

补课/体验学生特殊处理（更新后）

当检测到学生无个人档案时（补课/体验学生）：

处理流程：

1. 检测：AI自动检测 memory/student/{当前班级}/{学生}/ 是否存在
2. 分支处理：
   • 存在 → 该学生为本班级补课学生 → 正常双轨保存
   • 不存在 → 可能是其他老师班级学生 → 询问处理方式
3. 询问选择（仅档案不存在时）：
   • 仅保存到班级汇总：其他老师班级学生来补课
   • 创建档案：新转班学生或后续会长期跟随

示例1（自己班级补课学生）：

教师输入：班级：发现世界-周四19点，乔乔[补课]：搭了3层，开心

AI检测：✅ 找到「乔乔」在本班级的个人档案

AI处理：按正式学生处理 → 双轨保存
→ 课评保存到「第7周/发现世界-周四19点.md」
→ 同时追加到「student/发现世界-周四19点/乔乔/历史课评记录.md」

示例2（其他老师班级补课学生）：

教师输入：班级：发现世界-周四19点，张小明[补课]：搭了3层，开心

AI检测：⚠️ 未找到「张小明」在本班级的个人档案

AI提醒：该学生标记为[补课]，但不在本班级学生名单中。

可能情况：
[1] 其他老师的学生来补课 → 仅保存到班级汇总
[2] 新转班学生 → 创建个人档案（双轨保存）

教师选择 [1]
→ 课评仅保存到「第7周/发现世界-周四19点.md」
→ 标记为：张小明（其他班级补课学生，无个人档案）

使用说明（优化后）

1. 指定班级（一次即可）：班级：发现世界-周四19点
2. 输入课评需求：使用自然语言或速记符号描述学生表现
   • 简洁输入 → 生成精简版（约200字）
   • 详细输入 → 生成详细版（约280字）
3. 标记学生类型：[补课] [体验] [缺课] 等标记
4. AI并行生成：自动生成所有课评 + 自动质量检查
5. 自动保存班级汇总：课评首先自动保存到 class-evaluation-summary/第X周/{班级}.md
6. 教师批量确认：查看质量报告，一键确认或标记修改
7. 自动双轨保存：确认后自动保存到班级汇总和个人档案
8. 发送家长：从学生目录获取最终版本发送

确认指令："确认"、"保存"、"没问题"、"可以了"、"[全部发送]"
修改指令：直接指出修改意见，AI将重新生成

快速上手指令

# Step 1: 指定班级（一次）
/课评 班级：发现世界-周四19点

# Step 2: 批量输入（速记符号）
乔乔：gj5→zd3→zt ↑++
昊昊：慢热→zd3→反复调 →
小明[体验]：搭3层 ↑

# Step 3: 一键确认
[全部发送]

---

版本历史

详见 CHANGELOG.md