# 课评生成快速入门指南

> 穹狼乐高编程AI课评系统 - 5分钟上手版
> 
> **完整文档**：参见 `SKILL.md` (keping-advanced)

---

## 🚀 两种方式速查

| 方式 | 命令 | 适用场景 | 学生数 |
|------|------|---------|--------|
| **单个生成** | `/课评 学生:XXX 表现:XXX` | 特殊情况、重点关注 | 1人 |
| **批量生成** | `/课评 批量:true` + 表格 | 常规课堂、多学生 | 2-15人 |

---

## 📝 单个学生课评

### 最简格式（推荐）
```
/课评 乔乔：快速启动→搭3层→自己加装饰，情绪开心
```

### 标准格式
```
/课评 学生:钟昀昊 班级:发现世界-周四19点 表现:慢热→搭3层→反复调整 情绪:稳定
```

### 关键字段
- **学生**：姓名（支持谐音自动纠正）
- **表现**：核心观察（用`→`表示行为发展）
- **情绪**：稳定/开心/低落等
- **对比**：比上周/和之前一样

---

## 📊 批量课评生成

### 命令格式
```
/课评 批量:true 课程:DISC-003 班级:发现世界-周四19点 日期:4月2日

| 学生 | 核心表现 | 情绪 | 亮点 |
|-----|---------|------|------|
| 乔乔 | 快速启动→搭3层→加装饰 | 开心 | 创意突出 |
| 昊昊 | 慢热→搭3层→反复调整 | 稳定 | 渐入佳境 |
```

---

## ⚡ 速记符号

| 符号 | 含义 | 示例 |
|------|------|------|
| `→` | 行为发展/时间线 | `观望5分钟→主动尝试` |
| `,` | 并列行为 | `搭3层,自己调高度` |
| `→`情绪 | 情绪变化 | `兴奋→烦躁` |
| `比上周` | 纵向对比 | `比上周主动` |

---

## 🎯 流程：生成 → 确认 → 保存

```
教师输入 → AI生成课评 → 【等待确认】 → 确认后自动保存
                              ↓
                          需修改？→ 重新生成
```

**确认指令**："确认"、"保存"、"没问题"  
**修改指令**：直接指出修改意见

---

## 📁 文件存储位置

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

---

## ❓ 常见问题

**Q：学生画像缺失怎么办？**  
A：系统会继续生成，使用通用模板。建议后续补建画像。

**Q：课程代码记不清？**  
A：可用课程名称代替，系统会从班级信息自动推断。

**Q：生成的课评不满意？**  
A：修改输入描述增加具体细节，或直接手动编辑。

---

## 📞 支持

- **完整规则**：参见 `.claude/rules/` 目录
- **课程教案**：参见 `memory/lesson/` 目录
- **学生档案**：参见 `memory/student/` 目录

---

*版本：v2.0（精简版）*  
*完整版：参见 SKILL.md*