8.9 KiB
8.9 KiB
CLAUDE.md - 班级课评核心规范
本目录是课评系统的核心数据目录，包含所有班级、学生的课评档案、画像和沟通记录。
🚀 智能课评生成流程
🔧 推荐：使用课评生成技能
技能路径：../../skills/课评生成/SKILL.md
课评生成技能包支持：
- ✅ 超简单输入：只需提供学生姓名 + 班级 + 本节课表现
- ✅ 自动匹配风格：AIAGENT03温暖鼓励型 / CSP00·CSP04要求型 / 体验课转化型
- ✅ 批量处理：支持从笔记文件（
E:\cc\3笔记\第N课.md）批量生成课评 - ✅ CSP专属OJ数据：自动拉取OJ做题数据并整合到课评
- ✅ 自动多位置保存：单次课评文件 + 个人汇总 + 周汇总 + 班级总结
- ✅ 自动更新画像：根据本节课表现更新学生画像
📋 手动生成步骤（不推荐）
1. 确认学生/课程/课次 → 2. 读取相关资料 → 3. 收集本次表现 → 4. 生成课评 → 5. 保存到学生文件夹
步骤1：确认基本信息
- 学生姓名：_______
- 班级：_______
- 课程类型：□CPP □AIAGENT □KITTEN □体验课
- 本节课次：第_______课
- 课评风格：□鼓励型 □体验转化型
步骤2：参考资料
- 风格指南：
.claude/rules/[课程].md - 学生用户画像：
[班级]/[姓名]/profile.md（必须先看！） - 评语归档：
[班级]/[姓名]/feedback/ - 教学方案：根据课次查找对应教案（
.claude/lesson/）
步骤3：生成课评
根据学生画像和风格指南，生成约200字个性化课评
步骤4：保存归档（严格遵守命名规范）
命名规则：
- C++竞赛班统一用
CSP前缀，AI编程班统一用AIAGENT前缀，不得使用AI、C++等缩写 - 文件名格式：
YYYYMMDD_课程编号-课次.md（如20260418_CSP04-07.md、20260330_AIAGENT03-02.md） - 日期要求：
YYYYMMDD必须与校宝teaching_date完全一致，不得使用编写/提交日期
特殊文件命名：
- 请假记录：
YYYYMMDD_课程编号-课次(请假).md - 补课追踪：
YYYYMMDD_课程编号-课次(补课-去班级名).md
保存路径：
- 正常课评：
[班级]/[姓名]/feedback/YYYYMMDD_课程编号-课次.md - 补课学生：
[补课班级]/补课/[学生姓名]/feedback/YYYYMMDD_课程编号-课次.md
🎨 班级专属课评风格
AIAGENT03班 - 温暖鼓励型
特点： 温暖亲切、兴趣激发、表情符号多
- 语气：用"很棒"、"特别棒"、"超棒"、波浪号"～"
- 表情：🌟💡🌸😊💪✨
- 描述具体行为："一字一字打字"、"和AI聊了一节课"
- 提及学生感兴趣的项目："恐怖故事大王"
- 温和建议："要是...就更好啦～"
- 固定结尾："老师会继续关注XX的表现，期待看到更多精彩！🌟💡"
CSP00/CSP04班 - 家长信格式·要求型
特点： 温和但有要求、高期望
- 固定开头："家长好，本周学习的内容是《...》" + 5个知识点
- 表扬积极："状态在线"、"早早到校等候超积极"
- 期望要求："希望多思考"、"理解为什么这么写，不只是抄完就好～"
- 鼓励结尾："加油呀！💪✨"
体验课 - 家长信格式·转化导向型
特点： 展示价值、激发兴趣、促成报课
- 固定开头："家长好，今天体验的是《...》课程" + 课程价值介绍
- 突出"第一次"：强调新体验，降低焦虑，突出潜力
- 展示潜力：具体描述孩子在体验中展现的能力和天赋
- 建立愿景：描述继续学习后孩子能达到的水平
- 自然引导：用期待和相信来引导家长报课，不硬推销
- 鼓励结尾："期待在正式课堂上再次见到XX！"
📌 课评规范V1.0 重要说明
本项目已全面升级到课评规范V1.0，所有操作必须严格遵守以下要求：
核心规范
-
课程编号规则：
- C++竞赛班统一用
CSP前缀（如CSP00、CSP04） - AI编程班统一用
AIAGENT前缀（如AIAGENT03），不得使用AI缩写 - 课程编号必须与校宝系统完全一致
- C++竞赛班统一用
-
文件名规则：
- 正常课评：
YYYYMMDD_课程编号-课次.md - 请假记录：
YYYYMMDD_课程编号-课次(请假).md - 补课追踪：
YYYYMMDD_课程编号-课次(补课-去班级名).md - 日期必须与校宝
teaching_date完全一致，不得使用编写/提交日期
- 正常课评：
-
目录结构：
- 所有班级目录必须符合
课程编号+老师+星期时间格式 - 补课学生的课评必须放在补课班级的
补课/[学生姓名]/feedback/目录下
- 所有班级目录必须符合
-
完成率统计：
- 课评完成率由自动化系统根据文件结构和命名自动统计
- 只有符合规范的文件才会被计入完成率
- 请假学生不纳入应发总数，补课学生按到课处理
💡 使用示例
场景1：使用技能生成
生成过程：
- 确认学生信息：小明/三年级A班/AIAGENT/第5课/鼓励型
- 读取资料：用户画像(信心不足型)+风格指南(AIAGENT.md)
- 收集表现：掌握程度一般，但想象力丰富
- 生成课评：200字个性化内容
- 保存归档：学生课堂反馈文件夹
📁 目录结构说明
【课程+老师+时间】/ # 班级目录（如：AIAGENT03橙子周六1900）
├── summaries/ # 班级总结/群发文案
│ ├── YYYYMMDD_课程编号-课次_班级反馈.md
│ └── YYYYMMDD_课程编号-课次_微信群.txt
├── 补课/ # 补课学生专用目录
│ └── 【学生姓名】/
│ └── feedback/
│ └── YYYYMMDD_课程编号-课次.md
└── 【学生姓名】/ # 学生个人目录
├── feedback/ # 个人课评目录
│ ├── YYYYMMDD_课程编号-课次.md # 正常课评
│ ├── YYYYMMDD_课程编号-课次(请假).md # 请假记录
│ ├── YYYYMMDD_课程编号-课次(补课-去XX班).md # 补课追踪
│ └── 课评汇总-2026春季.md
├── communication/ # 家长沟通记录
│ ├── YYYYMMDD_问题类型.md
│ └── 沟通汇总-2026春季.md
├── profile.md # 学生画像
├── summary/ # 阶段性总结
│ └── YYYY-MM_月度总结.md
└── 照片视频/ # 学生上课作品/照片
📂 课评汇总网页文件夹规范
目标结构
output/课评汇总/
├── 第一周课评汇总/
│ ├── 📄 总览.html (可跳转到各节课)
│ ├── 📄 第1课-英雄的诞生-CSP00.html (班级课评)
│ ├── 📄 第1课-xxx-AIAGENT03汇总.html (班级汇总)
│ ├── 📄 第1课-xxx-AIAGENT03-李俊霆.html (个人课评)
│ └── 📁 照片/
│ ├── 20260904_CSP00_王晨语.jpg
│ ├── 20260904_CSP00_王晨语_2.jpg
│ └── ...
├── 第二周课评汇总/
│ ├── 总览.html
│ ├── 第2课-xxx-CSP00.html
│ └── 照片/
命名规范
| 类型 | 命名格式 | 示例 |
|---|---|---|
| 周文件夹 | 第X周课评汇总 | 第一周课评汇总 |
| 班级课评网页 | 第X课-课程名称-班级.html | 第1课-英雄的诞生-CSP00.html |
| 班级汇总网页 | 第X课-xxx-班级汇总.html | 第1课-xxx-AIAGENT03汇总.html |
| 个人课评网页 | 第X课-xxx-班级-姓名.html | 第1课-xxx-AIAGENT03-李俊霆.html |
| 学生照片 | 时间_课程_学生姓名.jpg | 20260904_CSP00_王晨语.jpg |
| 总览网页 | 总览.html | 总览.html |
操作流程
- 创建周文件夹：
output/课评汇总/第X周课评汇总/ - 创建照片文件夹：
output/课评汇总/第X周课评汇总/照片/ - 移动照片：从
input/移动到照片/文件夹，重命名格式时间_课程_学生姓名.jpg - 复制课评网页：从临时目录复制到周文件夹，更新照片路径
- 创建总览网页：包含所有课程链接，可跳转到各节课
注意事项
- 照片从
input/移动后要删除原文件 - 照片命名必须包含时间、课程、学生姓名
- 总览网页需要列出本周所有课程
- 课评网页中的照片路径使用相对路径
照片/xxx.jpg
🪤 踩坑日常
记录课评工作中的坑点，避免重复犯错。
1. 补课学生必须创建独立文件夹结构（2026-06-13）
问题：补课学生的课评文件直接放在 补课/ 根目录下，没有创建学生子文件夹和 feedback 目录。
正确结构：
补课/
├── 【学生姓名】/
│ └── feedback/
│ └── YYYYMMDD_课程编号-课次.md
注意：文件名只用 时间_课程编号-课次.md，不带学生姓名。
班级课评核心规范 v1.0