xiaoq/ClassFeedback
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

同步课评规范V1.0 v4.0：课程编号规范、目录结构、完成率统计规则

Browse Source 
- 课程编号：CSP (C++) / AICODE (AI编程)，必须与校宝一致
- 目录结构：.claude/memory/class/{班级}/{学生}/feedback/YYYYMMDD_课程编号-课次.md
- 文件命名：(请假)/(补课-去班级名) 后缀标记
- 完成率统计：三级查找规则（本班级→跨班级补课→其他老师仓库）
- keping-advanced skill 完整重写至 v4.0
- 所有 AI03 → AICODE03，所有 memory/student/ → .claude/memory/class/
This commit is contained in:
qiuyan
2026-05-14 13:41:26 +08:00
parent 079a09d743
commit bfc69267f6
12 changed files with 612 additions and 447 deletions
Download Patch File Download Diff File Expand all files Collapse all files

98
CLAUDE.md
View File

@@ -1,7 +1,9 @@
# 穹狼乐高编程AI课评生成系统
> 为2.5岁-小学4年级学生自动生成个性化课程评价
> 版本：v3.2（精简版）| 规则文件：9个核心文件 + 20个归档规则
> 版本：v4.0（课评规范同步版）| 规则文件：9个核心文件 + 20个归档规则
>
> **合规说明**：本仓库已同步 [课评规范V1.0](课评规范V1.0.md) 全部要求，包括课程编号规范、目录结构规范、课评文件命名规范、课评完成率统计规则。确保自动统计系统可正确识别到课评。
---
@@ -41,12 +43,26 @@ classfeedback/
│ │ ├── 40-keping-快速入门.md # 快速入门（v2.5旧版，已废弃）
│ │ ├── 60-name-processing.md # 姓名处理（已合并至30-student）
│ │ └── 70-common-structures.md # 通用结构（已合并至10-style）
│ ├── memory/ # 记忆数据目录（课评规范标准路径）
│ │ ├── class/ # 【班级数据 - 核心课评目录】
│ │ │ ├── {班级名称}/ # 命名：{课程编号}{老师}{时间}（如AICODE03小Q周五1900）
│ │ │ │ ├── summaries/ # 班级总结/群发文案
│ │ │ │ ├── {学生姓名}/ # 学生个人目录
│ │ │ │ │ ├── feedback/ # 【个人课评目录】
│ │ │ │ │ │ └── YYYYMMDD_课程编号-课次.md
│ │ │ │ │ └── profile.md # 学生画像
│ │ │ │ └── 补课/ # 补课学生专用目录
│ │ │ │ └── {学生姓名}/
│ │ │ │ └── feedback/
│ │ │ │ └── YYYYMMDD_课程编号.md
│ │ │ └── ...
│ │ └── lesson/ # 课程大纲（从独立仓库同步，不提交远端）
│ ├── skills/ # 技能配置
│ └── settings.json # 设置
├── memory/
│ ├── lesson/ # 课程教案库
│ ├── student/ # 学生档案
│ ├── class-evaluation-summary/ # 班级周汇总
├── memory/ # 历史数据（过渡期保留）
│ ├── lesson/ # 课程教案库（历史）
│ ├── student/ # 学生档案（历史）
│ ├── class-evaluation-summary/ # 班级周汇总（历史）
│ └── 教育理念.md
└── src/
└── evaluation_validator.py # 课评质量验证脚本
@@ -72,15 +88,17 @@ classfeedback/
### 记忆存储
| 用途 | 路径 |
|------|------|
| 教育理念 | [`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) |
| 用途 | 标准路径（课评规范） | 说明 |
|------|---------------------|------|
| 课评文件（新） | [`.claude/memory/class/{班级}/{学生}/feedback/`](.claude/memory/class/) | **单次单文件** `YYYYMMDD_课程编号-课次.md` |
| 学生画像（新） | [`.claude/memory/class/{班级}/{学生}/profile.md`](.claude/memory/class/) | 个人画像，固定文件名 |
| 班级总结（新） | [`.claude/memory/class/{班级}/summaries/`](.claude/memory/class/) | 班级群发文案/反馈 |
| 补课学生（新） | [`.claude/memory/class/{班级}/补课/{学生}/feedback/`](.claude/memory/class/) | 跨班级补课课评 |
| 教育理念 | [`memory/教育理念.md`](memory/教育理念.md) | 历史数据，过渡保留 |
| 课程教案库 | [`memory/lesson/`](memory/lesson/) | 历史数据，过渡保留 |
| 学期课程总览 | [`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) | 历史数据，过渡保留 |
---
@@ -95,18 +113,21 @@ classfeedback/
| `AGE_ZB` | 中班 | 4-5岁 | 发明世界（智能笔） |
| `AGE_DB` | 大班 | 5-6岁 | 创造世界（WEDO） |
| `AGE_PS_LOW` | 小学低年级 | 6-8岁 | SPIKE |
| `AGE_PS_MID` | 小学中年级 | 8-10岁 | AI03 |
| `AGE_PS_MID` | 小学中年级 | 8-10岁 | AICODE03 |
### 课程代码
| 代码 | 类型 | 班级 | 教具 |
|-----|------|------|------|
| `TUBE` | 管道探索 | 小小班 | 9076+9090 |
| `DISC` | 工具发现 | 小班 | 45002 |
| `INVENT` | 智能笔编程 | 中班 | 威儿2+9656 |
| `CREATE` | WEDO编程 | 大班 | WEDO |
| `SPIKE` | SPIKE编程 | 一年级 | SPIKE-PRIME |
| `AI03` | AI协作开发 | 四年级 | AICODE03 |
| 代码 | 类型 | 班级 | 教具 | 校宝对应 |
|-----|------|------|------|---------|
| `TUBE` | 管道探索 | 小小班 | 9076+9090 | - |
| `DISC` | 工具发现 | 小班 | 45002 | - |
| `INVENT` | 智能笔编程 | 中班 | 威儿2+9656 | - |
| `CREATE` | WEDO编程 | 大班 | WEDO | - |
| `SPIKE` | SPIKE编程 | 一年级 | SPIKE-PRIME | - |
| `AICODE03` | AI协作开发 | 四年级 | AICODE03 | ✅ AICODE03AI编程创新课03 |
| `CSP` | C++信息学奥赛 | - | - | ✅ CSP01-05（校宝标准编号） |
> **重要**：课程编号必须与校宝排课系统中的 `class_name` 一致。C++班统一用 `CSP`，AI编程班统一用 `AICODE`+编号，不得使用 `AI`、`C++`、`信奥` 等缩写。详见 [20-workflow.md 第10节](.claude/rules/20-workflow.md) 课评规范对照。
### 评分等级
@@ -184,14 +205,32 @@ classfeedback/
教师可随时查看/修改（无需确认）
```
> **自动双轨保存机制**：课评生成后立即自动保存到班级汇总和个人档案，无需教师确认。出勤信息直接体现在班级汇总中。详细规则参见 [20-workflow.md](.claude/rules/20-workflow.md) 第10节。
> **自动双轨保存机制**：课评生成后立即自动保存到班级汇总和个人档案，无需教师确认。出勤信息直接体现在班级汇总中。详细规则参见 [20-workflow.md](.claude/rules/20-workflow.md)。
### 存储双轨制
### 存储双轨制（新规范）
| 存储位置 | 路径 | 用途 | 保存时机 |
|---------|------|------|:--------:|
| 班级周汇总 | `memory/class-evaluation-summary/第X周/{班级}.md` | 每周全班课评汇总（含出勤） | 生成后立即自动保存 |
| 个人档案 | `memory/student/{班级}/{学生名}/历史课评记录.md` | 个人完整轨迹（时间倒序，最新在上） | 生成后立即自动保存（如有档案） |
> 课评规范V1.0要求：课评必须按次按学生单独文件，**不可用汇总文件代替单次课评**。
| 存储位置 | 标准路径 | 用途 | 保存时机 |
|---------|---------|------|:--------:|
| **个人课评文件** | `.claude/memory/class/{班级}/{学生名}/feedback/YYYYMMDD_课程编号-课次.md` | 单次个人课评 | 生成后自动保存 |
| **班级总结** | `.claude/memory/class/{班级}/summaries/YYYYMMDD_课程编号-课次_班级反馈.md` | 班级群发文案 | 生成后自动保存 |
| **学生画像** | `.claude/memory/class/{班级}/{学生名}/profile.md` | 学生画像档案 | 建档时创建 |
### 课评完成率统计规则（自动化）
系统按以下规则自动统计课评完成率，**仅统计 CSP 和 AICODE 班级**：
1. **出勤基准**：校宝 API 排课数据（`teaching-schedule`），以校宝为准
2. **查找规则**（三级查找）：
- 第1级 → 班级目录下，学生/feedback/ 匹配文件日期
- 第2级 → 本仓库其他班级 补课/ 目录查找
- 第3级 → 其他老师仓库的 补课/ 目录查找
3. **日期匹配**：文件名中的 `YYYYMMDD` 必须与校宝 `teaching_date` 完全一致
4. **请假标记**：文件名带 `(请假)` 不要求课评
5. **补课追踪**：补课学生必须有课评（放在补课班级的 `补课/` 目录）
> **⚠️ 重要**：如果不按规范导致系统无法识别到课评，将按未完成统计。请确保每位到课学生均有对应日期的个人课评文件。详见 [20-workflow.md 第10节](.claude/rules/20-workflow.md)。
### 学生出勤状态（嵌入班级汇总）
@@ -214,6 +253,7 @@ classfeedback/
## 版本历史
- **v4.0** | 2026-05-14 | 同步课评规范V1.0：新增课程编号规范（CSP/AICODE）、新目录结构（`.claude/memory/class/`）、文件命名规范（`YYYYMMDD_课程编号-课次.md`）、课评完成率统计规则
- **v3.1** | 2026-05-05 | 简化保存流程：删除"待确认"状态，改为"生成即双轨保存"；出勤嵌入班级汇总
- **v2.5** | 2026-05-01 | 统一字数弹性范围180-350字
- **v2.0** | 2026-04-17 | 批量生成优化，双轨保存