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

.claude/skills/keping-advanced/速查卡.md

@@ -0,0 +1,193 @@
+# 高级课评 Skill - 快速参考
+
+## 🔥 触发命令
+
+```bash
+/课评          # 最简触发
+/keping        # 英文触发
+/写课评        # 中文触发
+生成课评       # 自然语言触发
+```
+
+---
+
+## ⚡ 快速用法（v2.1 新增周数自动计算）
+
+### 1. 极简输入（推荐）- 自动计算周数和主题
+
+```
+/课评 日期：4月2日 班级：发现世界-周四19点
+
+乔乔：知道这个主题，话题多，搭建快，开心
+昊昊：活跃，认真，开心
+```
+
+**系统自动**：
+1. 推算完整日期：2026-04-02
+2. 计算周数：**第5周**（3月2日基准）
+3. 匹配课程：**DISC-005 天平秤**
+4. 提取主题：杠杆原理、平衡判断
+5. 生成关联课评
+
+### 2. 标准用法 - 指定课程代码
+
+```
+/课评 学生:小明 班级:发现世界-周四19点 课程:DISC-005 表现:观望5分钟后主动尝试 情绪:稳定
+```
+
+### 3. 批量生成
+
+```
+/课评 批量:true 日期:4月2日 班级:发现世界-周四19点
+
+| 学生 | 核心表现 | 情绪 |
+|-----|---------|------|
+| 梁昕乔 | 快速启动→话题多→搭建快 | 开心 |
+| 钟昀昊 | 活跃→认真→渐入佳境 | 开心 |
+```
+
+---
+
+## 📅 学期周数速查（2026春季）
+
+**基准日期**：3月2日 = 第1周
+
+| 日期 | 周数 | 发现世界 | SPIKE | AI03 |
+|-----|:---:|:--------:|:-----:|:----:|
+| 3月2日-8日 | 第1周 | DISC-001 | SPIKE-001 | AI03-001 |
+| 3月9日-15日 | 第2周 | DISC-002 | SPIKE-002 | AI03-002 |
+| 3月16日-22日 | 第3周 | DISC-003 | SPIKE-003 | AI03-003 |
+| 3月23日-29日 | 第4周 | DISC-004 | SPIKE-004 | AI03-004 |
+| **3月30日-4月5日** | **第5周** | **DISC-005** | **SPIKE-005** | **AI03-005** |
+| 4月6日-12日 | 第6周 | DISC-006 | SPIKE-006 | AI03-006 |
+
+**当前**：2026年4月2日 = **第5周**
+
+---
+
+## 📋 8步流程速览（v2.1更新）
+
+| 步骤 | 动作 | 耗时 | 输出 |
+|:---:|:-----|:---:|:----|
+| 1 | 读取用户画像 | <1s | 气质、风格、优势 |
+| 2 | 读取课评规则 | <1s | 字数、模块、风格 |
+| **3** | **计算周数+匹配主题** | **<1s** | **第X周、课程代码、知识点** |
+| 4 | 读取历史课评 | <1s | 10次记录、趋势 |
+| 5 | 解析本节课表现 | <1s | 关键行为、情绪 |
+| 6 | 生成个性化课评 | 2-3s | 200-300字文本（关联主题） |
+| 7 | 保存到学生目录 | <1s | 文件路径确认 |
+| 8 | 更新成长记录 | <1s | 更新确认 |
+
+**总耗时**：约 5-8 秒
+
+---
+
+## 🎯 输入字段
+
+| 字段 | 必填 | 说明 | 示例 |
+|------|:---:|:----|:----|
+| `日期` | ❌ | **日期（自动计算周数）** | `日期:4月2日` |
+| `学生` | ✅ | 学生姓名 | `学生:小明` |
+| `表现` | ✅ | 核心课堂观察 | `表现:主动搭3层` |
+| `班级` | ❌ | 班级名称（用于匹配主题） | `班级:发现世界-周四19点` |
+| `课程` | ❌ | 课程代码（可选，自动匹配） | `课程:DISC-005` |
+| `情绪` | ❌ | 情绪状态 | `情绪:稳定/开心` |
+
+---
+
+## 📚 第5周主题速查（当前周：4月2日）
+
+| 班级 | 课程代码 | 主题 | 核心知识点 | 课评关联建议 |
+|-----|:-------:|:-----|:-----------|:-------------|
+| 发现世界 | DISC-005 | **天平秤** | 杠杆原理、平衡判断、重量比较 | 用衣架做简易天平比较重量 |
+| SPIKE | SPIKE-005 | **杯子盖球** | 传感器应用、条件判断、精准控制 | 调整传感器参数练习 |
+| AI03 | AI03-005 | **项目整合** | 多AI协作、工作流设计 | 整合前面所学完成小项目 |
+
+---
+
+## 📝 表现描述速记符号
+
+| 符号 | 含义 | 示例 |
+|:---:|------|:----|
+| `→` | 行为发展/时间线 | `观望5分钟→主动尝试` |
+| `,` | 并列行为 | `搭3层,自己调高度` |
+| `→`情绪 | 情绪变化 | `兴奋→烦躁` |
+| `比上周` | 纵向对比 | `比上周主动` |
+
+---
+
+## 🎨 年龄风格对照
+
+| 年龄段 | 字数 | 语气 | 侧重点 |
+|-------|:---:|:----|:-------|
+| 2.5-6岁 | 180-220 | 温暖具体 | 参与、情绪、兴趣 |
+| 6-8岁 | 190-230 | 尊重专业 | 能力、习惯、逻辑 |
+| 8-10岁 | 200-300 | 成长数据 | 项目、竞赛、自主 |
+
+---
+
+## 🔍 差异化示例
+
+**同一节课（第5周 DISC-005 天平秤）：**
+
+| 学生 | 气质 | 课评侧重 | 开头句式 |
+|------|------|---------|---------|
+| 梁昕乔 | 活泼型 | 快速理解杠杆原理、创意搭建 | "乔乔今天一上课就..." |
+| 钟昀昊 | 慢热型 | 渐入佳境、认真探索平衡 | "昊昊今天认真观察了..." |
+| 李怡瞳 | 初学型 | 参与度、支持理解重量比较 | "怡瞳今天尝试了..." |
+
+---
+
+## ✅ 质量检查清单
+
+生成后自动检查：
+
+- [ ] 字数 200-300 字
+- [ ] 5个必写模块完整
+- [ ] 学生姓名正确
+- [ ] **知识点与当周主题关联**
+- [ ] **周数标记正确（第X周）**
+- [ ] 无禁用词汇
+- [ ] 纵向对比有据
+- [ ] 建议可操作
+
+---
+
+## 📂 文件路径
+
+```
+# 读取
+memory/student/{班级}/{学生名}/用户画像.md      ← Step 1
+.claude/rules/15-semester-weeks.md              ← Step 3（周数计算）
+.claude/rules/20-style-building.md              ← Step 2
+memory/lesson/**/{课程代码}.md                  ← Step 3
+memory/student/{班级}/{学生名}/历史课评记录.md      ← Step 4
+
+# 写入
+memory/student/{班级}/{学生名}/课评/{日期}-{课程}.md  ← Step 7
+memory/student/{班级}/{学生名}/用户画像.md          ← Step 8
+memory/student/{班级}/{学生名}/历史课评记录.md          ← Step 8
+```
+
+---
+
+## ⚠️ 异常处理
+
+| 场景 | 提示 | 处理 |
+|------|------|:----:|
+| 无日期 | "请输入日期，如：4月2日" | 提示补充 |
+| 周数计算 | "自动计算：4月2日 = 第5周" | 自动处理 |
+| 无画像 | "未找到画像，使用通用模板" | 继续生成 |
+| 无教案 | "请手动输入知识点" | 提示补充 |
+| 历史不足 | "历史不足10次，使用全部" | 继续生成 |
+| 字数不足 | "字数偏短，建议补充" | 提示扩展 |
+
+---
+
+## 📞 支持
+
+如有问题，联系：穹狼教学团队
+
+---
+
+*速查卡 v2.1 | 2026-04-02*