xiaoq/ClassFeedback
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
c04f1d18a67920550e8e2dd333009a8004c78083
ClassFeedback/CLAUDE.md

15 KiB
Raw Blame History

穹狼乐高编程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点/      # 4人：林瀚丞、杨佳兴、余韫、林嘉铭
│   │   ├── 发现世界-周六19点/      # 1人：赖韵恬
│   │   ├── Wedo创造世界-周六1030/  # 5人：梁家铭、简思瑜、简思霖、黄晓瑜、罗钧龄
│   │   ├── AICODE-03-周六14点/    # 5人：陈昕柔、曾乐凯、李汶浩、李欣蓉、谢善诺
│   │   ├── Wedo创造世界-周六16点/  # 3人：马悦然、郭景鸣、冯彦哲
│   │   ├── 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/

基础规则（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-02）

班级 周数 课程代码 主题 核心知识点
发现世界（周四19点） 第5周 DISC-005 天平秤 杠杆原理、平衡判断
SPIKE（周日10:30） 第5周 SPIKE-005 杯子盖球 传感器应用、精准控制
AI03（周五19点/周六14点） 第5周 AI03-005 项目整合 多AI协作、工作流设计

风格规则（20-29）

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

辅助模板（25-29）

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

操作规则（30-39）

用途 文件路径 说明
快捷输入格式 .claude/rules/30-input-format.md 极简输入，AI自动扩展
班级差异与千人千面 .claude/rules/31-class-differentiation.md 同课程不同班级/学生的差异化
批量课评生成 .claude/rules/32-batch-generation.md 一节课多学生批量生成
画像建立指南 .claude/rules/35-画像建立指南.md 建档流程+问卷+更新频率

快速入门与姓名处理（40-69）

用途 文件路径 说明
课评快速入门 .claude/rules/40-keping-快速入门.md 5分钟上手指南：单个/批量生成速查
课评称呼方式 .claude/rules/60-name-processing.md 优先级：小名＞去姓称名＞叠字称呼＞全名

输出格式规则（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-40字 兴趣度 🔍💡⚙️
2. 掌握程度 30-40字 学习表现 ✨✓📊
3. 课程环节与目标达成 40-50字 目标达成 🎯✅
4. 成长亮点 40-50字 成长发展 🌱💪📈
5. 课后建议 30-40字 延伸学习 🏠🎮🔧

段落结构（3段）

  • 第1段：课程知识点（30-40字）
  • 第2段：课堂细节长段落（掌握程度+课程环节+成长亮点，100-130字）
  • 第3段：课后建议（30-40字）
  • Emoji使用：每段末尾添加，幼儿版每段1-2个，小学版每段1个

快捷输入格式

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

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

快速示例：

/课评 日期：4月2日 班级：发现世界-周四19点
乔乔：知道这个主题，搭建快，开心
昊昊：慢热，认真，稳定

系统自动：日期→周数→课程代码→主题→生成课评

千人千面实现方式

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

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

核心策略：

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

处理流程（确认后保存模式 + 双轨存储 + 补课/体验学生支持）

教师极简输入 → AI解析学生 → 调取课程教案 → 调取班级档案 →
生成个性化课评 → 【等待教师确认】 → 确认后双轨保存 → 发送家长
                                    ↓
                         ┌──────────┴──────────┐
                         ↓                     ↓
              班级周汇总.md              个人历史课评.md
   (class-evaluation-summary/)           (student/)

存储双轨制

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

补课/体验学生特殊处理

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

处理流程：

  1. 检测：AI自动检测 memory/student/{班级}/{学生}/ 是否存在
  2. 提醒：生成前提醒教师该学生无档案
  3. 选择：
    • 创建档案：为该学生建立完整档案，执行双轨保存
    • 仅保存到班级汇总：不创建个人档案，仅保存在班级周汇总

示例：

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

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

AI提醒：该学生可能是补课/体验学生，请选择：
[1] 创建档案（补课/新学生）
[2] 仅保留在班级汇总（体验课学生）

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

使用说明

  1. 输入课评需求：提供日期、班级、学生表现（自然语言即可）
  2. AI自动生成：按风格规则生成5模块课评（200-300字）
  3. 暂存班级汇总：课评首先暂存到 class-evaluation-summary/第X周/{班级}.md（待确认状态）
  4. 教师审核确认：检查内容是否准确，称呼是否正确
  5. 确认后双轨保存：回复"确认"或"保存"，AI同时保存到班级汇总和个人档案
  6. 发送家长：从学生目录获取最终版本发送

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

版本

v1.4 | 2026-04-16 | 新增补课/体验学生处理，支持仅保存到班级周汇总 | 穹狼教学团队
v1.3 | 2026-04-04 | 新增"确认后保存"流程，优化课评生成体验 | 穹狼教学团队

Reference in New Issue View Git Blame Copy Permalink