Initial commit: 课评反馈系统 v1.0

.claude/skills/keping-使用指南.md

@@ -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*