更新课评生成技能：保存规则改为按课次顺序追加

2026-04-19 20:49:25 +08:00
parent fcc3ebed51
commit 1f0123c345
1 changed files with 235 additions and 40 deletions
--- a/.claude/skills/课评生成/skill.md
+++ b/.claude/skills/课评生成/skill.md
@@ -1,6 +1,6 @@
 ---
 name: 课评生成
-description: 根据学生画像、教学方案、过往表现生成个性化课评
+description: 根据课程记录文档批量生成个性化课评，支持单条生成和批量生成两种模式
 type: skill
 ---

@@ -13,18 +13,231 @@ type: skill
 └── 使用模板/          # 存放各类模板和示例
    ├── 学生画像模板.md
    ├── 课评示例.md
-    └── 快速参考卡.pdf
+    └── 课程记录模板.md   # 批量生成用的课程记录文档模板
 ```

 ## 🌟 功能说明
-本技能包专为穹狼科创编程课程设计，综合学生用户画像、教学方案、过往表现和课程特点，生成约200字的个性化课评。支持C++、AIGC、Kitten、体验课四大课程，按班级匹配专属评语风格。所有课评统一汇总到 `课评汇总-2026春季.md`，便于查阅和归档。
+本技能包专为穹狼科创编程课程设计，支持两种生成模式：
+1. **批量生成（推荐）**：用户提供课程记录 md 文档，自动解析学生名单并批量生成课评
+2. **单条生成**：针对单个学生逐一确认信息、读取资料、生成课评

-## 📋 使用流程
+综合学生用户画像、教学方案、过往表现和课程特点，生成约200字的个性化课评。支持C++、AIGC、Kitten、体验课四大课程，按班级匹配专属评语风格。所有课评统一汇总到 `课评汇总-2026春季.md`，便于查阅和归档。
+
+---
+
+## 📋 模式一：批量课评生成（推荐）
+
+### 使用流程
 ```
-1. 确认学生/课程/课次 → 2. 读取相关资料 → 3. 收集本次表现 → 4. 生成课评 → 5. 保存到学生文件夹
+1. 用户提供课程记录文档 → 2. 解析学生名单与表现 → 3. 按学生读取资料 → 4. 逐一生成课评 → 5. 保存到个人汇总（按课次顺序追加） → 6. 生成 output 周汇总文件
 ```

-## 🔧 具体步骤
+### 1. 课程记录文档格式
+用户提供的课程记录文档（md 格式）应包含以下内容：
+
+```markdown
+# 第X周课程记录
+
+**日期范围**：2026-04-17 至 2026-04-19
+
+---
+
+## 【周五下午 1700 AI03班】（1人上课）
+
+### 李梓宁
+- **课程**：AI大作家（下）
+- **日期**：2026-04-17
+- **课次**：第7课
+- **表现**：对自己的小说特别上心，不断调试修改，主动要求更好的效果，精益求精
+- **状态**：✅ 出勤
+
+---
+
+## 【周五晚上 1900 K4班】（4人上课）
+
+### 陈圆振
+- **课程**：彩虹生成器
+- **日期**：2026-04-17
+- **课次**：第7课
+- **表现**：思维敏捷，掌握分支嵌套知识点，认真完成作品，课堂积极性高
+- **状态**：✅ 出勤
+
+### 彭煜腾
+- **课程**：彩虹生成器
+- **日期**：2026-04-17
+- **课次**：第7课
+- **表现**：掌握循环嵌套结构，迅速完成作品，出现 bug 能主动拉着老师讨论
+- **状态**：✅ 出勤
+
+---
+
+## 【周六下午 1400 CSP03班】（4人上课，1人请假）
+
+### 郑子煜
+- **课程**：字符串处理
+- **日期**：2026-04-18
+- **课次**：第7课
+- **状态**：⏸ 请假
+- **备注**：请家长督促在家复习本周字符串相关知识点
+```
+
+### 2. 解析与处理流程
+1. **读取课程记录文档**：解析出周次、日期范围、各班级、学生名单及表现
+2. **过滤状态**：只处理 **状态为「✅ 出勤」** 的学生，跳过请假/缺勤学生
+3. **按学生循环处理**：
+   - 读取该学生的用户画像（`.claude/memory/student/[班级]/[姓名]/用户画像/[姓名].md`）
+   - 读取过往课评（`.claude/memory/student/[班级]/[姓名]/课评反馈/课评汇总-2026春季.md`）
+   - 读取课程教案（根据班级和课程名查找对应教案）
+   - 读取班级风格指南（`.claude/rules/[课程].md`）
+   - 结合课程记录中的「表现」字段，生成个性化课评
+4. **保存课评**：将新课评按课次顺序追加到个人汇总文件 **末尾**（详见下方保存规则）
+5. **更新出勤登记**：为出勤学生添加出勤记录
+
+### 3. 保存课评（按课次顺序追加）
+
+**目标文件路径**：
+`.claude/memory/student/[班级]/[姓名]/课评反馈/课评汇总-2026春季.md`
+
+**操作步骤**：
+1. 检查汇总文件是否存在，不存在则按模板创建
+2. 读取现有文件的全部内容
+3. **按课次顺序追加新课评到文件末尾**：
+   - 找到文件最后一个课评条目
+   - 在其后追加新条目，编号为 **最后一条编号 + 1**
+   - 新条目编号与 `lesson` 文件夹中的课程顺序一一对应
+4. **无需重新编号**：原有条目编号保持不变
+5. **新条目格式**：
+```markdown
+## 第[N]条：[课程名称]
+
+**授课日期**：[日期]
+
+**课评内容**：
+
+[课评正文]
+
+---
+```
+
+**示例**（追加前）：
+```markdown
+# 李梓宁 课评汇总（2026春季）
+
+**班级**：周五下午1700AI03班
+**学生**：李梓宁
+
+---
+
+## 第1条：AI是怎么想的
+
+**授课日期**：2026-03-08
+
+**课评内容**：...
+
+---
+
+## 第2条：AI的记忆之谜
+
+...
+```
+
+**示例**（追加后）：
+```markdown
+# 李梓宁 课评汇总（2026春季）
+
+**班级**：周五下午1700AI03班
+**学生**：李梓宁
+
+---
+
+## 第1条：AI是怎么想的
+
+**授课日期**：2026-03-08
+
+**课评内容**：...
+
+---
+
+## 第2条：AI的记忆之谜
+
+...
+
+---
+
+## 第3条：AI大作家（下）
+
+**授课日期**：2026-04-17
+
+**课评内容**：
+
+[新课评正文]
+
+---
+```
+
+### 4. 生成 output 周汇总文件
+
+**所有学生课评生成完毕后**，汇总本周所有课评到一个文件：
+
+**文件路径**：`output/第[X]周课评.txt`
+
+**文件格式**（最新日期在前，方便复制）：
+```
+========================================
+        第X周课评汇总
+        [日期范围]
+========================================
+
+----------------------------------------
+【周日下午 1400 AI03班】（4人上课）
+----------------------------------------
+
+【学生】贺楚悦
+【课程】AI大作家插图生成
+【日期】2026-04-19
+
+[课评正文]
+
+----------------------------------------
+
+【学生】林俊宇
+...
+
+========================================
+
+----------------------------------------
+【周日早上 0845 AI03班】（3人上课，1人缺勤）
+----------------------------------------
+
+...
+
+========================================
+              穹狼科创 · 2026春季学期
+========================================
+```
+
+**排序规则**：
+- 按班级分组，**日期最晚的班级排在最前面**
+- 同一班级内，学生顺序保持课程记录文档中的顺序
+- 请假/缺勤学生也列出，标注状态和备注
+
+**生成步骤**：
+1. 读取课程记录文档，按日期从晚到早排序班级
+2. 对每个班级，输出班级标题和人数信息
+3. 对出勤学生，从个人课评汇总文件中提取最新一条课评内容
+4. 对请假/缺勤学生，输出状态说明和复习建议
+5. 保存到 `output/第[X]周课评.txt`
+
+---
+
+## 📋 模式二：单条课评生成（备用）
+
+当不需要批量生成，只需要为单个学生写课评时使用。
+
+### 使用流程
+```
+1. 确认学生/课程/课次 → 2. 读取相关资料 → 3. 收集本次表现 → 4. 生成课评 → 5. 保存到学生文件夹（按课次顺序追加）
+```

 ### 1. 确认基本信息
 - 学生姓名：_______
@@ -66,41 +279,10 @@ type: skill
 ### 4. 生成课评（约200字）
 根据选择的风格组合内容：
 - 开场白（30字）+ 优点（60字）+ 建议（60字）+ 结束语（50字）
- 姓名称呼规则：如果学生姓名是三字姓名，正文中默认去掉姓氏，只保留后两个字称呼，例如”陈圆振”写作”圆振”，”王晨语”写作”晨语”，让语气更亲切。
+- 姓名称呼规则：如果学生姓名是三字姓名，正文中默认去掉姓氏，只保留后两个字称呼，例如"陈圆振"写作"圆振"，"王晨语"写作"晨语"，让语气更亲切。

-### 5. 保存课评（统一汇总）
-**不再单独保存分散文件**，所有课评统一追加到汇总文件：
-
-`.claude/memory/student/[班级]/[姓名]/课评反馈/课评汇总-2026春季.md`
-
-**汇总文件格式**：
-```markdown
-# [姓名] 课评汇总（2026春季）
-
-**班级**：[班级]
-**学生**：[姓名]
-
---
-
-## 第N条：[课程名称]
-
-**周节**：第[X]课
-
-**课评内容**：
-
-[课评正文]
-
---
-```
-
-**追加步骤**：
-1. 检查汇总文件是否存在，不存在则按模板创建
-2. 统计现有条目数，确定序号 N
-3. 在文件末尾追加新条目，包含：
-   - `## 第N条：[课程名称]`
-   - `**周节**：第X课`
-   - `**课评内容**：[课评正文]`
-4. 用 `---` 分隔条
+### 5. 保存课评（按课次顺序追加）
+保存规则与「模式一」第3节相同：将新课评按课次顺序追加到个人汇总文件末尾，原有条目编号保持不变。

 ### 6. 更新出勤登记（自动）
 保存课评后，自动在出勤登记文件中记录本次出勤：
@@ -120,6 +302,8 @@ type: skill
 3. 状态标记为"✅ 出勤"
 4. 备注栏留空

+---
+
 ## 🎨 学生类型速查

 | 观察点 | 鼓励型学生 | 激励型学生 |
@@ -157,6 +341,17 @@ type: skill
 - 鼓励结尾："期待在正式课堂上再次见到【姓名】！"

 ## ⏱️ 时间分配
+
+### 批量生成模式
+- 读取课程记录文档：2分钟
+- 按学生读取资料（可并行）：10分钟
+- 逐一生成课评：20分钟
+- 保存到个人汇总：3分钟
+- 生成 output 周汇总文件：3分钟
+- 更新出勤登记：2分钟
+- **总计：约40分钟**
+
+### 单条生成模式
 - 准备阶段：5分钟
 - 资料读取：10分钟
 - 表现记录：5分钟