195 lines
6.7 KiB
Markdown
195 lines
6.7 KiB
Markdown
# 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*
|