xiaoq/ClassFeedback
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
a048743b0ec3f6fbaf79b17f88cbb609ed31b4c5
ClassFeedback/.claude/skills/keping-advanced/SKILL.md

21 KiB
Raw Blame History

name, description, version, author
name description version author
keping-advanced 穹狼乐高编程高级课评生成Skill。当用户需要生成个性化课评、写课后反馈、创建学生评价时使用。根据学生画像、课程教案、历史课评、学期周数等多维度信息，自动生成180-350字专业课评（根据输入丰富度弹性调整）。支持自动周数计算和主题关联。采用"生成即双轨保存"流程：课评生成后立即自动保存到班级周汇总和个人档案，无需教师确认。同时自动更新出勤统计。支持补课/体验学生的灵活处理（可仅保存到班级周汇总）。适用于2.5岁-小学四年级学生，支持幼儿积木、少儿编程、机器人竞赛等多种课程类型。触发词：/课评、/keping、/写课评、生成课评。 3.1.0 穹狼教学团队

高级课评生成 Skill

功能概述

本Skill根据学生画像、课程教案、历史表现等多维度信息，自动生成个性化课后评价（180-350字，根据输入丰富度弹性调整）。

核心能力

  • 读取并分析学生画像档案
  • 匹配课程教案提取知识点
  • 回顾近10次历史课评找规律
  • 结合本节课实时表现
  • 生成千人千面差异化课评
  • 自动保存并更新成长记录

8步执行流程（v3.1 生成即双轨保存模式 + 出勤统计自动更新）

┌─────────────────────────────────────────────────────────────────────────┐
│  Step 1: 读取学生用户画像                                                │
│       ├── 情况A：学生档案存在 → 正常读取                                  │
│       └── 情况B：学生档案不存在（补课/体验学生）→ 标记类型                  │
│  Step 2: 读取对应课程的课评规则                                          │
│  Step 3: 读取本节课教案内容（含周数计算）                                │
│  Step 4: 读取该学生近10次历史课评（如存在）                              │
│  Step 5: 结合教师提供的本节课表现                                        │
│  Step 6: 生成180-350字个性化课评（根据输入丰富度弹性调整）               │
│       ↓ 【自动生成】                                                      │
│  Step 7: 【自动双轨保存】                                                │
│       ├── 7.1 保存到班级周汇总：`memory/class-evaluation-summary/第X周/{班级}.md` │
│       ├── 7.2 保存到个人历史课评（如有档案）：                            │
│       │   ├── 常规学生：`memory/student/{班级}/{学生}/历史课评记录.md`          │
│       │   └── 补课学生：同时保存到补课班级汇总 + 原班级个人档案               │
│       └── 7.3 更新出勤统计：`memory/class-evaluation-summary/第X周/出勤统计.md`   │
│  Step 8: 展示保存结果，教师可随时查看/修改                               │
└─────────────────────────────────────────────────────────────────────────┘

重要变更：

  1. v3.1 生成即双轨保存：课评生成后立即自动保存，无需教师确认
  2. 自动更新出勤统计：每次保存自动更新出勤统计文件
  3. 全程可修改：保存后教师可随时修改，修改自动同步到两个位置

详细流程说明

Step 1: 读取学生用户画像并确定称呼方式

操作：

  1. 检查学生档案是否存在：

    • 检查路径：memory/student/{班级}/{学生名}/
    • 检查文件：用户画像.md、历史课评记录.md

  2. 情况A：学生档案存在（常规学生）

    • 读取 memory/student/{班级}/{学生名}/用户画像.md
    • 提取完整信息：气质类型、学习风格、历史表现等
    • 标记类型：student_type = "regular"

  3. 情况B：学生档案不存在（补课/体验学生）

    • 提醒教师： 
      ⚠️ 检测到新学生：[学生姓名]

该学生暂无个人档案，可能是：
1. 补课学生（已有档案在其他班级）
2. 体验课学生（首次到店试听）
3. 新转入学生（尚未建立档案）

是否需要为该学生创建个人档案？
[是，创建档案]  [否，仅保留在班级周汇总]
    • 标记类型：student_type = "guest"（补课/体验）
    • 使用通用模板生成课评
    • 称呼方式：使用输入姓名（不去除姓氏）

姓名处理详细规则：

  1. 谐音纠正（输入匹配）：

    • 问题：教师输入可能有谐音词（如"小鱼"→黄晓瑜、"君玲"→罗钧龄）
    • 解决：将输入姓名与班级学生名单进行拼音/字形相似度匹配
    • 匹配优先级：
      • 相似度>90%：自动纠正，不打扰
      • 相似度70-90%：生成前提示确认
      • 相似度<70%：要求重新输入
    • 示例：
      • 输入"小鱼" → 匹配"黄晓瑜"（小名/昵称关联）
      • 输入"良心桥" → 纠正为"梁昕乔"
      • 输入"中云浩" → 纠正为"钟昀昊"

  2. 称呼方式确定（输出优先级）：

    优先级1：小名/昵称（画像中"nickname"字段，如"小鱼"）
优先级2：去姓称名（双字名，如"晓瑜""钧龄""思霖"）
优先级3：叠字称呼（单字名，如"昊昊""婷婷"）
优先级4：全名（特殊要求，如"黄晓瑜"）

  3. 称呼示例：

    全名 小名/昵称 去姓称名 课评最终称呼
    黄晓瑜 小鱼 晓瑜 小鱼（昵称优先）
    罗钧龄 无 钧龄 钧龄（去姓）
    简思霖 无 思霖 思霖（去姓）
    梁昕乔 乔乔 昕乔 乔乔（小名优先）
    钟昀昊 无 昀昊 昀昊（去姓）
    张昊 无 昊昊（叠字） 昊昊（单字名叠字）

输出：student_profile 对象（含display_name课评用称呼）

Step 2: 读取对应课程的课评规则

操作：

  • 根据课程类型（幼儿/小学低/小学中）读取对应风格规则：
    • 幼儿（2.5-6岁）：.claude/rules/10-style.md（第3.1节）
    • 小学低年级（6-8岁）：.claude/rules/10-style.md（第3.2节）
    • 小学中高年级（8-10岁）：.claude/rules/10-style.md（第3.3节）
  • 提取：
    • 字数要求（弹性范围180-350字）
    • 必写模块结构
    • 语言风格要求
    • 禁用词汇

输出：style_rules 对象

Step 3: 读取本节课教案内容（含周数计算）

操作：

3.1 周数自动计算（新增）

  • 读取学期周数规则：.claude/rules/15-semester-weeks.md（保持独立，未合并）
  • 基准设定：2026年3月2日 = 第一周
  • 计算公式：周数 = Floor((当前日期 - 3月2日) / 7) + 1
  • 周数速查（2026春季学期）：
    • 3月2日-8日 = 第1周
    • 3月9日-15日 = 第2周
    • 3月16日-22日 = 第3周
    • 3月23日-29日 = 第4周
    • 3月30日-4月5日 = 第5周（当前周）
    • 以此类推...

3.2 课程代码自动匹配（新增） 根据班级类型和周数，自动匹配课程代码：

班级类型 周数 自动匹配课程代码 主题
发现世界 第5周 DISC-005 天平秤
SPIKE 第5周 SPIKE-005 杯子盖球
AI03 第5周 AI03-005 项目整合

3.3 提取教案内容

  • 根据课程代码（如：DISC-005, SPIKE-005）定位教案
  • 提取：
    • 课程主题
    • 核心知识点
    • 教学目标
    • 评价维度
    • 适龄提示

路径：memory/lesson/{课程目录}/{课程代码}.md

输出：lesson_content 对象（含week_number周数信息）

Step 4: 读取该学生近10次历史课评

操作：

  • 读取 memory/student/{班级}/{学生名}/历史课评记录.md
  • 提取最近10条记录
  • 分析：
    • 能力发展趋势
    • 进步轨迹
    • 反复出现的问题
    • 优势稳定领域
    • 与本次课可对比的点

输出：history_reviews 数组 + trend_analysis 分析

Step 5: 结合教师提供的本节课表现

操作：

  • 解析教师输入的核心表现描述
  • 提取关键行为词（如：主动、坚持、创新、求助等）
  • 识别情绪状态
  • 判断与常态的差异

输入格式：

学生:小明 表现:观望5分钟→主动搭3层→自己调高度 情绪:稳定 对比:比上周主动

输出：current_performance 对象

Step 6: 生成200-300字个性化课评

核心逻辑：

  1. 使用正确的称呼：

    • 全程使用 display_name（Step1确定的小名/去姓/叠字）
    • 禁止使用全名（除非家长特殊要求）

  2. 插入Emoji（每段末尾）：

    • 幼儿版（2.5-6岁）：
      • 模块1（课程知识点）：🔍
      • 模块2（掌握程度）：✨ 或 ✋
      • 模块3（课程环节与目标达成）：🎯 或 📋
      • 模块4（成长亮点）：🌱 或 💪
      • 模块5（课后建议）：🏠 或 🎮
      • 总计10-15个emoji，每段末尾1-2个
    • 小学低年级版（6-8岁，Kitten/SPIKE）：
      • 模块1（课程知识点）：💡 或 📚
      • 模块2（掌握程度）：✓ 或 ⚡
      • 模块3（课程环节与目标达成）：🎯 或 ✅
      • 模块4（成长亮点）：📈 或 💪
      • 模块5（课后建议）：🏠 或 🔧
      • 总计5个emoji，每段末尾1个，简洁专业
    • 小学高年级版（8-10岁，机器人/AI）：
      • 模块1（课程知识点）：⚙️ 或 🤖
      • 模块2（掌握程度）：📊 或 ⚡
      • 模块3（课程环节与目标达成）：🎯 或 ✅
      • 模块4（成长亮点）：📈 或 🚀
      • 模块5（课后建议）：🏠 或 🔧
      • 总计5个emoji，每段末尾1个，体现竞技感

  3. 确定侧重点（基于画像差异化）：

    • 活泼型学生 → 突出创意和参与热情
    • 谨慎型学生 → 肯定尝试勇气
    • 敏感型学生 → 强调支持和情绪管理
    • 慢热型学生 → 认可渐入佳境的过程

  4. 选择对比维度（基于历史）：

    • 与上节课比：最近进步
    • 与入学初比：长期成长
    • 与班级常态比：独特表现

  5. 首次上课/补课表述规则（重要）：

    • 原则：仅在教师输入中明确写明"第一次上课"、"新学生"等关键词时，才能在课评中提及相关内容
    • 补课特殊情况：若学生是补课（非首次到店），即使第一次上这节课，也不要写"第一次上课"、"第一次接触"等表述
    • 区分方式：
      • 教师写"新学生"/"第一次来"/"首次上课" → 可写"第一次上课"
      • 教师写"补课"/"插班" → 不写"第一次上课"，即使第一次上这节课
    • 示例：
      • ✅ 教师输入"余正逸是新学生，第一次来上课" → 课评可写"正逸这节课是第一次接触天平秤"
      • ✅ 教师输入"余正逸是补课" → 课评不写"第一次"，可写"正逸这节课表现..."
      • ❌ 教师未提及，但AI推断是补课 → 课评不得写"作为补课学生"、"第一次接触"等

  6. 构建3段内容（新段落结构）：

    段落分配：

    • 第1段：课程知识点（30-40字）- 介绍本节课核心知识/技能
    • 第2段：课堂细节长段落（100-130字）- 包含掌握程度、课程环节表现、成长亮点等详细描述
    • 第3段：课后建议（30-40字）- 家庭延伸活动建议
    内容模块 字数 归属段落
    课程知识点 30-40 第1段
    掌握程度 30-40 第2段（长段落）
    课程环节与目标达成 40-50 第2段（长段落）
    成长亮点 40-50 第2段（长段落）
    课后建议 30-40 第3段

    注意：第2段为长段落，整合掌握程度、课堂表现、成长亮点等内容，用1-2个emoji自然分隔

  7. 语言风格适配：

    • 幼儿期：温暖具体，画面感，丰富emoji
    • 小学低段：尊重专业，平等对话，简洁emoji
    • 小学高段：成长视角，数据支撑，结构化

输出：evaluation_text（180-350字，含emoji），等待教师确认后再执行Step7

Step 7: 双轨保存课评（需教师确认后执行）

触发条件：教师确认课评内容无误后

操作逻辑：

IF student_type == "regular"（常规学生）:
    ├── 7.1 保存到班级周汇总
    │   └── 路径：`memory/class-evaluation-summary/第X周/{班级}.md`
    └── 7.2 保存到个人历史课评
        └── 路径：`memory/student/{班级}/{学生}/历史课评记录.md`
    
ELSE IF student_type == "guest"（补课/体验学生）:
    └── 仅保存到班级周汇总
        └── 路径：`memory/class-evaluation-summary/第X周/{班级}.md`
        └── 标记：(补课/体验学生，无个人档案)

班级周汇总文件结构：

# 发现世界-周四19点 第7周汇总

## 学生课评列表

### 梁昕乔（常规学生）✓
[课评内容]
- 状态：已确认
- 个人档案：已同步

### 钟昀昊（常规学生）✓
[课评内容]
- 状态：已确认
- 个人档案：已同步

### 张小明（补课学生）⚠️
[课评内容]
- 状态：已确认
- 个人档案：未创建（补课/体验学生）
- 备注：如需创建档案，请回复「为张小明创建档案」

输出：保存确认 + 文件路径 + 学生类型标记

Step 8: 更新学生成长记录（常规学生执行，补课/体验学生跳过）

触发条件：

  • 仅对 student_type = "regular" 的学生执行
  • 补课/体验学生（student_type = "guest"）跳过此步骤

操作：

  • 更新 memory/student/{班级}/{学生名}/用户画像.md 中的成长轨迹表
  • 更新 memory/student/{班级}/{学生名}/历史课评记录.md
  • 添加新记录：
    • 时间：本次课日期
    • 课程：课程代码
    • 关键表现：一句话摘要
    • 能力变化：+/- 标记

补课/体验学生的后续处理： 如果教师后续决定为补课/体验学生创建档案：

  1. 创建文件夹：memory/student/{班级}/{学生名}/
  2. 创建通用用户画像
  3. 将该学生的历史课评从班级周汇总迁移到个人档案
  4. 标记为常规学生

输出：更新确认

输入格式规范

详见：.claude/rules/20-workflow.md — 包含极简输入、速记符号、批量输入、语音输入、补课处理等完整规范。

快速参考：

日期：4月2日
班级：发现世界-周四19点
乔乔：知道这个主题，话题多，搭建快
昊昊：活跃，认真，开心

输出格式（双版本）

  • 学龄前版（2.5-6岁）：表情增强型，参考 .claude/rules/50-output-format-preschool.md
  • 小学版（6-10岁）：结构化型，参考 .claude/rules/51-output-format-elementary.md

注：50/51输出格式文件保留了独立的排版样式示例，核心规则已合并至 10-style.md

格式根据学生年龄段自动选择。

依赖文件路径

# 学生画像
memory/student/{班级}/{学生名}/用户画像.md

# 课程教案
memory/lesson/01-发现世界-螺丝刀/{课程代码}.md
memory/lesson/08-SPIKE/{课程代码}.md
memory/lesson/09-AI03-AICODE/{课程代码}.md

# **学期周数与主题映射（新增）**
.claude/rules/15-semester-weeks.md

# **班级周汇总（新增 - 按周期分班级）**
memory/class-evaluation-summary/第X周/{班级}.md

# 学期周数（保持独立）
.claude/rules/15-semester-weeks.md

# 风格规则（已合并至10-style.md）
.claude/rules/10-style.md                # 全年龄段风格规范

# 评价维度（已合并至00-core.md）
.claude/rules/00-core.md                 # 核心规则（含评价维度）

# 历史课评
memory/student/{班级}/{学生名}/历史课评记录.md

# 输出目录
memory/student/{班级}/{学生名}/课评/
memory/class-evaluation-summary/第X周/              # **新增**：按周期分班级的周汇总

千人千面实现

同一节课，不同学生的课评差异

示例：DISC-003 互锁结构

学生 气质 侧重点 开头句式
梁昕乔 活泼型 快速启动、创意表现 "昕乔今天一上课就..."
钟昀昊 平和型+慢热 渐入佳境、坚持过程 "昀昊今天用了点时间进入状态..."
李怡瞳 平和型+初学 参与度、降低难度 "怡瞳今天尝试了..."

差异化策略

  1. 开头差异化：

    • 快速启动型："一上课就..."
    • 慢热型："今天用了点时间..."
    • 进步型："和上周相比..."
    • 突破型："今天终于..."

  2. 侧重点差异化：

    • 创意优势学生 → 肯定创新设计
    • 坚持性弱学生 → 突出不放弃
    • 社交活跃学生 → 强调合作分享
    • 敏感型学生 → 强调情绪管理

  3. 建议差异化：

    • 同一知识点，给不同家庭活动建议

质量检查清单

生成后自动检查（详见 .claude/rules/00-core.md 质量检查清单）：

  • 字数 180-350 字（根据输入丰富度弹性调整）
  • 5个必写模块完整
  • 学生称呼正确（使用display_name）
  • 课程知识点准确
  • Emoji在段落末尾
  • 无周数显示

异常处理

场景 处理方式
未找到学生画像 提示建立画像，使用通用模板继续
未找到课程教案 提示补充教案，或教师手动输入知识点
表现描述过于简单 提示补充关键行为细节
字数不足 提示补充具体事例
补课/体验学生 详见 20-workflow.md（第5-6节）

补课/体验学生处理、跨班级补课自动保存等详细规则，参见 .claude/rules/20-workflow.md（第5-6节）和 CLAUDE.md 存储双轨制章节。

示例运行

示例1：极简输入（推荐）- 自动计算周数和主题

输入

/keping 日期：4月2日 班级：发现世界-周四19点

乔乔：知道这个主题，话题多，搭建快，开心
昊昊：活跃，认真，开心

执行过程

  1. ✓ 解析日期：4月2日 → 2026-04-02
  2. ✓ 计算周数：(4月2日 - 3月2日) = 31天 → Floor(31/7) + 1 = 第5周
  3. ✓ 匹配课程：发现世界 + 第5周 → DISC-005 天平秤
  4. ✓ 提取主题：杠杆原理、平衡判断、重量比较
  5. ✓ 读取画像：乔乔（活泼型、快速启动、创意突出）、昊昊（平和型+慢热、渐入佳境）
  6. ✓ 读取历史：10次课评，表现稳定
  7. ✓ 解析表现：乔乔（快速启动+创意）、昊昊（渐入佳境+认真）
  8. → 生成关联课评：结合"天平秤"主题，强调杠杆原理探索
  9. → 保存文件
  10. → 更新记录

输出课评（乔乔）

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【学生：梁昕乔（乔乔）】DISC-005 天平秤 🔍

乔乔本周探索了"天平秤"，学习了杠杆原理——两边的重量相等时天平就会平衡 ✨

这节课乔乔状态特别好，对天平主题很熟悉，老师一讲解就能跟上，话题很多，搭建速度也很快，展现出很好的学习热情。全程专注且开心，一上课就表现出浓厚兴趣，还主动和旁边的小朋友分享自己的想法，互动特别积极。和之前相比，乔乔在动手方面表现越来越稳定，能快速理解结构原理，这个进步值得肯定 💪✨

在家可以用衣架和绳子做一个简易天平，比较不同玩具的重量，巩固今天的平衡概念 🏠
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

版本历史

版本 日期 更新内容
v2.5.0 2026-05-01 统一字数标准：将课评字数统一为弹性范围180-350字，与系统规则保持一致
v2.4.0 2026-04-16 补课/体验学生支持：新增对补课、体验课学生的处理逻辑——无档案时提醒教师，可选择仅保存到班级周汇总，不强制创建个人档案
v2.3.0 2026-04-15 双轨存储：新增班级周汇总功能，确认后同时保存到 class-evaluation-summary/（班级视角）和 student/（个人视角），便于集中查看当周全班表现
v2.2.0 2026-04-04 流程优化：新增"确认后保存"模式，Step 6生成后等待教师确认，确认后再执行Step 7-8保存，避免自动保存错误内容
v2.1.0 2026-04-02 重大更新：支持学期周数自动计算（基准3月2日），课程主题自动匹配，课评内容关联当周知识点，Emoji段落末尾插入，删除正文周数显示
v2.0.0 2026-03-25 高级版本，支持8步完整流程，历史课评回顾，千人千面差异化
v1.0.0 2026-03-25 基础版本，单维度课评生成

维护者：穹狼教学团队 最后更新：2026-04-16

Reference in New Issue View Git Blame Copy Permalink