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

更新K4课程README，清理旧的班级记忆文件，调整目录结构

Browse Source
This commit is contained in:
chengzi
2026-05-13 15:16:05 +08:00
parent 2e7878007c
commit fecb347740
538 changed files with 8105 additions and 57270 deletions
Download Patch File Download Diff File Expand all files Collapse all files

256
CLAUDE.md
View File

@@ -13,53 +13,98 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
## 📁 文件结构
```
课评反馈/
ClassFeedback/
├── CLAUDE.md # 本文件（项目说明）
└── .claude/
├── settings.local.json # 本地配置
├── rules/ # 评语风格库（按科目分类）
│ ├── CPP.md # C++课程评语
│ ├── AIGC.md # AIGC课程评语
│ ├── KITTEN.md # Kitten课程评语
│ └── 体验课.md # 体验课转化评语
├── templates/ # 课程模板库
│ ├── CPP.md # C++课程模板
│ ├── AIGC.md # AIGC课程模板
│ ├── KITTEN.md # Kitten课程模板
│ └── 出勤登记-2026春季.md # 出勤登记模板
├── skills/ # 技能库
│ ├── 课评生成/ # 课评生成技能
│ └── 出勤记录/ # 出勤记录查询技能
├── lesson/ # 课程内容库
│ ├── README.md # 课程目录
│ ├── K4/ # K4班课程
│ │ └── README.md # K4课程列表
│ ├── AI03/ # AI03班课程
│ │ └── 第4节课-AI大作家.md
│ ├── CSP03/ # CSP03班课程
│ │ └── 知识点.md
│ └── 体验课/ # 体验课课程
│ └── 洋洋4月3号笔记.md
└── memory/ # 记忆/档案库
├── 教育理念.md # 教学理念与评语指南
├── feedback/ # 课评规范与指南
│ └── 课评规范.md
├── class/ # 【班级数据 - 核心课评目录】
│ ├── 【课程+老师+时间】/ # 如：AI03橙子周六1900
│ │ ├── summaries/ # 班级总结/群发文案
│ │ │ ├── YYYYMMDD_课程编号_班级反馈.md
│ │ │ └── YYYYMMDD_课程编号_微信群.txt
│ │ └── 【学生姓名】/
│ │ ├── feedback/ # 【个人课评目录】
│ │ │ ├── YYYYMMDD_课程编号.md
│ │ │ └── ...
│ │ ├── profile.md # 学生画像
│ │ └── summary/ # 阶段性总结
│ │ └── YYYY-MM_月度总结.md
│ └── ...
└── student/ # 学生通用档案模板
├── 用户画像.md # 6种学生类型特征
└── 学生画像模板.md # 学生画像填写模板
├── MEMORY.md # Claude记忆文件（全局记忆库）
├── .env # 环境变量配置
├── .gitignore # Git忽略配置
├── .claude/ # Claude核心配置目录
│ ├── settings.local.json # 本地配置
│ ├── rules/ # 评语风格库（按科目分类）
│ │ ├── CPP.md # C++课程评语
│ │ ├── AIGC.md # AIGC课程评语
│ │ ├── KITTEN.md # Kitten课程评语
│ │ ├── 体验课.md # 体验课转化评语
│ │ └── oj_data.md # OJ系统数据获取规则
│ ├── templates/ # 课程模板库
│ │ ├── CPP.md # C++课程模板
│ │ ├── AIGC.md # AIGC课程模板
│ │ ├── KITTEN.md # Kitten课程模板
│ │ └── 出勤登记-2026春季.md # 出勤登记模板
│ ├── skills/ # 技能库
│ │ ├── 课评生成/ # 课评生成技能
│ │ ├── 出勤记录/ # 出勤记录查询技能
│ │ └── 家长沟通/ # 家长沟通回复助手
│ ├── lesson/ # 课程内容库（从独立仓库同步，不提交到本仓库）
│ │ ├── README.md # 课程目录
│ │ ├── K4/ # K4班课程
│ │ │ └── README.md # K4课程列表
│ │ ├── AICODE/ # AICODE课程大纲（从AICODE2026仓库同步）
│ │ │ ├── AICODE01/
│ │ │ ├── AICODE03/
│ │ │ │ └── 第4节课-AI大作家.md
│ │ │ └── ...
│ │ ├── CSP/ # CSP课程大纲（从CSP2026仓库同步）
│ │ │ ├── CSP01/
│ │ │ ├── CSP03/
│ │ │ │ └── 知识点.md
│ │ │ └── ...
│ │ └── 体验课/ # 体验课课程
│ │ └── 洋洋4月3号笔记.md
│ └── memory/ # 记忆/档案库
│ ├── 教育理念.md # 教学理念与评语指南
│ ├── feedback/ # 课评规范与指南
│ │ └── 课评规范.md
│ ├── knowledge_base/ # 【家长沟通 - 标准回复知识库】
│ │ ├── 比赛相关.md
│ │ ├── 请假补课.md
│ │ ├── 课程咨询.md
│ │ ├── 政策相关.md
│ │ ├── 学习建议.md
│ │ └── 其他问题.md
│ ├── class/ # 【班级数据 - 核心课评目录】
│ │ ├── 【课程+老师+时间】/ # 命名规范：课程编号+老师+星期时间，如：AICODE03橙子周六1900、CSP03橙子周六0830
│ │ │ ├── summaries/ # 班级总结/群发文案
│ │ │ │ ├── YYYYMMDD_课程编号-课次_班级反馈.md
│ │ │ │ └── YYYYMMDD_课程编号-课次_微信群.txt
│ │ │ ├── 补课/ # 补课学生专用目录（来自其他班级的补课学生）
│ │ │ │ └── 【学生姓名】/
│ │ │ │ └── feedback/
│ │ │ │ └── YYYYMMDD_课程编号-课次.md
│ │ │ └── 【学生姓名】/
│ │ │ ├── feedback/ # 【个人课评目录】
│ │ │ │ ├── YYYYMMDD_课程编号-课次.md # 正常课评
│ │ │ │ ├── YYYYMMDD_课程编号-课次(请假).md # 请假记录
│ │ │ │ ├── YYYYMMDD_课程编号-课次(补课-去XX班).md # 补课追踪
│ │ │ │ ├── 出勤登记-2026春季.md
│ │ │ │ └── 课评汇总-2026春季.md
│ │ │ ├── communication/ # 【家长沟通记录】
│ │ │ │ ├── YYYYMMDD_问题类型.md
│ │ │ │ └── 沟通汇总-2026春季.md
│ │ │ ├── profile.md # 学生画像
│ │ │ ├── summary/ # 阶段性总结
│ │ │ │ └── YYYY-MM_月度总结.md
│ │ │ └── 照片视频/ # 学生上课作品/照片
│ │ └── ...
│ └── student/ # 学生通用档案模板
│ ├── 用户画像.md # 6种学生类型特征
│ └── 学生画像模板.md # 学生画像填写模板
├── .claude-design/ # 设计资源目录
├── config/ # 配置文件目录
├── data/ # 数据文件目录
│ ├── all_schedule.json # 全部课程表数据
│ ├── all_teachers_attendance.json # 教师出勤数据
│ └── orange_attendance.json # 橙子老师出勤数据
├── docs/ # 文档目录
│ ├── README_OJ.md # OJ系统使用说明
│ └── README_备份说明.md # 数据备份说明
├── input/ # 输入文件目录
├── me/ # 个人工作目录
├── output/ # 输出文件目录
├── scripts/ # 脚本目录
│ ├── backup.bat # 数据备份脚本
│ └── query-attendance.js # 出勤查询脚本
└── 回收站/ # 临时删除文件存放目录
```
---
@@ -93,8 +138,13 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
### 步骤3：生成课评
根据学生画像和风格指南，生成约200字个性化课评
### 步骤4：保存归档
保存到：`.claude/memory/class/[班级]/[姓名]/feedback/YYYYMMDD_课程编号.md`
### 步骤4：保存归档（严格遵守命名规范）
**命名规则**：
- C++竞赛班统一用`CSP`前缀，AI编程班统一用`AICODE`前缀，不得使用`AI`、`C++`等缩写
- 文件名格式：`YYYYMMDD_课程编号-课次.md`（如`20260418_CSP05-07.md`、`20260330_AICODE03-02.md`）
- 日期要求：`YYYYMMDD`必须与校宝`teaching_date`完全一致，不得使用编写/提交日期
保存路径：`.claude/memory/class/[班级]/[姓名]/feedback/YYYYMMDD_课程编号-课次.md`
### 步骤5：更新出勤登记（自动）
保存课评后，自动在出勤登记文件中记录本次出勤：
@@ -123,7 +173,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
**示例**：
- `/出勤记录` - 查询所有学生
- `/出勤记录 陈嘉博` - 查询某个学生
- `/出勤记录 周六晚上1900AI03班` - 查询某个班级
- `/出勤记录 周六晚上1900AICODE03班` - 查询某个班级
- `/出勤记录 陈嘉博 4月` - 查询指定月份
### 出勤登记表格式
@@ -135,6 +185,63 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
---
## 💬 家长沟通知识库系统
### 功能说明
- **标准回复库**：按问题类型分类的优质回复模板（30+条）
- **智能匹配**：根据家长问题自动搜索相关回复
- **个性化建议**：结合学生档案给出定制化回复
- **沟通记录**：自动保存每次沟通到学生个人档案
### 两种使用模式
#### 模式一：快速问答模式
直接输入家长的问题，快速查找标准回复：
```
/家长回复 <家长的问题>
```
**示例**：
```
/家长回复 家长问AIGC比赛对强基计划有用吗？
```
#### 模式二：深度沟通模式
先指定学生，进入沟通模式，结合学生档案给出个性化回复：
```
/沟通模式 <学生姓名>
```
**示例**：
```
/沟通模式 林俊宇
```
进入后输入家长的问题，会结合学生特点给出定制化回复建议。
#### 添加新回复到知识库
遇到好的回复，可以添加到知识库：
```
/添加回复 <问题类型>
```
### 回复库分类
| 分类 | 文件路径 | 主要内容 |
|------|---------|----------|
| 比赛相关 | `.claude/memory/knowledge_base/比赛相关.md` | 报名时间、难度、升学价值、同时参赛等 |
| 请假补课 | `.claude/memory/knowledge_base/请假补课.md` | 请假流程、补课安排、调班等 |
| 课程咨询 | `.claude/memory/knowledge_base/课程咨询.md` | 学习内容、进度、课堂表现等 |
| 政策相关 | `.claude/memory/knowledge_base/政策相关.md` | 收费、退费、优惠等 |
| 学习建议 | `.claude/memory/knowledge_base/学习建议.md` | 打字速度、专注力、兴趣培养等 |
| 其他问题 | `.claude/memory/knowledge_base/其他问题.md` | 电脑配置、学习效果等 |
### 沟通记录保存
- 每次沟通自动保存到学生个人档案
- 路径：`.claude/memory/class/[班级]/[学生]/communication/`
- 包含：家长问题、实际回复、知识库关联、后续跟进建议
---
### 课程与风格选择参考
根据授课内容选择对应评语文件：
@@ -171,9 +278,9 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
## 📊 学生班级信息
### 已录入班级（37名学生）
### 已录入班级（35名学生）
**周五下午1700AI03班（1人，一对一）**
**周五下午1700AICODE03班（1人，一对一）**
- 李梓宁
**周五晚上1900K4班（4人）**
@@ -185,17 +292,19 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
**周六下午1400CSP03班（5人）**
- 廖梓琪、郑子煜、张雨禾、魏铭轩、苏俊宇
**周六晚上1900AI03班（7人）**
- 陈嘉博、王子墨、谭俊研、黄彦棋、黄浩、李承泽、钟嘉鑫
**周六晚上1900AICODE03班（5人）**
- 陈嘉博、王子墨、谭俊研、黄彦棋、李承泽
> 注：黄浩、钟嘉鑫已转到其他老师班级
**周日早上0845AI03班（4人）**
**周日早上0845AICODE03班（4人）**
- 卢皓霖、黄俊博、朱浩铭、杨翊弘
**周日早上1030CSP03班（3人）**
- 王佳琳、卢华琛、唐钎宸
**周日下午1400AI03班（4人）**
- 余浩宸、贺楚悦、吴浩睿、林俊宇
**周日下午1400AICODE03班（6人）**
- 余浩宸、贺楚悦、吴浩睿、林俊宇、张玉辰、曾乐凯
> 注：张玉辰、曾乐凯为2026年5月新增学生
**周日晚上1900K4班（2人）**
- 梁境城、钟嘉逸
@@ -204,7 +313,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
## 🎨 班级专属课评风格
### AI03班 - 温暖鼓励型
### AICODE03班 - 温暖鼓励型
**特点**：温暖亲切、兴趣激发、表情符号多
- 语气：用"很棒"、"特别棒"、"超棒"、波浪号"～"
- 表情：🌟💡🌸😊💪✨
@@ -238,4 +347,35 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
---
*穹狼科创 - 多课程体系课评生成器 v1.7（新增出勤记录管理）*
## 📌 课评规范V1.0 重要说明
本项目已全面升级到课评规范V1.0，所有操作必须严格遵守以下要求：
### 核心规范
1. **课程编号规则**：
- C++竞赛班统一用`CSP`前缀（如CSP01、CSP03）
- AI编程班统一用`AICODE`前缀（如AICODE01、AICODE03），不得使用`AI`缩写
- 课程编号必须与校宝系统完全一致
2. **文件名规则**：
- 正常课评：`YYYYMMDD_课程编号-课次.md`（如`20260418_CSP05-07.md`）
- 请假记录：`YYYYMMDD_课程编号-课次(请假).md`
- 补课追踪：`YYYYMMDD_课程编号-课次(补课-去班级名).md`
- 日期必须与校宝`teaching_date`完全一致，不得使用编写/提交日期
3. **目录结构**：
- 所有班级目录必须符合`课程编号+老师+星期时间`格式
- 补课学生的课评必须放在补课班级的`补课/[学生姓名]/feedback/`目录下
- 课程大纲从独立仓库同步，不提交到本仓库：
- CSP课程：https://git.qonnwolf.com/17788733242/CSP2026
- AICODE课程：https://git.qonnwolf.com/18675193675/AICODE2026
4. **完成率统计**：
- 课评完成率由自动化系统根据文件结构和命名自动统计
- 只有符合规范的文件才会被计入完成率
- 请假学生不纳入应发总数，补课学生按到课处理
### 更多详细规则请参考：`课评规范V1.0.md`
---
*穹狼科创 - 多课程体系课评生成器 v2.0（全面升级到课评规范V1.0，支持自动化完成率统计，新增补课/请假特殊处理逻辑）*