初始化课评系统仓库:包含规则配置、学生档案、课程教案、班级汇总
This commit is contained in:
255
.claude/skills/keping-使用指南.md
Normal file
255
.claude/skills/keping-使用指南.md
Normal file
@@ -0,0 +1,255 @@
|
||||
# 课评生成 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*
|
||||
Reference in New Issue
Block a user