# AGENTS.md

This file provides guidance to Codex (Codex.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` — 周汇总 |
| **学生档案（必看）** | `.Codex/memory/class/[班级]/[姓名]/profile.md` |
| **课评风格指南** | `.Codex/rules/[课程].md` — CSP.md / AICODE.md / KITTEN.md / 体验课.md |
| **课评模板** | `.Codex/templates/[课程].md` — 标准格式模板 |
| **课程内容/教案** | `.Codex/lesson/` |
| **班级规范与流程** | `.Codex/memory/class/AGENTS.md` — 命名规范、保存路径 |
| **OJ数据规则** | `.Codex/rules/oj_data.md` — CSP课程查OJ数据时先看 |

### 路径格式约定
- 统一使用**正斜杠** `/`，如 `E:/cc/3笔记/`
- 班级目录格式：`课程编号+老师+星期时间`，如 `AICODE03橙子周六1900`

---

## 标准工作流程

用户请求"写课评"时，按以下顺序执行，无需逐步确认：

1. **确认信息**：课程类型 / 班级 / 课次 / 日期
2. **读取档案**：批量读取该班所有学生的 `profile.md`
3. **读取风格**：读取对应课程的 `rules/[课程].md`
4. **确认内容**：向用户收集本节课知识点、学生表现
5. **生成课评**：按班级风格生成个性化评语（约200字/人）
6. **确认修改**：展示课评给用户确认，根据用户意见修改
7. **课评质检**：用户确认后，自动调用课评质检系统检查课评质量（详见 `.Codex/skills/课评质检/SKILL.md`）
8. **保存归档**：
   - 个人课评：`[班级]/[姓名]/feedback/YYYYMMDD_课程编号-课次.md`
   - 班级总结：`[班级]/summaries/YYYYMMDD_课程编号-课次_班级反馈.md`
   - 如用户要求，同时写入 `E:/cc/3笔记/第N课.md`
9. ~~**更新出勤**~~（已移除）

### 命名规范（关键）
- C++班用 `CSP` 前缀，AI班用 `AICODE` 前缀，禁用 `AI`/`C++` 缩写
- 文件名：`YYYYMMDD_课程编号-课次.md`（日期必须与校宝 teaching_date 一致）
- 请假：`YYYYMMDD_课程编号-课次(请假).md`
- 补课：`YYYYMMDD_课程编号-课次(补课-去班级名).md`

---

## 学生班级信息

### 已录入班级（33名学生）

**周五下午1700AICODE03班（1人，一对一）**
- 李梓宁

**周五晚上1900K4班（4人）**
- 陈圆振、彭煜腾、郭艺嘉、王晨语

**周六早上0830CSP03班（4人）**
- 杨林轩、欧俊宇、汪子杰、谢明泓
> 注：谭锦程已退学

**周六下午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/
├── AGENTS.md                  # 项目说明文档（本文件）
├── .env                       # 环境变量配置（OJ登录凭据等）
├── .gitignore                 # Git忽略配置
├── OJ作业数据API使用说明.md      # OJ数据API使用文档
├── .Codex/                   # Codex核心配置目录
│   ├── 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课程模板
│   │   └── （出勤登记已移除）
│   ├── 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（AGENTS.md 配置完善版）*
