233 lines
8.7 KiB
Markdown
233 lines
8.7 KiB
Markdown
# CLAUDE.md
|
||
|
||
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
||
|
||
## Project Overview
|
||
|
||
这是一个为**穹狼科创多课程体系**设计的课评生成器。支持 C++信息奥赛、AIGC创意编程、编程猫Kitten N 三大课程，以及体验课新生转化，并提供多种风格的评语模板（鼓励型、体验转化型）。
|
||
|
||
本项目为**纯 Markdown 模板**，无需运行代码，直接复制模板填空即可使用。
|
||
|
||
---
|
||
|
||
## 📁 文件结构
|
||
|
||
```
|
||
课评反馈/
|
||
├── 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 # 教学理念与评语指南
|
||
├── student/ # 学生信息档案
|
||
│ ├── 用户画像.md # 6种学生类型特征
|
||
│ ├── 学生画像模板.md # 学生画像填写模板
|
||
│ └── 【班级名称】/
|
||
│ └── 【学生姓名】/
|
||
│ ├── 用户画像/ # 学生画像（6种类型）
|
||
│ └── 课评反馈/ # 课评归档
|
||
│ ├── 课评反馈-第[课次]课-[日期].md
|
||
│ └── 出勤登记-2026春季.md # 出勤登记表
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 快速使用流程
|
||
|
||
```
|
||
1. 选择课程 → 2. 选择评语风格 → 3. 复制模板 → 4. 填空生成
|
||
```
|
||
|
||
## 🚀 智能课评生成
|
||
|
||
### 使用技能生成课评
|
||
```
|
||
1. 确认学生/课程/课次 → 2. 读取相关资料 → 3. 收集本次表现 → 4. 生成课评 → 5. 保存到学生文件夹
|
||
```
|
||
|
||
### 步骤1：确认基本信息
|
||
- 学生姓名：_______
|
||
- 班级：_______
|
||
- 课程类型：□CPP □AIGC □KITTEN □体验课
|
||
- 本节课次：第_______课
|
||
- 课评风格：□鼓励型 □体验转化型
|
||
|
||
### 步骤2：参考资料
|
||
- **风格指南**：`.claude/rules/[课程].md`
|
||
- **学生用户画像**：`.claude/memory/student/[班级]/[姓名]/用户画像/`（必须先看！）
|
||
- **评语归档**：`.claude/memory/student/[班级]/[姓名]/课评反馈/`
|
||
- **教学方案**：根据课次查找对应教案
|
||
|
||
### 步骤3：生成课评
|
||
根据学生画像和风格指南，生成约200字个性化课评
|
||
|
||
### 步骤4：保存归档
|
||
保存到：`.claude/memory/student/[班级]/[姓名]/课评反馈/第[课次]课-[课程题目]-[日期].md`
|
||
|
||
### 步骤5：更新出勤登记（自动）
|
||
保存课评后，自动在出勤登记文件中记录本次出勤：
|
||
- 文件路径：`.claude/memory/student/[班级]/[姓名]/课评反馈/出勤登记-2026春季.md`
|
||
- 操作：添加一条出勤记录，状态为"✅ 出勤"
|
||
|
||
---
|
||
|
||
## 📊 出勤记录管理
|
||
|
||
### 出勤记录功能
|
||
- 每位学生都有独立的出勤登记表：`出勤登记-2026春季.md`
|
||
- 写课评时自动更新出勤状态为"✅ 出勤"
|
||
- 可使用 `/出勤记录` 命令查询出勤情况
|
||
|
||
### 出勤状态说明
|
||
- **✅ 出勤**：学生正常上课
|
||
- **⏸ 请假**：学生请假
|
||
- **❌ 未上课**：学生未上课
|
||
|
||
### 使用方法
|
||
```
|
||
/出勤记录 [学生姓名] [班级] [时间范围]
|
||
```
|
||
|
||
**示例**：
|
||
- `/出勤记录` - 查询所有学生
|
||
- `/出勤记录 陈嘉博` - 查询某个学生
|
||
- `/出勤记录 周六晚上1900AI03班` - 查询某个班级
|
||
- `/出勤记录 陈嘉博 4月` - 查询指定月份
|
||
|
||
### 出勤登记表格式
|
||
```
|
||
| 日期 | 课程 | 课次 | 状态 | 备注 |
|
||
|------|------|------|------|------|
|
||
| 2026-04-06 | AI大作家下 | 第5课 | ✅ 出勤 | |
|
||
```
|
||
|
||
---
|
||
|
||
### 课程与风格选择参考
|
||
|
||
根据授课内容选择对应评语文件：
|
||
|
||
| 课程 | 评语文件 | 评价侧重点 |
|
||
|------|----------|-----------|
|
||
| C++信息奥赛 | `.claude/rules/CPP.md` | 逻辑思维、算法理解、代码规范 |
|
||
| AIGC创意编程 | `.claude/rules/AIGC.md` | 自然语言描述、创意实现、调试能力 |
|
||
| 编程猫Kitten | `.claude/rules/KITTEN.md` | 逻辑流程、创意表达、作品完成度 |
|
||
| 体验课 | `.claude/rules/体验课.md` | 展示潜力、激发兴趣、转化报课 |
|
||
|
||
根据学生性格和表现选择对应风格：
|
||
|
||
| 风格 | 适用对象 |
|
||
|------|----------|
|
||
| 鼓励型 | 内向/信心不足/刚开始学/需要建立信心 |
|
||
| 体验转化型 | 新生体验课/展示价值/促成报课 |
|
||
|
||
> **重要**：写课评前必须先读取学生用户画像，根据画像类型选择评语风格！体验课必须使用`.claude/rules/体验课.md`风格。
|
||
|
||
---
|
||
|
||
## 💡 使用示例
|
||
|
||
**场景1：使用技能生成**
|
||
**生成过程**：
|
||
1. 确认学生信息：小明/三年级A班/AIGC/第5课/鼓励型
|
||
2. 读取资料：用户画像(信心不足型)+风格指南(AIGC.md)
|
||
3. 收集表现：掌握程度一般，但想象力丰富
|
||
4. 生成课评：200字个性化内容
|
||
5. 保存归档：学生课堂反馈文件夹
|
||
|
||
---
|
||
|
||
## 📊 学生班级信息
|
||
|
||
### 已录入班级（37名学生）
|
||
|
||
**周五下午1700AI03班（1人，一对一）**
|
||
- 李梓宁
|
||
|
||
**周五晚上1900K4班（4人）**
|
||
- 陈圆振、彭煜腾、郭艺嘉、王晨语
|
||
|
||
**周六早上0830CSP03班（5人）**
|
||
- 杨林轩、欧俊宇、汪子杰、谭锦程、谢明泓
|
||
|
||
**周六下午1400CSP03班（5人）**
|
||
- 廖梓琪、郑子煜、张雨禾、魏铭轩、苏俊宇
|
||
|
||
**周六晚上1900AI03班（7人）**
|
||
- 陈嘉博、王子墨、谭俊研、黄彦棋、黄浩、李承泽、钟嘉鑫
|
||
|
||
**周日早上0845AI03班（4人）**
|
||
- 卢皓霖、黄俊博、朱浩铭、杨翊弘
|
||
|
||
**周日早上1030CSP03班（3人）**
|
||
- 王佳琳、卢华琛、唐钎宸
|
||
|
||
**周日下午1400AI03班（4人）**
|
||
- 余浩宸、贺楚悦、吴浩睿、林俊宇
|
||
|
||
**周日晚上1900K4班（2人）**
|
||
- 梁境城、钟嘉逸
|
||
|
||
---
|
||
|
||
## 🎨 班级专属课评风格
|
||
|
||
### AI03班 - 温暖鼓励型
|
||
**特点**：温暖亲切、兴趣激发、表情符号多
|
||
- 语气：用"很棒"、"特别棒"、"超棒"、波浪号"～"
|
||
- 表情：🌟💡🌸😊💪✨
|
||
- 描述具体行为："一字一字打字"、"和AI聊了一节课"
|
||
- 提及学生感兴趣的项目："恐怖故事大王"
|
||
- 温和建议："要是...就更好啦～"
|
||
- 固定结尾："老师会继续关注XX的表现，期待看到更多精彩！🌟💡"
|
||
|
||
### K4班 - 家长信格式·温和鼓励型
|
||
**特点**：温和鼓励、具体描述、家长视角
|
||
- 固定开头："家长好，本周学习的内容是《...》" + 5个知识点
|
||
- 表扬创意："能够有自己的创意"
|
||
- 温和指出："不过老师发现...专注力有些下降"
|
||
- 鼓励结尾："继续加油哦！"、"相信你会把程序做得更完整"
|
||
|
||
### CSP03班 - 家长信格式·要求型
|
||
**特点**：温和但有要求、高期望
|
||
- 固定开头："家长好，本周学习的内容是《...》" + 5个知识点
|
||
- 表扬积极："状态在线"、"早早到校等候超积极"
|
||
- 期望要求："希望多思考"、"理解为什么这么写，不只是抄完就好～"
|
||
- 鼓励结尾："加油呀！💪✨"
|
||
|
||
### 体验课 - 家长信格式·转化导向型
|
||
**特点**：展示价值、激发兴趣、促成报课
|
||
- 固定开头："家长好，今天体验的是《...》课程" + 课程价值介绍
|
||
- 突出"第一次"：强调新体验，降低焦虑，突出潜力
|
||
- 展示潜力：具体描述孩子在体验中展现的能力和天赋
|
||
- 建立愿景：描述继续学习后孩子能达到的水平
|
||
- 自然引导：用期待和相信来引导家长报课，不硬推销
|
||
- 鼓励结尾："期待在正式课堂上再次见到XX！"
|
||
|
||
---
|
||
|
||
*穹狼科创 - 多课程体系课评生成器 v1.7（新增出勤记录管理）*
|