# 课评生成 Skill 使用指南

> Skill名称：`keping` | 触发命令：`/课评` `/keping` `/kp`

---

## 📋 功能简介

课评生成 Skill 是穹狼乐高编程课评系统的核心组件，根据教师极简输入自动生成个性化课后评价。

**核心价值**：
- 教师只需记录关键观察，AI自动扩展为完整课评
- 基于学生画像实现"千人千面"差异化输出
- 自动匹配课程知识点和教学风格
- 确保字数、格式、专业性符合标准

---

## 🚀 快速开始

### 基础用法（单学生）

```
/课评 学生:小明 表现:观望5分钟→主动搭3层→自己调高度
```

### 完整用法

```
/课评 \
  学生:小明 \
  班级:发现世界-周四19点 \
  课程:DISC-003 \
  表现:观望5分钟后主动尝试，搭了3层管道，球卡住时能自己调整入口高度 \
  情绪:稳定 \
  对比:比上周主动
```

---

## 📖 参数说明

| 参数 | 必填 | 说明 | 示例 |
|------|:---:|:----|:----|
| `学生` | ✅ | 学生姓名 | `学生:小明` |
| `表现` | ✅ | 核心课堂观察（关键行为） | `表现:主动搭3层，自己调高度` |
| `班级` | ❌ | 班级名称（用于匹配画像） | `班级:发现世界-周四19点` |
| `课程` | ❌ | 课程代码（用于提取知识点） | `课程:DISC-003` |
| `情绪` | ❌ | 情绪状态 | `情绪:稳定` / `情绪:开心→烦躁` |
| `对比` | ❌ | 与之前课对比 | `对比:比上周主动` / `对比:和之前一样` |
| `特殊` | ❌ | 特殊情况 | `特殊:中途上厕所` |

---

## 🎯 执行流程（8步）

```
输入解析 → 学生匹配 → 课程匹配 → 风格匹配 → 内容生成 → 个性化 → 格式校验 → 输出
```

### 详细流程

| 步骤 | 动作 | 说明 |
|:---:|------|------|
| 1 | **输入解析** | 提取姓名、班级、表现、情绪等关键信息 |
| 2 | **学生匹配** | 调取学生画像档案，获取气质、能力、历史表现 |
| 3 | **课程匹配** | 调取课程教案，提取知识点和目标 |
| 4 | **风格匹配** | 根据年龄确定语言风格（幼儿/小学低/小学中）|
| 5 | **内容生成** | 基于5个必写模块生成内容 |
| 6 | **个性化** | 根据学生画像调整侧重点和措辞 |
| 7 | **格式校验** | 检查字数、段落、禁用词、质量清单 |
| 8 | **输出** | 生成最终课评，附带审核状态 |

---

## 📝 输入示例

### 示例1：极简速记（推荐日常使用）

```
/课评 小明：观望5分钟→主动搭3层→自己调高度，情绪稳定，比上周主动
```

### 示例2：批量生成（一节课多学生）

```
/课评 批量:true

课程：TUBE-001
班级：小小班A班

| 学生 | 核心表现 | 情绪 | 亮点 |
|-----|---------|------|------|
| 小明 | 观望5分钟→主动搭3层→自己调高度 | 稳定 | 比上周主动 |
| 小红 | 全程专注→搭5层→加弯管 | 开心 | 主动帮助旁边 |
| 小强 | 频繁换玩法→未完整搭建 | 兴奋→烦躁 | 需引导坚持 |
```

### 示例3：详细输入（特殊学生）

```
/课评 \
  学生:天天 \
  班级:发现世界-周四19点 \
  课程:DISC-005 \
  表现:搭了4层但一倒就哭，老师安抚后继续完成，最后加了创意装饰 \
  情绪:敏感但可安抚 \
  对比:抗挫比上周有进步 \
  特殊:作品倒塌时情绪波动明显
```

---

## 🎨 输出格式

### 单学生输出

```
━━━━━━━━━━━━━━━━━━━━━━━
【学生：小明】198字 | 5段

小明今天学习了"互锁结构"——把积木像砌墙一样交错叠放...

[5段完整课评内容]

---
生成时间：2026-03-25 19:30
模板：幼儿积木-180-220字
审核状态：待教师审核
━━━━━━━━━━━━━━━━━━━━━━━
```

### 批量输出

```
━━━━━━━━━━━━━━━━━━━━━━━
【学生1：小明】198字 | 5段
[课评内容]

━━━━━━━━━━━━━━━━━━━━━━━
【学生2：小红】210字 | 5段
[课评内容]

━━━━━━━━━━━━━━━━━━━━━━━
【学生3：小强】175字 | 5段
⚠️ 字数偏短，建议补充

━━━━━━━━━━━━━━━━━━━━━━━

批量生成完成（3份）
✓ 字数检查：2份符合，1份偏短
✓ 重复检查：无雷同表述
✓ 差异化检查：3份侧重点各不相同
```

---

## ⚙️ 配置文件

Skill配置文件位置：`.claude/skills/keping.json`

### 可自定义项

| 配置项 | 说明 | 默认值 |
|-------|------|:------:|
| `quality_standards.word_count` | 字数标准 | 幼儿180-220 |
| `quality_standards.forbidden_words` | 禁用词汇 | ["宝贝", "小天才"...] |
| `workflow.steps` | 流程步骤 | 8步标准流程 |

---

## 🔄 与其他系统的协作

### 依赖数据源

```
memory/student/**/用户画像.md    → 学生性格、能力、历史表现
memory/lesson/**                 → 课程知识点、目标
.claude/rules/20-style-*.md      → 语言风格规则
.claude/rules/03-evaluation-dimensions.md  → 评价维度
```

### 输出目的地

```
.claude/output/课评-待审核/      → 生成后待教师审核
memory/student/**/历史课评记录.md    → 审核通过后归档
```

---

## ⚠️ 常见错误处理

| 场景 | 提示 | 处理方式 |
|------|------|---------|
| 未找到学生画像 | "未找到学生画像，使用通用模板..." | 先建立画像或继续用通用模板 |
| 未找到课程 | "未找到课程教案..." | 手动输入知识点或补充教案 |
| 字数偏短 | "⚠️ 字数偏短（175字），建议补充..." | 补充具体事例细节 |
| 缺少必填项 | "课堂表现为必填项..." | 补充 `表现:` 参数 |

---

## 📚 进阶用法

### 结合画像生成

当学生画像已建立时，Skill会自动：
- 识别气质类型（活泼/谨慎/平和/敏感）
- 匹配学习风格（视觉/听觉/动觉）
- 对比历史表现（纵向进步）
- 调整侧重点（如：谨慎型侧重勇气，敏感型侧重情绪）

### 千人千面实现

同一节课不同学生的课评会自动差异化：
- **开头句式**：避免雷同
- **侧重点**：根据学生特点
- **建议内容**：个性化家庭活动

---

## 🎯 最佳实践

### 教师记录技巧

```
# 高效速记格式
小明：观望5分钟→主动搭3层→自己调高度，稳定，比上周主动
# 解析：行为链（时间+动作+结果），情绪，对比

# 关键动词识别
- "主动" = 积极性
- "自己调整" = 掌握较好
- "坚持" = 抗挫能力
- "创新/加装饰" = 创意表现
```

### 审核检查清单

课评生成后，教师需确认：
- [ ] 学生姓名正确
- [ ] 日期/课程正确
- [ ] 具体事例真实
- [ ] 建议可操作
- [ ] 语气恰当

---

## 📞 支持

如有问题或建议，请联系：穹狼教学团队

---

*文档版本：v1.0 | 2026-03-25*