# ClassFeedback 课评管理规范

本文档规定了课评仓库的统一目录结构和文件格式，供所有老师参考使用。

---

## 一、目录结构规范

```
ClassFeedback/                          # 仓库根目录（命名：ClassFeedback）
├── .claude/                                   # Claude配置目录
│   ├── memory/                                # 记忆数据目录
│   │   ├── class/                             # 【班级数据 - 核心课评目录】
│   │   │   ├── 班级名称/                      # 命名：课程+老师+时间（如：CSP05克力周六1600）
│   │   │   │   ├── summaries/                 # 班级总结/群发文案
│   │   │   │   │   ├── YYYYMMDD_课程编号_班级反馈.md
│   │   │   │   │   └── YYYYMMDD_课程编号_微信群.txt
│   │   │   │   ├── 学生姓名1/                 # 学生个人文件夹
│   │   │   │   │   ├── feedback/              # 【个人课评目录】
│   │   │   │   │   │   ├── YYYYMMDD_课程编号.md
│   │   │   │   │   │   └── ...
│   │   │   │   │   ├── profile.md             # 学生画像
│   │   │   │   │   └── summary/               # 阶段性总结
│   │   │   │   │       └── YYYY-MM_月度总结.md
│   │   │   │   ├── 学生姓名2/
│   │   │   │   │   └── ...
│   │   │   │   └── ...
│   │   │   └── 班级名称2/
│   │   │       └── ...
│   │   ├── lesson/                            # 课程大纲资料（可选）
│   │   │   └── CSP01/
│   │   │       └── 课程大纲.md
│   │   └── oj/                                # OJ数据分析（可选）
│   │       └── analysis/
│   └── skills/                                # 技能脚本（可选）
└── README.md                                  # 仓库说明
```

---

## 二、命名规范

### 2.1 文件夹命名

| 层级 | 命名规则 | 示例 |
|------|---------|------|
| 班级文件夹 | 课程+老师+星期时间 | `CSP05克力周六1600`、`AI03东东周五1630`、`K2菠萝周日上午1045` |
| 学生文件夹 | 学生姓名 | `黄振轩`、`刘浩宇`、`李梓宁` |
| 课评子目录 | 固定名称 | `feedback`（课评）、`summary`（总结） |

### 2.2 文件命名

| 类型 | 命名规则 | 示例 |
|------|---------|------|
| 单次课评 | `YYYYMMDD_课程编号.md` | `20260418_CSP05-07.md`、`20260330_AI03-02.md` |
| 班级反馈 | `YYYYMMDD_课程编号_班级反馈.md` | `20260418_CSP05-07_班级反馈.md` |
| 群发文本 | `YYYYMMDD_课程编号_微信群.txt` | `20260418_CSP05-07_微信群.txt` |
| 月度总结 | `YYYY-MM_月度总结.md` | `2026-04_月度总结.md` |
| 学生画像 | 固定名称 | `profile.md` |

---

## 三、课评文件内容格式

### 3.1 标准课评模板

```markdown
# 课程名称：CSP05-07 初等数论2

**授课日期**: 2026-04-18

**课评内容**：
学生今天课堂非常认真，三类作业全部完成。但课堂练习调试12次（2次运行错误、3次答案错误、2次编译错误），说明边界条件和代码规范性还需加强。建议每道题重新手写框架，减少复用旧代码，这样基础更扎实。

课后整理埃氏筛法模板，记录今天的坑点。

---
**老师签名：XXX**
```

### 3.2 课评汇总模板（按学生汇总）

```markdown
# 学生姓名 - 课评汇总

---

## 第1节课：课程名（2026-03-07）

家长好，本周学习的内容是《XXX》：
1. 知识点1
2. 知识点2

学生今天表现...（详细课评内容）

—— 穹狼科创 XXX老师

---

## 第2节课：课程名（2026-03-14）

...

---
```

### 3.3 班级群发文案模板

```markdown
# CSP05-07 班级反馈（2026-04-18）

各位家长好，本周CSP05-07课程已结束。

## 课程内容
- 初等数论2：埃氏筛法、质因数分解

## 班级整体情况
- 课堂练习完成率：90%
- 课后作业提交率：85%

## 共性问题
1. 边界条件处理不够严谨
2. 代码规范性需要加强

请各位家长督促孩子完成课后作业，整理本周错题。

—— 克力老师
```

---

## 四、课评检查清单

### 4.1 上课后必须完成

- [ ] 为每位上课学生编写个人课评（保存到 `feedback/YYYYMMDD_课程编号.md`）
- [ ] 编写班级总结（保存到 `summaries/YYYYMMDD_课程编号_班级反馈.md`）
- [ ] 生成微信群发文案（保存到 `summaries/YYYYMMDD_课程编号_微信群.txt`）

### 4.2 每月必须完成

- [ ] 为每位学生编写月度总结（保存到 `summary/YYYY-MM_月度总结.md`）
- [ ] 更新学生画像（更新 `profile.md`）

---

## 五、各老师当前格式对照

| 老师 | 当前路径 | 建议调整为 |
|------|---------|-----------|
| 19163520381 | `.claude/memory/student/班级/学生/课评反馈/课评汇总.md` | `.claude/memory/class/班级/学生/feedback/YYYYMMDD_课程.md` |
| 13711179294 | `ClassFeedback/学生姓名.md` | `.claude/memory/class/班级/学生/feedback/YYYYMMDD_课程.md` |
| 13202777474 | `reviews/班级/学生日期.md` | `.claude/memory/class/班级/学生/feedback/YYYYMMDD_课程.md` |
| 13974188170 | `.claude/memory/student/班级/学生/课评/第X周课程.md` | `.claude/memory/class/班级/学生/feedback/YYYYMMDD_课程.md` |
| 18576526757 | `.claude/memory/student/班级/学生/课评反馈/课评汇总-2026春季.md` | 保持汇总格式，增加单次课评文件 |
| **17788733242** | **`.claude/memory/class/班级/学生/feedback/YYYYMMDD_课程.md`** | **✅ 标准格式** |
| 13108110172 | `.claude/student/班级/学生/历史课评.md` | `.claude/memory/class/班级/学生/feedback/YYYYMMDD_课程.md` |

---

## 六、快速开始

### 6.1 新建班级

```bash
mkdir -p ".claude/memory/class/课程老师星期时间/学生姓名/feedback"
mkdir -p ".claude/memory/class/课程老师星期时间/学生姓名/summary"
mkdir -p ".claude/memory/class/课程老师星期时间/summaries"
```

### 6.2 创建课评文件

```bash
# 创建单次课评
touch ".claude/memory/class/班级/学生/feedback/$(date +%Y%m%d)_课程编号.md"

# 创建学生画像
touch ".claude/memory/class/班级/学生/profile.md"
```

---

## 七、注意事项

1. **日期格式统一**：使用 `YYYYMMDD` 格式（如 20260418）
2. **课程编号规范**：使用统一的课程编号（如 CSP05-07、AI03-02）
3. **文件名禁用字符**：避免使用 `/\:*?"<>|`
4. **中文命名**：学生姓名和班级名称使用中文，保持可读性
5. **及时提交**：每次上完课后24小时内完成课评并提交到git

---

*规范制定日期：2026-04-21*
*参考模板：ClassFeedback_17788733242*
