228 lines
8.9 KiB
Markdown
228 lines
8.9 KiB
Markdown
# CLAUDE.md - 班级课评核心规范
|
||
|
||
本目录是课评系统的核心数据目录，包含所有班级、学生的课评档案、画像和沟通记录。
|
||
|
||
---
|
||
|
||
## 🚀 智能课评生成流程
|
||
|
||
### 🔧 推荐：使用课评生成技能
|
||
|
||
**技能路径**：`../../skills/课评生成/SKILL.md`
|
||
|
||
课评生成技能包支持：
|
||
- ✅ **超简单输入**：只需提供学生姓名 + 班级 + 本节课表现
|
||
- ✅ **自动匹配风格**：AIAGENT03温暖鼓励型 / CSP00·CSP04要求型 / 体验课转化型
|
||
- ✅ **批量处理**：支持从笔记文件（`E:\cc\3笔记\第N课.md`）批量生成课评
|
||
- ✅ **CSP专属OJ数据**：自动拉取OJ做题数据并整合到课评
|
||
- ✅ **自动多位置保存**：单次课评文件 + 个人汇总 + 周汇总 + 班级总结
|
||
- ✅ **自动更新画像**：根据本节课表现更新学生画像
|
||
|
||
### 📋 手动生成步骤（不推荐）
|
||
|
||
```
|
||
1. 确认学生/课程/课次 → 2. 读取相关资料 → 3. 收集本次表现 → 4. 生成课评 → 5. 保存到学生文件夹
|
||
```
|
||
|
||
### 步骤1：确认基本信息
|
||
- 学生姓名：_______
|
||
- 班级：_______
|
||
- 课程类型：□CPP □AIAGENT □KITTEN □体验课
|
||
- 本节课次：第_______课
|
||
- 课评风格：□鼓励型 □体验转化型
|
||
|
||
### 步骤2：参考资料
|
||
- **风格指南**：`.claude/rules/[课程].md`
|
||
- **学生用户画像**：`[班级]/[姓名]/profile.md`（必须先看！）
|
||
- **评语归档**：`[班级]/[姓名]/feedback/`
|
||
- **教学方案**：根据课次查找对应教案（`.claude/lesson/`）
|
||
|
||
### 步骤3：生成课评
|
||
根据学生画像和风格指南，生成约200字个性化课评
|
||
|
||
### 步骤4：保存归档（严格遵守命名规范）
|
||
|
||
**命名规则：**
|
||
- C++竞赛班统一用`CSP`前缀，AI编程班统一用`AIAGENT`前缀，不得使用`AI`、`C++`等缩写
|
||
- 文件名格式：`YYYYMMDD_课程编号-课次.md`（如`20260418_CSP04-07.md`、`20260330_AIAGENT03-02.md`）
|
||
- 日期要求：`YYYYMMDD`必须与校宝`teaching_date`完全一致，不得使用编写/提交日期
|
||
|
||
**特殊文件命名：**
|
||
- 请假记录：`YYYYMMDD_课程编号-课次(请假).md`
|
||
- 补课追踪：`YYYYMMDD_课程编号-课次(补课-去班级名).md`
|
||
|
||
**保存路径：**
|
||
- 正常课评：`[班级]/[姓名]/feedback/YYYYMMDD_课程编号-课次.md`
|
||
- 补课学生：`[补课班级]/补课/[学生姓名]/feedback/YYYYMMDD_课程编号-课次.md`
|
||
|
||
---
|
||
|
||
## 🎨 班级专属课评风格
|
||
|
||
### AIAGENT03班 - 温暖鼓励型
|
||
**特点：** 温暖亲切、兴趣激发、表情符号多
|
||
- 语气：用"很棒"、"特别棒"、"超棒"、波浪号"～"
|
||
- 表情：🌟💡🌸😊💪✨
|
||
- 描述具体行为："一字一字打字"、"和AI聊了一节课"
|
||
- 提及学生感兴趣的项目："恐怖故事大王"
|
||
- 温和建议："要是...就更好啦～"
|
||
- 固定结尾："老师会继续关注XX的表现，期待看到更多精彩！🌟💡"
|
||
|
||
### CSP00/CSP04班 - 家长信格式·要求型
|
||
**特点：** 温和但有要求、高期望
|
||
- 固定开头："家长好，本周学习的内容是《...》" + 5个知识点
|
||
- 表扬积极："状态在线"、"早早到校等候超积极"
|
||
- 期望要求："希望多思考"、"理解为什么这么写，不只是抄完就好～"
|
||
- 鼓励结尾："加油呀！💪✨"
|
||
|
||
### 体验课 - 家长信格式·转化导向型
|
||
**特点：** 展示价值、激发兴趣、促成报课
|
||
- 固定开头："家长好，今天体验的是《...》课程" + 课程价值介绍
|
||
- 突出"第一次"：强调新体验，降低焦虑，突出潜力
|
||
- 展示潜力：具体描述孩子在体验中展现的能力和天赋
|
||
- 建立愿景：描述继续学习后孩子能达到的水平
|
||
- 自然引导：用期待和相信来引导家长报课，不硬推销
|
||
- 鼓励结尾："期待在正式课堂上再次见到XX！"
|
||
|
||
---
|
||
|
||
## 📌 课评规范V1.0 重要说明
|
||
|
||
本项目已全面升级到课评规范V1.0，所有操作必须严格遵守以下要求：
|
||
|
||
### 核心规范
|
||
|
||
1. **课程编号规则：**
|
||
- C++竞赛班统一用`CSP`前缀（如CSP00、CSP04）
|
||
- AI编程班统一用`AIAGENT`前缀（如AIAGENT03），不得使用`AI`缩写
|
||
- 课程编号必须与校宝系统完全一致
|
||
|
||
2. **文件名规则：**
|
||
- 正常课评：`YYYYMMDD_课程编号-课次.md`
|
||
- 请假记录：`YYYYMMDD_课程编号-课次(请假).md`
|
||
- 补课追踪：`YYYYMMDD_课程编号-课次(补课-去班级名).md`
|
||
- 日期必须与校宝`teaching_date`完全一致，不得使用编写/提交日期
|
||
|
||
3. **目录结构：**
|
||
- 所有班级目录必须符合`课程编号+老师+星期时间`格式
|
||
- 补课学生的课评必须放在补课班级的`补课/[学生姓名]/feedback/`目录下
|
||
|
||
4. **完成率统计：**
|
||
- 课评完成率由自动化系统根据文件结构和命名自动统计
|
||
- 只有符合规范的文件才会被计入完成率
|
||
- 请假学生不纳入应发总数，补课学生按到课处理
|
||
|
||
---
|
||
|
||
## 💡 使用示例
|
||
|
||
**场景1：使用技能生成**
|
||
|
||
**生成过程：**
|
||
1. 确认学生信息：小明/三年级A班/AIAGENT/第5课/鼓励型
|
||
2. 读取资料：用户画像(信心不足型)+风格指南(AIAGENT.md)
|
||
3. 收集表现：掌握程度一般，但想象力丰富
|
||
4. 生成课评：200字个性化内容
|
||
5. 保存归档：学生课堂反馈文件夹
|
||
|
||
---
|
||
|
||
## 📁 目录结构说明
|
||
|
||
```
|
||
【课程+老师+时间】/ # 班级目录（如：AIAGENT03橙子周六1900）
|
||
├── summaries/ # 班级总结/群发文案
|
||
│ ├── YYYYMMDD_课程编号-课次_班级反馈.md
|
||
│ └── YYYYMMDD_课程编号-课次_微信群.txt
|
||
├── 补课/ # 补课学生专用目录
|
||
│ └── 【学生姓名】/
|
||
│ └── feedback/
|
||
│ └── YYYYMMDD_课程编号-课次.md
|
||
└── 【学生姓名】/ # 学生个人目录
|
||
├── feedback/ # 个人课评目录
|
||
│ ├── YYYYMMDD_课程编号-课次.md # 正常课评
|
||
│ ├── YYYYMMDD_课程编号-课次(请假).md # 请假记录
|
||
│ ├── YYYYMMDD_课程编号-课次(补课-去XX班).md # 补课追踪
|
||
│ └── 课评汇总-2026春季.md
|
||
├── communication/ # 家长沟通记录
|
||
│ ├── YYYYMMDD_问题类型.md
|
||
│ └── 沟通汇总-2026春季.md
|
||
├── profile.md # 学生画像
|
||
├── summary/ # 阶段性总结
|
||
│ └── YYYY-MM_月度总结.md
|
||
└── 照片视频/ # 学生上课作品/照片
|
||
```
|
||
|
||
---
|
||
|
||
## 📂 课评汇总网页文件夹规范
|
||
|
||
### 目标结构
|
||
|
||
```
|
||
output/课评汇总/
|
||
├── 第一周课评汇总/
|
||
│ ├── 📄 总览.html (可跳转到各节课)
|
||
│ ├── 📄 第1课-英雄的诞生-CSP00.html (班级课评)
|
||
│ ├── 📄 第1课-xxx-AIAGENT03汇总.html (班级汇总)
|
||
│ ├── 📄 第1课-xxx-AIAGENT03-李俊霆.html (个人课评)
|
||
│ └── 📁 照片/
|
||
│ ├── 20260904_CSP00_王晨语.jpg
|
||
│ ├── 20260904_CSP00_王晨语_2.jpg
|
||
│ └── ...
|
||
├── 第二周课评汇总/
|
||
│ ├── 总览.html
|
||
│ ├── 第2课-xxx-CSP00.html
|
||
│ └── 照片/
|
||
```
|
||
|
||
### 命名规范
|
||
|
||
| 类型 | 命名格式 | 示例 |
|
||
|------|----------|------|
|
||
| 周文件夹 | 第X周课评汇总 | 第一周课评汇总 |
|
||
| 班级课评网页 | 第X课-课程名称-班级.html | 第1课-英雄的诞生-CSP00.html |
|
||
| 班级汇总网页 | 第X课-xxx-班级汇总.html | 第1课-xxx-AIAGENT03汇总.html |
|
||
| 个人课评网页 | 第X课-xxx-班级-姓名.html | 第1课-xxx-AIAGENT03-李俊霆.html |
|
||
| 学生照片 | 时间_课程_学生姓名.jpg | 20260904_CSP00_王晨语.jpg |
|
||
| 总览网页 | 总览.html | 总览.html |
|
||
|
||
### 操作流程
|
||
|
||
1. **创建周文件夹**：`output/课评汇总/第X周课评汇总/`
|
||
2. **创建照片文件夹**：`output/课评汇总/第X周课评汇总/照片/`
|
||
3. **移动照片**：从 `input/` 移动到 `照片/` 文件夹，重命名格式 `时间_课程_学生姓名.jpg`
|
||
4. **复制课评网页**：从临时目录复制到周文件夹，更新照片路径
|
||
5. **创建总览网页**：包含所有课程链接，可跳转到各节课
|
||
|
||
### 注意事项
|
||
|
||
- 照片从 `input/` 移动后要删除原文件
|
||
- 照片命名必须包含时间、课程、学生姓名
|
||
- 总览网页需要列出本周所有课程
|
||
- 课评网页中的照片路径使用相对路径 `照片/xxx.jpg`
|
||
|
||
---
|
||
|
||
## 🪤 踩坑日常
|
||
|
||
> 记录课评工作中的坑点，避免重复犯错。
|
||
|
||
### 1. 补课学生必须创建独立文件夹结构（2026-06-13）
|
||
|
||
**问题**：补课学生的课评文件直接放在 `补课/` 根目录下，没有创建学生子文件夹和 `feedback` 目录。
|
||
|
||
**正确结构**：
|
||
```
|
||
补课/
|
||
├── 【学生姓名】/
|
||
│ └── feedback/
|
||
│ └── YYYYMMDD_课程编号-课次.md
|
||
```
|
||
|
||
**注意**：文件名只用 `时间_课程编号-课次.md`，**不带学生姓名**。
|
||
|
||
---
|
||
|
||
*班级课评核心规范 v1.0*
|