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