清理旧文件并升级课评系统至笔记批量工作流

- 删除 lesson 下已迁移到独立仓库的课程大纲和 demo 文件 - 删除旧的「出勤登记」目录（已整合到 .claude/memory/class 下） - 删除临时调试文件（all_students.txt、has_profile.txt、oj_hw_a_debug.html） - 课评生成 skill 全面升级：支持从笔记文件批量生成课评 - AIGC.md 增加家长信固定开头格式，与 CSP03 统一 - 新增「课评写入和查找规则 V1.0.md」 - 更新 CLAUDE.md 班级学生数（33 人）
2026-05-15 16:17:19 +08:00
parent 640c275ba5
commit e28fb9921a
76 changed files with 381 additions and 16921 deletions
--- a/.claude/skills/课评生成/skill.md
+++ b/.claude/skills/课评生成/skill.md
@@ -12,8 +12,7 @@ type: skill
 ✅ 支持四大课程：C++/AIGC/Kitten/体验课  
 ✅ 自动匹配班级专属风格：AICODE03温暖鼓励型/K4温和鼓励型/CSP03要求型/体验课转化型  
 ✅ 自动整合OJ做题数据（CSP班级专属）  
-✅ 自动保存到学生个人课评汇总文件  
-✅ 自动更新出勤记录
+✅ 自动保存到学生个人课评汇总文件

 ## 💡 使用方式（超简单）
 你只需要提供以下信息：
@@ -31,13 +30,148 @@ type: skill
 2. CSP班级自动拉取OJ做题数据
 3. 生成约200字的个性化课评
 4. 自动保存到学生的课评汇总文件
-5. 自动更新出勤记录
+
+---
+
+## 📂 从笔记文件批量生成课评（推荐工作流）
+
+橙子平时在 `E:\cc\3笔记\第N课.md` 中记录学生出勤和简短课评，写完后提供文件路径给我，我会自动完成以下流程：
+
+### 输入文件格式
+橙子提供的笔记文件格式如下（示例）：
+```markdown
+# 课评记录表 — 2026年05月14日（周三）
+
+### AICODE03橙子周六1900
+| 姓名 | 出勤状况 | 课评 |
+|------|----------|------|
+| 陈嘉博 | 正常上课 | 表现积极，掌握了循环嵌套 |
+| 王子墨 | 请假 | |
+```
+
+### 工作流程
+```
+读取笔记 → 匹配课程计划 → 读取学生画像 → 润色生成 → 确认 → 保存
+```
+
+### 1. 读取笔记文件
+解析 `E:\cc\3笔记\第N课.md`：
+- 从文件名提取**课次**（如"第11课"）
+- 从文件头提取**日期**（如"2026年05月14日"）
+- 按班级区块解析，提取每个学生：
+  - 姓名、出勤状况、课评描述（用户写的简短描述）
+
+> **日期规则**：笔记批量流程中，所有日期（文件名 `YYYYMMDD`、授课日期）**统一以笔记文件头中的日期为准**，不另行查询课程计划中的上课时间。
+
+### 2. 匹配课程计划
+根据班级标题中的关键词匹配对应课程计划：
+
+| 班级标题关键词 | 课程计划路径 | 课程编号 |
+|---|---|---|
+| AICODE03 | `.claude/lesson/AICODE/课程计划.md` | AICODE03 |
+| CSP03 | `.claude/lesson/CSP03/课程计划.md` | CSP03 |
+| Kitten04 / K4 | `.claude/lesson/Kitten04/课程计划.md` | Kitten04 |
+
+从课程计划中提取对应课次的：
+- **课程名称**（如《进制转换》）
+- **教学目标 5个知识点**
+
+> **重要**：教案中的"教学目标"5条直接作为课评的5个知识点，不得修改或编造。
+
+### 3. 读取学生画像
+对每个学生，读取其个人画像档案：
+**路径**：`.claude/memory/class/[班级]/[姓名]/profile.md`
+
+### 4. 润色生成课评
+对笔记中列出的**每一个学生**，根据出勤状况处理，确保每个人都有对应记录：
+
+| 出勤状况 | 处理方式 | 保存位置 |
+|---|---|---|
+| 正常上课 | 读取画像 + 润色课评描述 → 生成完整课评 | 本班学生feedback目录 |
+| 请假 | 生成请假记录 | 本班学生feedback目录 |
+| 未上课 | 生成未到课记录 | 本班学生feedback目录 |
+| 补课-来自XX班 | 读取画像 + 润色课评描述 → 生成完整课评 | **补课班级**的`补课/[姓名]/feedback/`目录 |
+
+**润色规则**（对正常上课和补课学生）：
+- 保留用户描述中的所有事实（不能遗漏任何信息）
+- 根据学生画像调整语气和侧重（如内向学生多鼓励，活泼学生提专注）
+- 套用对应班级的固定开头（5个知识点）和结尾风格
+- 将简短描述扩展为约200字的完整家长信格式课评
+- **绝不编造**用户没有提到的内容
+
+**CSP班级专属**：同时自动拉取本节课OJ做题数据，整合到课评中
+
+**输出示例**：
+```markdown
+家长好，本周学习的内容是《魔幻俄罗斯方块（下）》：
+1. 理解"自动化测试"的概念
+2. 理解"测试覆盖"：每条规则都应有对应测试
+3. 功能扩展的增量思维
+4. 增量需求文档的编写方法
+5. 测试脚本生成与结果解读
+
+嘉博今天表现特别棒～对增量需求文档的理解很到位，能够自己写出清晰的测试用例～
+和AI协作完成俄罗斯方块的调试，遇到困难没有放弃，特别有韧性～
+要是可以在写需求文档的时候再仔细检查一下边界条件就更好啦～
+老师会继续关注嘉博的表现，期待看到更多精彩！🌟💡
+```
+
+### 6. 生成班级总结（所有班级）
+笔记中列出的**每一个班级**都会生成本节课的班级总结，不局限于特定班级：
+
+**内容来源**：
+- 课程名称 + 5个知识点（来自课程计划）
+- 该班级所有学生的整体表现（基于笔记中课评描述汇总）
+- 亮点学生、共性问题、课堂趣事
+
+**保存路径**：`.claude/memory/class/[班级]/summaries/YYYYMMDD_课程编号-课次_班级反馈.md`
+
+**格式**：使用对应班级自己的模板（`.claude/memory/class/[班级]/summaries/群发文案模板.md`或`班级反馈模板.md`）
+
+### 7. 确认流程
+所有课评和班级总结生成后，**先展示给橙子看，不保存**：
+- 按班级分组展示：个人课评 + 班级总结
+- 等待橙子确认或提出修改意见
+- 如有修改，即时调整后再次展示，直到橙子满意
+
+**橙子确认无误后，才执行以下保存操作**：
+1. 保存到学生个人单次课评文件
+2. 保存到学生个人课评汇总
+3. **保存到统一周课评汇总**（`E:/cc/2code/ClassFeedback/output/课评汇总/`），**后写的课评放在最前面**
+4. 保存班级总结
+5. 更新学生画像
+
+### 8. 更新学生画像（自动）
+保存课评的同时，根据本节课表现**适当更新**学生画像 `profile.md`：
+
+**更新原则**：
+- 只记录**新发现**或**明显变化**，不重复已有信息
+- 更新位置：在 profile.md 的"近期表现"或"课堂观察"部分追加
+
+**触发更新的典型情况**：
+- 展现出新的兴趣点（如"首次表现出对XX的浓厚兴趣"）
+- 能力有明显进步（如"打字速度比上学期快了很多"）
+- 性格/态度变化（如"从内向变得愿意主动提问"）
+- 需要持续关注的问题（如"近两次课专注力有所下降"）
+- 特殊事件（如"第一次独立完成完整作品"）
+
+**不更新的情况**：
+- 表现和画像中已有描述一致
+- 只是常规课堂表现，无特殊变化
+- 一次性的小问题（如"今天迟到"）
+
+更新格式示例：
+```markdown
+**2026-05-14 第11课观察**：
+- 对增量需求文档的理解力有提升，能自己写出测试用例
+- 遇到困难时不再马上求助，会先尝试独立调试
+```

 ---

 ## ⚙️ 核心生成逻辑（自动完成，你不需要操作）
 ```
-1. 读取参考资料 → 2. CSP班级自动拉取OJ数据 → 3. 生成个性化课评 → 4. 自动保存+更新出勤
+1. 读取参考资料 → 2. CSP班级自动拉取OJ数据 → 3. 生成个性化课评 → 4. 自动保存
 ```

 ### 1. 自动读取参考资料
@@ -86,7 +220,9 @@ python scripts/update_feedback_with_oj.py \
 ---

 ## 🎨 各班级风格规范（自动匹配）
-### AICODE03班 - 温暖鼓励型
+### AICODE03班 - 家长信格式·温暖鼓励型
+- 固定开头："家长好，本周学习的内容是《...》" + 5个知识点（与 CSP03 一致）
+- 课程目标后空一行，再写"课评反馈："正文
 - 多用"很棒"、"特别棒"、"超棒"和波浪号"～"
 - 描述具体行为："一字一字打字"、"和AI聊了一节课"
 - 温和建议用"要是...就更好啦～"
@@ -157,7 +293,8 @@ python scripts/update_feedback_with_oj.py \
 - **日期要求**：文件名中的`YYYYMMDD`必须与校宝`teaching_date`完全一致，不得使用编写/提交日期
 - **特殊状态文件**：
  - 请假：`YYYYMMDD_课程编号-课次(请假).md`
-  - 补课：`YYYYMMDD_课程编号-课次(补课-去班级名).md`
+  - 未上课：`YYYYMMDD_课程编号-课次(未到).md`
+  - 补课：正常文件名 `YYYYMMDD_课程编号-课次.md`，放在补课班级下的 `补课/` 目录中

 ### 1. 保存到学生个人单次课评文件（必须，用于自动化统计）
 为每位学生生成单独的单次课评文件，这是课评完成率统计的依据：
@@ -198,42 +335,34 @@ python scripts/update_feedback_with_oj.py \
 **排序规则**：最新生成的课评放在文件的最前面，旧的课评在后面，倒序排列
 **班级分组**：同一个班级的课评放在一起，按班级分组展示

-### 4. 补课学生特殊处理（双向记录）
-如果是补课学生，需要生成两条记录：
-**1) 原班级记录**：在原班级学生的feedback目录下生成补课追踪文件
- 文件名：`YYYYMMDD_原课程编号-课次(补课-去补课班级名).md`
- 内容：简要说明去哪补课
+### 4. 补课学生处理
+> 核心原则：学生来哪个班补课，课评就保存在**那个班的 `补课/` 目录下**。

-**2) 补课班级记录**：在补课班级的`补课/[学生姓名]/feedback/`目录下生成正常课评文件
- 文件名：`YYYYMMDD_补课课程编号-课次.md`
- 内容开头注明：`（补课，来自 [原班级名]）`，后续正常写课评
+- **保存路径**：`.claude/memory/class/[补课班级]/补课/[学生姓名]/feedback/`
+- **文件名**：`YYYYMMDD_课程编号-课次.md`
+  - 这里的**课程编号**使用补课班级本身的编号（如去CSP03班补课，就用 `CSP03`）
+- 文件内容正常写课评，无需特殊标记

-### 5. 班级总结保存（可选）
-如果需要生成班级总结，保存到班级的summaries目录：
+### 5. 班级总结保存
+为每个班级保存本节课的班级总结：
 **路径**：`.claude/memory/class/[班级]/summaries/YYYYMMDD_课程编号-课次_班级反馈.md`
 **格式**：使用课评规范V1.0中的班级群发文案模板

-### 6. 自动更新出勤登记
-自动在出勤登记表中添加本次出勤记录：
-**路径**：`.claude/memory/class/[班级]/[姓名]/feedback/出勤登记-2026春季.md`
+### 6. 未到课记录生成
+学生请假或未上课（人没到且无请假），都要生成记录文件：

-**格式**：
-```
-| 日期 | 课程 | 课次 | 状态 | 备注 |
-|------|------|------|------|------|
-| 2026-XX-XX | [课程名称] | 第X课 | ✅ 出勤 | |
-```
+**请假**：
+- **路径**：`.claude/memory/class/[班级]/[姓名]/feedback/YYYYMMDD_课程编号-课次(请假).md`
+- **格式**：使用课评规范V1.0中的请假记录模板

-### 7. 请假记录生成
-如果学生请假，生成专门的请假记录文件：
-**路径**：`.claude/memory/class/[班级]/[姓名]/feedback/YYYYMMDD_课程编号-课次(请假).md`
-**格式**：使用课评规范V1.0中的请假记录模板
+**未上课**：
+- **路径**：`.claude/memory/class/[班级]/[姓名]/feedback/YYYYMMDD_课程编号-课次(未到).md`
+- **格式**：简要记录本次未到课，无课评内容

 ### 保存完成后我会告诉你：
 ✅ 已保存X条课评
 ✅ 个人汇总已更新：X个学生的课评已追加
 ✅ 周汇总已更新：[周数]周汇总文件已更新，新课评已放在最顶部
-✅ 出勤登记已更新：X条出勤记录已添加

 ---