# AGENTS.md This file provides guidance to Codex (Codex.ai/code) when working with code in this repository. > 🔀 **使用 DeepSeek Harness（DSH）时请查看 [`.dsh/AGENTS.md`](.dsh/AGENTS.md)** —— 那是 DSH 环境的最新指引（三大技能 + 写课评工作流），本文件路径与流程已过时（Claude Code 用户请看 `CLAUDE.md`）。 ## Project Overview 这是一个为**穹狼科创多课程体系**设计的课评生成器。支持 C++信息奥赛、AIAGENT创意编程、编程猫Kitten N 三大课程，以及体验课新生转化，并提供多种风格的评语模板（鼓励型、体验转化型）。 本项目为**纯 Markdown 模板**，无需运行代码，直接复制模板填空即可使用。 --- ## 关键路径速查cd AI 处理课评任务时，直接按以下路径读取，无需询问用户确认： | 资源 | 路径规则 | |------|---------| | **课评输出（笔记）** | `E:/cc/3笔记/第N课.md` — 单课完整笔记；`output/课评汇总/第N周课评汇总.md` — 周汇总 | | **学生档案（必看）** | `.Codex/memory/class/[班级]/[姓名]/profile.md` | | **课评风格指南** | `.Codex/rules/[课程].md` — CSP.md / AIAGENT.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笔记/` - 班级目录格式：`课程编号+老师+星期时间`，如 `AIAGENT03橙子周六1900` --- ## 标准工作流程 用户请求"写课评"时，按以下顺序执行，无需逐步确认： 1. **确认信息**：课程类型 / 班级 / 课次 / 日期 2. **🎯 自动获取出勤**：调用校宝API (`/reports/teaching-schedule`) 自动查询该日该班出勤数据。API失败时：token过期→告知用户更新；无此班级→手动问用户（详见 `.workbuddy/skills/课评生成/skill.md` 的「第0节」） 3. **读取档案**：批量读取该班所有学生的 `profile.md` 4. **读取风格**：读取对应课程的 `rules/[课程].md` 5. **确认内容**：向用户收集本节课知识点、学生表现 6. **生成课评**：按班级风格生成个性化评语（约200字/人） 7. **确认修改**：展示课评给用户确认，根据用户意见修改 8. **课评质检**：用户确认后，自动调用课评质检系统检查课评质量（详见 `.workbuddy/skills/课评质检/SKILL.md`） 9. **保存归档**： - 个人课评：`[班级]/[姓名]/feedback/YYYYMMDD_课程编号-课次.md` - 班级总结：`[班级]/summaries/YYYYMMDD_课程编号-课次_班级反馈.md` - 如用户要求，同时写入 `E:/cc/3笔记/第N课.md` ### 命名规范（关键） - C++班用 `CSP` 前缀，AI班用 `AIAGENT` 前缀，禁用 `AI`/`C++` 缩写 - 文件名：`YYYYMMDD_课程编号-课次.md`（日期必须与校宝 teaching_date 一致） - 请假：`YYYYMMDD_课程编号-课次(请假).md` - 补课：`YYYYMMDD_课程编号-课次(补课-去班级名).md` --- ## 学生班级信息 ### 已录入班级（2026秋季新学期） **周五下午1500 AIAGENT03班（13教室，1人，一对一）** - 李梓宁（新） > 注：原「周五下午1700合并班」已于 2026-09-10 拆成两个一对一，李梓宁为 15:00–16:30。 **周五下午1630 AIAGENT03班（13教室，1人，一对一）** - 李俊霆（新） > 注：2026-09-23 老师确认时段为 **16:30–18:00**（原 17:00–18:30 口径作废）。 **周五晚上1900 CSP00班（13教室，4人，2课时）** - 王晨语、陈圆振、彭煜腾、郭艺嘉 > 注：原K4班学生转C++方向，课程编号 CSP00 **周六早上0830 CSP04班（11教室，4人）** - 欧俊宇、汪子杰、谢明泓、魏铭轩 > 注：王佳琳已转至其他老师班级（2026-09 起）。 **周六下午1400 CSP04班（8教室，5人）** - 郑子煜、张雨禾、苏俊宇、卢华琛、鲍佳音（新） **周六下午1610 CSP01班（8教室，1人，一对一）** - 周晨远（回归：原 CSP01橙子一对一，2026-09-05 新建班续课，已上到 CSP01-02，下节课第03课） > 注：**随机补课模式**（2026-09-23 老师确认），上课时间不固定，不发常规上课通知，课次以实际上课日为准。 **周六晚上1900 AIAGENT03班（8教室，6人）** - 陈嘉博、谭俊研、黄彦棋、黄浩、钟嘉鑫、李承泽 > 注：黄浩、钟嘉鑫回归本班；**王子墨已转其他老师**（2026-09-23 确认）。 **周日早上0845 AIAGENT03班（8教室，4人）** - 卢皓霖、朱浩铭、沙佩琪（新）、李汶浩（新，转班生） > 注：**黄俊博已停课**（2026-09-23 确认）；教室为八教室；**李汶浩2026-09-27起由 AIAGENT03 其他时段班转入**（原时段不合适，五年级男生），第4课起随本班上课。 **周日1045 AIAGENT03班（11教室，1人，一对一）** - 章梓皓（新） > 注：2026-09-23 老师确认教室为**十一教室**（原 demo 教室口径作废）。 **周日下午1400 AIAGENT03班（8教室，4人）** - 贺楚悦、吴浩睿、余浩宸、邓梓潼（新） **体验课** - 叶钧洋等（新生体验课，单独用 `体验课/` 目录管理） ### 已归档班级（历史/转出，在 `.claude/memory/class/归档/`） > GESP集训第一期/第二期（暑期结束）、AIAGENT小龙虾夏令营（暑期结束）、穹狼传奇（暑期结束）、CSP03橙子周日1030（唐钎宸转学）、周日1900K4班（梁境城、钟嘉逸转其他老师）；杨林轩、杨翊弘、林俊宇、谭锦程等停课/退学学生档案移入 `归档/转出学生/` --- ## 各班级课评风格速查 | 班级 | 风格文件 | 语气特点 | |------|---------|---------| | AIAGENT03班（周五1700/周六1900/周日0845/周日1045/周日1400） | `rules/AIAGENT.md` | 温暖鼓励型，用"很棒～"、波浪号、表情符号🌟💡 | | CSP04班（周六0830/周六1400） | `rules/CSP.md` | 家长信·要求型，"希望多思考"，先查OJ数据 | | CSP00班（周五1900，2课时） | `rules/CSP.md` | 家长信·要求型，需查OJ数据 | | 体验课 | `rules/体验课.md` | 转化导向，突出"第一次"，自然引导报课 | ### 固定开头格式（AIAGENT / CSP / 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++课程评语 │ │ ├── AIAGENT.md # AIAGENT课程评语 │ │ ├── KITTEN.md # Kitten课程评语 │ │ ├── 体验课.md # 体验课转化评语 │ │ └── oj_data.md # OJ系统数据获取规则 │ ├── templates/ # 课程模板库 │ │ ├── CSP.md # C++课程模板 │ │ ├── AIAGENT.md # AIAGENT课程模板 │ │ ├── KITTEN.md # Kitten课程模板 │ │ └── （出勤登记已移除） │ ├── skills/ # 技能库 │ │ ├── 课评生成/ # 课评生成技能 │ │ ├── 课评检查/ # 课评检查技能 │ │ └── 家长沟通/ # 家长沟通回复助手 │ ├── lesson/ # 课程内容库 │ │ ├── AIAGENT/ │ │ │ ├── AIAGENT-03/ # AIAGENT03班课程大纲 │ │ │ └── AIAGENT-06/ # AIAGENT06班课程大纲 │ │ ├── CSP/ # CSP课程大纲 │ │ │ ├── CSP03/ # CSP03班课程大纲 │ │ │ └── CSP04/ # CSP04班课程大纲 │ │ ├── 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网页/ │ ├── AIAGENT03提示词/ │ ├── 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 配置完善版）*