274 lines
15 KiB
Markdown
274 lines
15 KiB
Markdown
# 穹狼乐高编程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/教育理念.md) |
|
||
| 课程教案规范 | [`memory/lesson/README.md`](memory/lesson/README.md) |
|
||
| 2026春季学期课程总览 | [`memory/lesson/2026春季学期课程总览.md`](memory/lesson/2026春季学期课程总览.md) |
|
||
| **学生档案总览** | [`memory/student/README.md`](memory/student/README.md) |
|
||
| **班级周汇总** | [**`memory/class-evaluation-summary/`**](./memory/class-evaluation-summary/README.md) | **新增**：每周班级课评汇总 |
|
||
### 基础规则（00-09）
|
||
| 用途 | 文件路径 |
|
||
|------|---------|
|
||
| 系统核心规则 | [`.claude/rules/00-system.md`](.claude/rules/00-system.md) |
|
||
| 年龄段分类 | [`.claude/rules/01-student-ages.md`](.claude/rules/01-student-ages.md) |
|
||
| 课程类型定义 | [`.claude/rules/02-course-types.md`](.claude/rules/02-course-types.md) |
|
||
| 评价维度指标 | [`.claude/rules/03-evaluation-dimensions.md`](.claude/rules/03-evaluation-dimensions.md) |
|
||
| **学期周数与主题** | [`.claude/rules/15-semester-weeks.md`](.claude/rules/15-semester-weeks.md) | **仅后端使用**：周数用于自动匹配课程代码和主题，课评正文不显示周数 |
|
||
| 评分标准体系 | [`.claude/rules/06-scoring.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`](.claude/rules/20-style-building.md) | 180-220字 | 2.5-6岁 |
|
||
| 少儿编程入门 | [`.claude/rules/21-style-coding.md`](.claude/rules/21-style-coding.md) | 190-230字 | 6-10岁 |
|
||
| 机器人竞赛 | [`.claude/rules/22-style-robotics.md`](.claude/rules/22-style-robotics.md) | 200-240字 | 8-10岁 |
|
||
|
||
### 辅助模板（25-29）
|
||
| 用途 | 文件路径 | 说明 |
|
||
|------|---------|------|
|
||
| 学龄前详细模板 | [`.claude/rules/25-template-preschool-detailed.md`](.claude/rules/25-template-preschool-detailed.md) | 教师手动撰写参考（300-400字详细版）|
|
||
|
||
### 操作规则（30-39）
|
||
| 用途 | 文件路径 | 说明 |
|
||
|------|---------|------|
|
||
| 快捷输入格式 | [`.claude/rules/30-input-format.md`](.claude/rules/30-input-format.md) | 极简输入，AI自动扩展 |
|
||
| 班级差异与千人千面 | [`.claude/rules/31-class-differentiation.md`](.claude/rules/31-class-differentiation.md) | 同课程不同班级/学生的差异化 |
|
||
| 批量课评生成 | [`.claude/rules/32-batch-generation.md`](.claude/rules/32-batch-generation.md) | 一节课多学生批量生成 |
|
||
| **画像建立指南** | [`.claude/rules/35-画像建立指南.md`](.claude/rules/35-画像建立指南.md) | **建档流程**+问卷+更新频率 |
|
||
|
||
### 快速入门与姓名处理（40-69）
|
||
| 用途 | 文件路径 | 说明 |
|
||
|------|---------|------|
|
||
| **课评快速入门** | [`.claude/rules/40-keping-快速入门.md`](.claude/rules/40-keping-快速入门.md) | **5分钟上手指南**：单个/批量生成速查 |
|
||
| 课评称呼方式 | [`.claude/rules/60-name-processing.md`](.claude/rules/60-name-processing.md) | **优先级**：小名＞去姓称名＞叠字称呼＞全名 |
|
||
|
||
### 输出格式规则（50-59）
|
||
| 课程名称 | 班级 | 教具套装 | 时长 | 目录 |
|
||
|---------|------|---------|------|------|
|
||
| 意识世界 | 小小班（托班） | 乐高9076+9090管道 | **60分钟** | [`00-意识世界-管道/`](memory/lesson/00-意识世界-管道/) |
|
||
| 发现世界 | 小班 | 乐高45002螺丝刀 | **60分钟** | [`01-发现世界-螺丝刀/`](memory/lesson/01-发现世界-螺丝刀/) |
|
||
| 发明世界 | 中班 | 威儿2+乐高9656 | **90分钟** | [`02-发明世界-智能笔/`](memory/lesson/02-发明世界-智能笔/) |
|
||
| 创造世界 | 大班 | WEDO套装 | **90分钟** | [`03-创造世界-WEDO/`](memory/lesson/03-创造世界-WEDO/) |
|
||
| SPIKE | 一年级 | SPIKE-PRIME科创 | **90分钟** | [`08-SPIKE/`](memory/lesson/08-SPIKE/) |
|
||
| AI03 | 四年级 | AICODE03平台 | **90分钟** | [`09-AI03-AICODE/`](memory/lesson/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`](.claude/rules/30-input-format.md)
|
||
|
||
**快速示例**：
|
||
```
|
||
/课评 日期：4月2日 班级：发现世界-周四19点
|
||
乔乔：知道这个主题，搭建快，开心
|
||
昊昊：慢热，认真，稳定
|
||
```
|
||
**系统自动**：日期→周数→课程代码→主题→生成课评
|
||
|
||
## 千人千面实现方式
|
||
|
||
输入时标记班级和学生特点，AI自动差异化生成。
|
||
|
||
**详细规则**：参见 [`.claude/rules/31-class-differentiation.md`](.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 | 新增"确认后保存"流程，优化课评生成体验 | 穹狼教学团队
|