更新课评系统代码

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

@@ -0,0 +1,219 @@
+# 课评优化工具速查卡
+
+## 一、核心优化功能
+
+| 功能 | 说明 | 使用场景 |
+|------|------|---------|
+| **三级备份** | 防止数据丢失，主文件+备份+bak文件 | 所有保存操作自动执行 |
+| **自动补全** | 日期、课程编号、课次自动填入 | 教师只需输入学生表现 |
+| **路径自动创建** | 自动创建不存在的目录 | 首次保存新学生/新班级 |
+| **速记补全** | 输入过程中实时提示速记含义 | 快速输入时 |
+| **实时校验** | 保存前检查规范，提前发现问题 | 生成完成后 |
+| **智能预加载** | 根据时间自动预加载当天班级 | 开始工作时 |
+
+---
+
+## 二、速记符号表
+
+### 核心符号（必记）
+| 符号 | 含义 | 完整描述 |
+|------|------|---------|
+| `gj` | 观望 | gj5=观望5分钟 |
+| `zd` | 主动搭 | zd3=主动搭3层 |
+| `zt` | 自己调整 | 球卡住时自己调整高度 |
+| `wb` | 完成 | 独立完成搭建 |
+| `↑` | 开心/积极 | 情绪良好 |
+| `→` | 稳定/平和 | 情绪稳定 |
+| `++` | 比上周进步 | 表现更好 |
+
+### 扩展符号
+| 符号 | 含义 | 完整描述 |
+|------|------|---------|
+| `zx` | 专注 | zx15=专注15分钟 |
+| `sb` | 失败后调整 | sb2=失败2次后成功 |
+| `ts` | 探索 | ts5=探索5分钟 |
+| `cz` | 创造 | cz3=3种创意方案 |
+| `wt` | 提问 | wt3=提问3次 |
+| `hz` | 合作 | 合作完成 |
+| `fx` | 分享 | 分享想法/作品 |
+
+---
+
+## 三、快捷指令
+
+### 班级选择
+| 指令 | 功能 |
+|------|------|
+| **`/周几`** | **按上课日快速索引（推荐）**，如 `/周六`、`/周日` |
+| `/今天` | 自动判断当天星期几，选择对应班级 |
+| `/本周` | 选择本周班级列表 |
+| `/班级 {班级名}` | 手动选择指定班级 |
+
+### 模板工具
+| 指令 | 功能 |
+|------|------|
+| `/模板 {班级}` | 加载班级学生名单模板 |
+| `/空模板` | 创建空模板 |
+
+### 批量操作
+| 指令 | 功能 |
+|------|------|
+| `/批量修改 {查找}→{替换}` | 批量替换课评内容 |
+| `/批量添加 {内容}` | 批量在课评结尾添加内容 |
+
+### 数据恢复
+| 指令 | 功能 |
+|------|------|
+| `/恢复 {学生}` | 恢复该学生的备份 |
+| `/恢复备份` | 恢复最近一次备份 |
+| `/清理备份` | 清理过期备份文件 |
+
+### 校验检查
+| 指令 | 功能 |
+|------|------|
+| `/检查` | 检查本周课评是否符合规范 |
+| `/检查 {班级}` | 检查指定班级课评 |
+
+### 保存与补存
+| 指令 | 功能 |
+|------|------|
+| `/补存` | 尝试重新保存失败的课评 |
+| `/学生 {姓名}` | 查看学生档案和历史课评 |
+
+### 修复工具
+| 指令 | 功能 |
+|------|------|
+| `/修复` | 处理待修复列表中的项目 |
+
+---
+
+## 四、规范检查要点
+
+### 课程编号规范
+| 错误 | 正确 |
+|------|------|
+| C++ | CSP |
+| AI03 | AICODE03 |
+| AI编程 | AICODE |
+
+### 日期格式
+- ✅ 正确：20260516
+- ❌ 错误：2026/05/16、5月16日、05/16
+
+### 文件命名
+- ✅ 正确：20260516_DISC-011.md
+- ❌ 错误：5月16日课评.md、第11周课评.md
+
+### 禁用词汇（课评正文）
+- ❌ 补课、来补课、作为补课学生
+- ❌ 第一次上课（除非教师明确说明）
+- ❌ C++、AI编程（使用标准编号）
+
+---
+
+## 五、备份与恢复
+
+### 备份位置
+```
+主文件：.claude/memory/class/{班级}/{学生}/feedback/YYYYMMDD_课程编号-课次.md
+备份文件：.claude/.backup/YYYYMMDD_HHMMSS_{学生}.md
+旧文件备份：原文件路径.md.bak
+```
+
+### 恢复流程
+1. 输入 `/恢复 {学生姓名}`
+2. 从列出的备份版本中选择
+3. 确认恢复
+
+---
+
+## 六、待修复列表
+
+### 位置
+```
+.claude/.tasks/fix-list-YYYYMMDD.md
+```
+
+### 查看与修复
+```
+指令：/修复
+→ 展示待修复列表
+→ 逐个处理或批量自动修复
+```
+
+---
+
+## 七、完整工作流程示例
+
+### 高效课后流程
+
+```
+1. 打开系统
+   └─ /周六（或 /今天）→ 自动加载发现世界-周六09点
+
+2. 加载学生模板
+   └─ /模板 周四19点 → 显示学生名单
+
+3. 速记输入（自动补全）
+   └─ 乔乔：gj5→zd3→zt ↑ ++
+      系统提示：gj5→zd3→zt ↑++
+
+4. 生成课评
+   └─ 并行生成 → 实时保存一份一份
+
+5. 自动校验
+   └─ ✅ 全部通过 ⚠️ 或 警告提示
+
+6. 保存完成
+   └─ 三级备份同时保存 ✅
+
+7. 查看待修复
+   └─ /修复 处理未完成项目
+```
+
+---
+
+## 八、常见问题
+
+### Q: 备份会占用空间吗？
+A: 自动保留最近7天备份，每月1号备份长期保留，自动清理超过时间的备份。
+
+### Q: 速记符号记不住怎么办？
+A: 不用记住，输入时系统会自动提示含义，按Tab键可自动补全。
+
+### Q: 校验警告可以跳过吗？
+A: 可以，警告不阻塞保存，但会记录在待修复列表，后续可集中处理。
+
+### Q: 目录不存在怎么办？
+A: 系统会自动逐级创建完整目录结构，无需手动操作。
+
+---
+
+## 九、情绪符号对照表
+
+| 符号 | 含义 | 对应表述 |
+|------|------|---------|
+| `↑` | 开心/积极/投入 | 开心、投入、积极、热情、参与度高 |
+| `→` | 稳定/平和/正常 | 稳定、平和、正常、专注、认真 |
+| `↓` | 低落/烦躁 | 低落、烦躁、不开心、需要关注 |
+| `~` | 波动/反复 | 情绪波动、反复不定 |
+| `++` | 进步/提升 | 比上周好、进步明显、状态提升 |
+| `↑↑` | 非常开心/兴奋 | 特别开心、非常投入、状态极佳 |
+| `↓↓` | 特别低落/需要关注 | 非常低落、需要关注、情绪不好 |
+| `gd` | 孤独/独自玩 | 喜欢独自玩、独自活动 |
+| `jl` | 焦虑/紧张/不安 | 紧张、焦虑、不安 |
+
+---
+
+## 十、示例速记组合
+
+```
+乔乔：gj5→zd3→zt ↑++ → 观望5分钟→主动搭3层→自己调整，开心，比上周进步
+昊昊：慢热→zd3→反复调 → → 慢热，主动搭3层，反复调整，稳定
+小明：专注15→完成→分享→合作 ↔ 专注15分钟→完成→分享→合作
+```
+
+---
+
+*速查卡版本：v1.0.0*
+*最后更新：2026-05-16*