初始化课评系统仓库：包含规则配置、学生档案、课程教案、班级汇总

2026-05-08 14:15:00 +08:00
commit 16af260a11
300 changed files with 30338 additions and 0 deletions
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -0,0 +1,193 @@
+# 穹狼乐高编程AI课评生成系统
+
+> 为2.5岁-小学4年级学生自动生成个性化课程评价
+> 版本：v3.1（精简版）| 规则文件：5个核心文件
+
+---
+
+## 项目架构
+
+```
+classfeedback/
+├── CLAUDE.md                   # 本文件：全局索引与快速入口
+├── .claude/
+│   ├── rules/                  # 规则配置（精简为5个核心文件）
+│   │   ├── 00-core.md          # 系统基础+年龄段+课程类型+评价维度+评分标准
+│   │   ├── 10-style.md         # 写作风格+三段式结构+Emoji+输入丰富度评估
+│   │   ├── 20-workflow.md      # 输入格式+批量生成+存储规则+速记符号
+│   │   ├── 30-student.md       # 画像建立+千人千面+姓名处理
+│   │   ├── 50-output-format-preschool.md   # 学龄前输出格式
+│   │   ├── 51-output-format-elementary.md  # 小学输出格式
+│   │   └── 90-archive/         # 已合并的旧规则文件备份
+│   ├── skills/                 # 技能配置
+│   └── settings.json           # 设置
+├── memory/
+│   ├── lesson/                 # 课程教案库
+│   ├── student/                # 学生档案
+│   ├── class-evaluation-summary/  # 班级周汇总
+│   └── 教育理念.md
+└── src/
+    └── evaluation_validator.py # 课评质量验证脚本
+```
+
+---
+
+## 快速入口
+
+### 核心规则文件
+
+| 文件 | 内容 | 路径 |
+|------|------|------|
+| **核心规则** | 系统角色、年龄段、课程类型、评价维度、评分标准 | [`.claude/rules/00-core.md`](.claude/rules/00-core.md) |
+| **风格规则** | 三段式结构、语气风格、Emoji使用、字数弹性 | [`.claude/rules/10-style.md`](.claude/rules/10-style.md) |
+| **工作流程** | 输入格式、批量生成、存储规则、速记符号、补课处理 | [`.claude/rules/20-workflow.md`](.claude/rules/20-workflow.md) |
+| **学生管理** | 画像建立、千人千面、姓名处理 | [`.claude/rules/30-student.md`](.claude/rules/30-student.md) |
+
+### 记忆存储
+
+| 用途 | 路径 |
+|------|------|
+| 教育理念 | [`memory/教育理念.md`](memory/教育理念.md) |
+| 课程教案库 | [`memory/lesson/README.md`](memory/lesson/README.md) |
+| 学期课程总览 | [`memory/lesson/2026春季学期课程总览.md`](memory/lesson/2026春季学期课程总览.md) |
+| 学生档案总览 | [`memory/student/README.md`](memory/student/README.md) |
+| 班级周汇总 | [`memory/class-evaluation-summary/README.md`](memory/class-evaluation-summary/README.md) |
+| 班级学期总览 | [`memory/class-evaluation-summary/模板-班级学期总览.md`](memory/class-evaluation-summary/模板-班级学期总览.md) |
+| 个人成长时间线 | [`memory/student/模板-成长时间线.md`](memory/student/模板-成长时间线.md) |
+
+---
+
+## 核心规则速查
+
+### 年龄段代码
+
+| 代码 | 学段 | 年龄 | 课程 |
+|-----|------|-----|------|
+| `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 |
+
+### 评分等级
+
+| 分值 | 等级 | 评级 |
+|-----|------|-----|
+| 4.5-5.0 | 优秀 | A+ |
+| 3.5-4.4 | 良好 | A/A- |
+| 2.5-3.4 | 合格 | B/B+ |
+| 1.5-2.4 | 待改进 | C |
+| 1.0-1.4 | 需帮助 | D |
+
+---
+
+## 课评模板结构（5模块覆盖3维度）
+
+### 三段式结构
+
+| 段落 | 内容 | 字数 | Emoji |
+|------|------|:----:|:-----:|
+| **第1段** | 课程知识点 | 30-55字 | 1个（🔍/💡/⚙️根据内容） |
+| **第2段** | 课堂细节（掌握+环节+亮点）| 100-220字 | 1-3个（根据情节自动适配） |
+| **第3段** | 课后建议 | 30-55字 | 1个（🏠/🔧根据内容） |
+
+### 字数弹性
+
+| 输入类型 | 输出字数 | 说明 |
+|---------|:-------:|:----|
+| 精简输入 | 180-220字 | 基础描述 |
+| 标准输入 | 220-280字 | 有具体细节 |
+| 详细输入 | 280-350字 | 多个亮点 |
+
+---
+
+## 快捷输入速查
+
+### 速记符号
+
+| 速记 | 含义 | 示例 |
+|------|------|------|
+| `gj#` | 观望#分钟 | `gj5` |
+| `zd#` | 主动搭#层 | `zd3` |
+| `zt` | 自己调整 | - |
+| `↑` | 开心 | `↑++` |
+| `→` | 稳定 | - |
+| `++` | 比上周进步 | - |
+
+### 学生标记
+
+| 标记 | 含义 | 保存方式 |
+|------|------|---------|
+| `[补课]` | 补课学生 | 双轨保存（跨班级自动处理） |
+| `[体验]` | 体验课学生 | 仅班级汇总 |
+| `[缺课]` | 今天缺席 | 仅记录缺席 |
+| `[new]` | 新学生首次 | 创建档案，双轨保存 |
+
+### 快速示例
+
+```
+/课评 班级：发现世界-周四19点
+
+乔乔：gj5→zd3→zt ↑++
+昊昊：慢热→zd3→反复调 →
+小明[体验]：搭3层 ↑
+```
+
+---
+
+## 处理流程
+
+```
+教师极简输入 → AI解析 → 生成个性化课评 → 【自动双轨保存】
+                                                    ↓
+                                          班级汇总（含出勤） + 个人档案
+                                                    ↓
+                                         教师可随时查看/修改（无需确认）
+```
+
+> **自动双轨保存机制**：课评生成后立即自动保存到班级汇总和个人档案，无需教师确认。出勤信息直接体现在班级汇总中。详细规则参见 [20-workflow.md](.claude/rules/20-workflow.md) 第10节。
+
+### 存储双轨制
+
+| 存储位置 | 路径 | 用途 | 保存时机 |
+|---------|------|------|:--------:|
+| 班级周汇总 | `memory/class-evaluation-summary/第X周/{班级}.md` | 每周全班课评汇总（含出勤） | 生成后立即自动保存 |
+| 个人档案 | `memory/student/{班级}/{学生名}/历史课评记录.md` | 个人完整轨迹（时间倒序，最新在上） | 生成后立即自动保存（如有档案） |
+
+### 学生出勤状态（嵌入班级汇总）
+
+| 状态 | 图标 | 判定规则 |
+|:-----|:----:|:---------|
+| **出勤** | ✅ | 有档案 + 已生成课评 |
+| **缺课** | ❌ | 有档案 + 未生成课评 |
+| **补课** | 🔄 | 他班档案 + 来本班上课 |
+| **体验/临时** | 📝 | 无档案 + 已生成课评 |
+
+### 快捷指令
+
+| 指令 | 功能 |
+|:-----|:-----|
+| `查看出勤` | 查看本周各班级出勤（读取汇总头部） |
+| `修改{学生名}：把"A"改为"B"` | 修改课评内容（自动同步到两个位置） |
+| `重生成{学生名}` | 重新生成课评并保存 |
+
+---
+
+## 版本历史
+
+- **v3.1** | 2026-05-05 | 简化保存流程：删除"待确认"状态，改为"生成即双轨保存"；出勤嵌入班级汇总
+- **v2.5** | 2026-05-01 | 统一字数弹性范围180-350字
+- **v2.0** | 2026-04-17 | 批量生成优化，双轨保存
+- **v1.0** | 2026-03-25 | 初始版本