256 lines
6.8 KiB
Markdown
256 lines
6.8 KiB
Markdown
# 课评生成 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*
|