198 lines
8.6 KiB
Markdown
198 lines
8.6 KiB
Markdown
# CLAUDE.md
|
||
|
||
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
||
|
||
## Project Overview
|
||
|
||
这是一个为**穹狼科创多课程体系**设计的课评生成器。支持 C++信息奥赛、AICODE创意编程、编程猫Kitten N 三大课程，以及体验课新生转化，并提供多种风格的评语模板（鼓励型、体验转化型）。
|
||
|
||
本项目为**纯 Markdown 模板**，无需运行代码，直接复制模板填空即可使用。
|
||
|
||
---
|
||
|
||
## 关键路径速查cd
|
||
|
||
AI 处理课评任务时，直接按以下路径读取，无需询问用户确认：
|
||
|
||
| 资源 | 路径规则 |
|
||
|------|---------|
|
||
| **课评输出（笔记）** | `E:/cc/3笔记/第N课.md` — 单课完整笔记；`output/课评汇总/第N周课评汇总.md` — 周汇总 |
|
||
| **学生档案（必看）** | `.claude/memory/class/[班级]/[姓名]/profile.md` |
|
||
| **课评风格指南** | `.claude/rules/[课程].md` — CSP.md / AICODE.md / KITTEN.md / 体验课.md |
|
||
| **课评模板** | `.claude/templates/[课程].md` — 标准格式模板 |
|
||
| **课程内容/教案** | `.claude/lesson/` |
|
||
| **班级规范与流程** | `.claude/memory/class/CLAUDE.md` — 命名规范、保存路径、出勤规则 |
|
||
| **OJ数据规则** | `.claude/rules/oj_data.md` — CSP课程查OJ数据时先看 |
|
||
|
||
### 路径格式约定
|
||
- 统一使用**正斜杠** `/`，如 `E:/cc/3笔记/`
|
||
- 班级目录格式：`课程编号+老师+星期时间`，如 `AICODE03橙子周六1900`
|
||
|
||
---
|
||
|
||
## 标准工作流程
|
||
|
||
用户请求"写课评"时，按以下顺序执行，无需逐步确认：
|
||
|
||
1. **确认信息**：课程类型 / 班级 / 课次 / 日期
|
||
2. **读取档案**：批量读取该班所有学生的 `profile.md`
|
||
3. **读取风格**：读取对应课程的 `rules/[课程].md`
|
||
4. **确认内容**：向用户收集本节课知识点、学生表现
|
||
5. **生成课评**：按班级风格生成个性化评语（约200字/人）
|
||
6. **保存归档**：
|
||
- 个人课评：`[班级]/[姓名]/feedback/YYYYMMDD_课程编号-课次.md`
|
||
- 班级总结：`[班级]/summaries/YYYYMMDD_课程编号-课次_班级反馈.md`
|
||
- 如用户要求，同时写入 `E:/cc/3笔记/第N课.md`
|
||
7. **更新出勤**：在 `[班级]/[姓名]/feedback/出勤登记-2026春季.md` 中标记出勤
|
||
|
||
### 命名规范（关键）
|
||
- C++班用 `CSP` 前缀，AI班用 `AICODE` 前缀，禁用 `AI`/`C++` 缩写
|
||
- 文件名：`YYYYMMDD_课程编号-课次.md`（日期必须与校宝 teaching_date 一致）
|
||
- 请假：`YYYYMMDD_课程编号-课次(请假).md`
|
||
- 补课：`YYYYMMDD_课程编号-课次(补课-去班级名).md`
|
||
|
||
---
|
||
|
||
## 学生班级信息
|
||
|
||
### 已录入班级（33名学生）
|
||
|
||
**周五下午1700AICODE03班（1人，一对一）**
|
||
- 李梓宁
|
||
|
||
**周五晚上1900K4班（4人）**
|
||
- 陈圆振、彭煜腾、郭艺嘉、王晨语
|
||
|
||
**周六早上0830CSP03班（5人）**
|
||
- 杨林轩、欧俊宇、汪子杰、谭锦程、谢明泓
|
||
|
||
**周六下午1400CSP03班（4人）**
|
||
- 郑子煜、张雨禾、魏铭轩、苏俊宇
|
||
> 注：廖梓琪已停课
|
||
|
||
**周六晚上1900AICODE03班（5人）**
|
||
- 陈嘉博、王子墨、谭俊研、黄彦棋、李承泽
|
||
> 注：黄浩、钟嘉鑫已转到其他老师班级
|
||
|
||
**周日早上0845AICODE03班（4人）**
|
||
- 卢皓霖、黄俊博、朱浩铭、杨翊弘
|
||
|
||
**周日早上1030CSP03班（3人）**
|
||
- 王佳琳、卢华琛、唐钎宸
|
||
|
||
**周日下午1400AICODE03班（4人）**
|
||
- 余浩宸、贺楚悦、吴浩睿、林俊宇
|
||
|
||
**周日晚上1900K4班（2人）**
|
||
- 梁境城、钟嘉逸
|
||
|
||
---
|
||
|
||
## 各班级课评风格速查
|
||
|
||
| 班级 | 风格文件 | 语气特点 |
|
||
|------|---------|---------|
|
||
| AICODE03班 | `rules/AICODE.md` | 温暖鼓励型，用"很棒～"、波浪号、表情符号🌟💡 |
|
||
| CSP03班 | `rules/CSP.md` | 家长信·要求型，"希望多思考"，先查OJ数据 |
|
||
| K4班 | `rules/KITTEN.md` | 家长信·温和鼓励型，"不过老师发现..." |
|
||
| 体验课 | `rules/体验课.md` | 转化导向，突出"第一次"，自然引导报课 |
|
||
|
||
### 固定开头格式（AICODE03 / CSP03 / K4 通用）
|
||
```
|
||
家长好，本周学习的内容是《【课程名称】》：
|
||
1. 【知识点1】
|
||
2. 【知识点2】
|
||
3. 【知识点3】
|
||
4. 【知识点4】
|
||
5. 【知识点5/情感价值观】
|
||
```
|
||
|
||
---
|
||
|
||
## 📁 文件结构
|
||
|
||
```
|
||
ClassFeedback/
|
||
├── CLAUDE.md # 项目说明文档（本文件）
|
||
├── .env # 环境变量配置（OJ登录凭据等）
|
||
├── .gitignore # Git忽略配置
|
||
├── OJ作业数据API使用说明.md # OJ数据API使用文档
|
||
├── .claude/ # Claude核心配置目录
|
||
│ ├── settings.local.json # 本地配置
|
||
│ ├── agents/ # Subagent配置
|
||
│ │ ├── 橙子老师/ # 心理疏导对话agent
|
||
│ │ └── 余浩宸/ # 学生对话模拟agent
|
||
│ ├── config/ # 配置文件
|
||
│ │ └── hw_dict.json # OJ作业包ID映射
|
||
│ ├── rules/ # 评语风格库（按科目分类）
|
||
│ │ ├── CSP.md # C++课程评语
|
||
│ │ ├── AICODE.md # AICODE课程评语
|
||
│ │ ├── KITTEN.md # Kitten课程评语
|
||
│ │ ├── 体验课.md # 体验课转化评语
|
||
│ │ └── oj_data.md # OJ系统数据获取规则
|
||
│ ├── templates/ # 课程模板库
|
||
│ │ ├── CSP.md # C++课程模板
|
||
│ │ ├── AICODE.md # AICODE课程模板
|
||
│ │ ├── KITTEN.md # Kitten课程模板
|
||
│ │ └── 出勤登记-2026春季.md # 出勤登记模板
|
||
│ ├── skills/ # 技能库
|
||
│ │ ├── 课评生成/ # 课评生成技能
|
||
│ │ ├── 课评检查/ # 课评检查技能
|
||
│ │ └── 家长沟通/ # 家长沟通回复助手
|
||
│ ├── lesson/ # 课程内容库
|
||
│ │ ├── AICODE/
|
||
│ │ │ ├── AICODE-03/ # AICODE03班课程大纲
|
||
│ │ │ └── AICODE-06/ # AICODE06班课程大纲
|
||
│ │ ├── CSP03/ # CSP03班课程大纲
|
||
│ │ ├── Kitten04/ # Kitten04班课程大纲（对应K4班）
|
||
│ │ └── 体验课/ # 体验课课程
|
||
│ └── memory/ # 记忆/档案库
|
||
│ ├── 教育理念.md # 教学理念与评语指南
|
||
│ ├── feedback/ # 课评规范与指南
|
||
│ ├── knowledge_base/ # 家长沟通标准回复知识库
|
||
│ ├── class/ # 【班级数据 - 核心课评目录】
|
||
│ │ └── 【课程+老师+时间】/ # 命名规范：课程编号+老师+星期时间
|
||
│ │ ├── summaries/ # 班级总结/群发文案
|
||
│ │ ├── 补课/ # 补课学生专用目录
|
||
│ │ └── 【学生姓名】/
|
||
│ │ ├── feedback/ # 【个人课评目录】
|
||
│ │ ├── communication/ # 【家长沟通记录】
|
||
│ │ ├── profile.md # 学生画像
|
||
│ │ ├── summary/ # 阶段性总结
|
||
│ │ └── 照片视频/ # 学生上课作品/照片
|
||
│ ├── oj/ # OJ数据分析结果
|
||
│ └── student/ # 学生通用档案模板
|
||
├── config/ # 根目录配置文件（预留）
|
||
├── data/ # 数据文件目录（校宝API数据、出勤数据）
|
||
├── docs/ # 文档目录
|
||
│ └── superpowers/ # Superpowers技能框架文档
|
||
├── input/ # 输入文件目录
|
||
├── output/ # 输出文件目录
|
||
│ ├── AI03网页/
|
||
│ ├── AICODE03提示词/
|
||
│ ├── CSP03课前小测/
|
||
│ └── 课评汇总/
|
||
├── scripts/ # 脚本目录
|
||
│ ├── analyze_course_student.py
|
||
│ ├── backup.bat
|
||
│ ├── check-api-vs-local.js
|
||
│ ├── query-attendance.js
|
||
│ ├── split_feedback.py
|
||
│ ├── split_feedback_v2.py
|
||
│ ├── update_feedback_with_oj.py
|
||
│ └── write_lesson10.py
|
||
└── node_modules/ # npm依赖
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 快速使用流程
|
||
|
||
```
|
||
1. 选择课程 → 2. 选择评语风格 → 3. 复制模板 → 4. 填空生成
|
||
```
|
||
|
||
---
|
||
|
||
*穹狼科创 - 多课程体系课评生成器 v2.2（CLAUDE.md 配置完善版）*
|