更新课评系统代码

2026-06-02 23:01:58 +08:00
parent f8c4b6174f
commit cd05b8a5a7
45 changed files with 8260 additions and 345 deletions
--- a/.claude/skills/keping-optimizer/SKILL.md
+++ b/.claude/skills/keping-optimizer/SKILL.md
@@ -0,0 +1,456 @@
+---
+name: keping-optimizer
+description: 课评工作流程优化Skill。提供三级备份机制、自动补全缺失信息、路径自动创建、速记符号自动补全、智能班级预加载、实时校验提醒等功能，让课评更高效更安全。
+version: 1.0.0
+author: 穹狼教学团队
+---
+
+# 课评工作流程优化 Skill
+
+## 功能概述
+
+本Skill提供一系列工作流程优化功能，提升课评生成效率、数据安全性和规范一致性。
+
+### 核心能力
+- **三级备份机制**：防止数据丢失，提供完整恢复选项
+- **自动补全缺失信息**：日期、课程编号、课次自动填入
+- **路径自动创建**：自动创建不存在的目录结构
+- **速记符号自动补全**：输入时实时提示和补全
+- **实时校验提醒**：保存前检查规范，提前发现问题
+- **智能班级预加载**：根据时间自动预加载当天班级
+
+---
+
+## 一、三级备份机制
+
+### 功能说明
+确保课评数据安全，防止因系统问题或人为失误导致数据丢失。
+
+### 备份策略
+```
+┌───────────────────────────────────────────────────────┐
+│  第1级：直接保存到目标路径（主保存）                   │
+│  └── 路径：.claude/memory/class/...                  │
+│                                                         │
+│  第2级：同时保存到 .backup/ 目录（时间戳备份）         │
+│  └── 路径：.claude/.backup/YYYYMMDD_HHMMSS_{学生}.md│
+│                                                         │
+│  第3级：写入前备份现有文件（防止覆盖）                  │
+│  └── 路径：原文件路径 + .md.bak                       │
+└───────────────────────────────────────────────────────┘
+```
+
+### 执行流程
+```
+1. 检查目标路径是否存在 → 不存在则自动创建
+2. 检查是否存在旧文件 → 存在则先备份为 .md.bak
+3. 写入新文件到主路径
+4. 同时写入备份到 .claude/.backup/ 目录
+5. 确认两次写入都成功
+6. 删除超过7天的旧备份（自动清理）
+```
+
+### 恢复功能
+```
+指令：/恢复 乔乔
+→ 列出该学生的所有备份版本
+→ 选择版本恢复
+
+指令：/恢复备份
+→ 恢复最近一次备份
+```
+
+### 自动清理策略
+- 保留最近7天的所有备份
+- 保留每月1号的备份（长期存档）
+- 自动删除超过时间的备份
+
+---
+
+## 二、自动补全缺失信息
+
+### 功能说明
+教师只需输入核心表现，系统自动补全日期、课程编号、课次等元信息。
+
+### 自动补全规则
+
+| 信息项 | 补全规则 | 默认值 |
+|--------|---------|--------|
+| **日期** | 取当天日期，格式YYYYMMDD | 20260516 |
+| **课程编号** | 根据班级名称自动匹配 | 如AICODE03-01 |
+| **课次** | 根据学期周数自动计算 | 第11周 = 课次11 |
+| **课程主题** | 根据课程代码+周数自动匹配 | 如"蜥蜴" |
+
+### 输入示例
+
+**极简输入**：
+```
+/课评 班级：发现世界-周四19点
+乔乔：gj5→zd3→zt ↑++
+```
+
+**自动补全后**：
+```
+日期：20260516
+班级：发现世界-周四19点
+课程编号：DISC-011
+课次：第11课
+课程主题：鳄鱼
+```
+
+### 手动覆盖规则
+如果教师显式输入了某项信息，优先使用教师输入：
+```
+日期：4月2日  ← 教师指定，优先使用
+班级：发现世界-周四19点
+乔乔：gj5→zd3→zt ↑++
+```
+
+---
+
+## 三、路径自动创建
+
+### 功能说明
+自动创建不存在的目录结构，避免因目录缺失导致保存失败。
+
+### 自动创建的目录结构
+```
+.claude/memory/class/
+├── {班级名称}/
+│   ├── summaries/ ← 自动创建
+│   ├── {学生姓名}/
+│   │   └── feedback/ ← 自动创建
+│   └── 补课/
+│       └── {学生姓名}/
+│           └── feedback/ ← 自动创建
+└── .backup/ ← 自动创建
+```
+
+### 执行逻辑
+```python
+目标路径：.claude/memory/class/AICODE03小Q周五1900/乔乔/feedback/
+检查：.claude/memory/class/ → 存在
+检查：.claude/memory/class/AICODE03小Q周五1900/ → 存在？
+→ 不存在，自动创建
+检查：.claude/memory/class/AICODE03小Q周五1900/乔乔/ → 存在？
+→ 不存在，自动创建
+检查：.claude/memory/class/AICODE03小Q周五1900/乔乔/feedback/ → 存在？
+→ 不存在，自动创建
+→ 目录完整，可以保存！
+```
+
+### 目录缺失提示
+创建目录时提供提示：
+```
+⚠️ 目录不存在，已自动创建：.claude/memory/class/.../feedback/
+```
+
+---
+
+## 四、速记符号自动补全
+
+### 功能说明
+输入速记符号时实时提示含义，并提供Tab补全功能。
+
+### 速记符号速查表
+
+| 符号 | 含义 | 完整描述 |
+|------|------|---------|
+| `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` | 分享 | 分享想法/作品 |
+
+### 自动补全交互示例
+
+**示例1：自动补全数字**
+```
+教师输入：乔乔：gj
+系统提示：
+  ├─ gj3  → 观望3分钟
+  ├─ gj5  → 观望5分钟
+  └─ gj10 → 观望10分钟
+教师按Tab键：→ gj5
+```
+
+**示例2：符号理解提示**
+```
+教师输入：乔乔：zd3
+系统提示：✅ 识别为「主动搭3层」
+```
+
+**示例3：模糊匹配**
+```
+教师输入：乔乔：g5
+系统提示：是否是 gj5（观望5分钟）？ [是/否]
+```
+
+---
+
+## 五、实时校验提醒
+
+### 功能说明
+保存前自动检查课评是否符合规范，提前发现并提醒问题。
+
+### 校验清单
+
+| 检查项 | 规范要求 | 检查方式 |
+|--------|---------|---------|
+| **课程编号** | CSP/AICODE前缀，不是C++/AI | 正则匹配 |
+| **日期格式** | YYYYMMDD格式 | 格式验证 |
+| **目录结构** | 完整路径存在 | 路径检查 |
+| **文件命名** | 符合规范要求 | 正则匹配 |
+| **课评正文** | 不提及"补课"等词 | 关键词扫描 |
+| **字数范围** | 180-350字 | 字数统计 |
+
+### 校验结果展示
+
+**通过（全部绿色）**：
+```
+✅ 课程编号：AICODE03-11（符合规范）
+✅ 日期格式：20260516（正确）
+✅ 目录结构：完整存在
+✅ 文件命名：规范
+✅ 课评正文：无违规词汇
+✅ 字数：210字（符合要求）
+```
+
+**存在问题（黄色警告）**：
+```
+⚠️ 课程编号：AI03-11（不是标准格式）
+→ 建议改为：AICODE03-11
+
+⚠️ 课评正文：检测到「补课」词汇
+→ 建议删除或替换
+```
+
+### 校验时机
+- **生成后立即校验**：课评生成完成即检查
+- **保存前最终校验**：写入文件前最后检查
+- **教师可跳过**：警告不阻塞保存，但记录在待修复列表
+
+---
+
+## 六、智能班级预加载
+
+### 功能说明
+每次打开系统时，根据当前时间自动预加载当天的班级。
+
+### 预加载规则
+
+| 当前时间 | 自动预加载班级 |
+|---------|----------------|
+| 周一上午10点 | 小小班-周一上午10点 |
+| 周一下午16点 | 小小班-周一下午16点 |
+| 周四晚上19点 | 发现世界-周四19点 |
+| 周六上午10点 | SPIKE-周六上午10点 |
+| 周六下午14点 | AICODE03-周六下午14点 |
+
+### 快捷指令
+
+| 指令 | 功能 |
+|------|------|
+| **`/周几`** | **按上课日快速索引（推荐）**，如 `/周六`、`/周日`、`/周四` |
+| `/今天` | 自动判断当天星期几，选择对应班级 |
+| `/本周` | 选择本周的班级列表 |
+| `/班级` | 手动选择班级 |
+| `/模板 {班级}` | 加载班级学生名单模板 |
+
+### 模板加载示例
+
+**指令**：`/模板 周四19点`
+
+**自动生成**：
+```
+班级：发现世界-周四19点
+日期：20260516
+
+乔乔：______
+昊昊：______
+小明：______
+小红：______
+```
+
+---
+
+## 七、批量处理优化
+
+### 7.1 并行生成 + 逐份实时保存
+
+**问题**：全部生成后统一保存，一旦中断全部丢失
+
+**优化**：生成一份立即保存一份
+
+```
+教师输入5个学生 → 系统并行生成
+→ 乔乔课评生成完成 → 立即保存 ✅
+→ 昊昊课评生成完成 → 立即保存 ✅
+→ 其他继续...
+```
+
+**中断恢复**：
+```
+上次中断：乔乔、昊昊已保存，小明、小红未完成
+重新运行：检测到已保存的学生，直接跳过，继续处理未完成的
+```
+
+### 7.2 批量修改工具
+
+**功能**：一次性修改多个课评的共同内容
+
+**指令格式**：
+```
+/批量修改 {查找内容}→{替换内容}
+```
+
+**示例**：
+```
+/批量修改 搭建→拼搭
+→ 自动查找并替换本周所有课评中的"搭建"为"拼搭"
+
+/批量添加 继续加油！
+→ 自动在所有课评结尾添加"继续加油！"
+```
+
+---
+
+## 八、快捷指令大全
+
+| 指令分类 | 指令 | 功能描述 |
+|---------|------|---------|
+| **班级选择** | **`/周几`** | **按上课日快速索引（推荐）**，如 `/周六`、`/周日` |
+| | `/今天` | 自动判断当天星期几，选择对应班级 |
+| | `/本周` | 选择本周班级列表 |
+| | `/班级 {班级名}` | 手动选择指定班级 |
+| **模板加载** | `/模板 {班级}` | 加载班级学生名单模板 |
+| | `/空模板` | 创建空模板 |
+| **批量操作** | `/批量修改 {查找}→{替换}` | 批量替换课评内容 |
+| | `/批量添加 {内容}` | 批量在课评结尾添加内容 |
+| **数据恢复** | `/恢复 {学生}` | 恢复该学生的备份 |
+| | `/恢复备份` | 恢复最近一次备份 |
+| | `/清理备份` | 清理过期备份文件 |
+| **校验检查** | `/检查` | 检查本周课评是否符合规范 |
+| | `/检查 {班级}` | 检查指定班级课评 |
+| **保存与补存** | `/补存` | 尝试重新保存失败的课评 |
+| | `/学生 {姓名}` | 查看学生档案和历史课评 |
+
+---
+
+## 九、待修复列表功能
+
+### 功能说明
+保存校验发现问题但教师选择跳过保存时，自动记录在待修复列表，后续可集中处理。
+
+### 待修复列表存储
+```
+路径：.claude/.tasks/fix-list-YYYYMMDD.md
+```
+
+### 待修复项目格式
+```markdown
+# 待修复列表 - 2026-05-16
+
+## 发现世界-周四19点
+
+- [ ] 乔乔：课程编号不规范（AI03-11 → 建议改为 AICODE03-11）
+- [ ] 昊昊：课评正文包含"补课"词汇（需要删除或替换）
+- [ ] 小明：字数仅140字（需要补充内容）
+
+## AICODE03-周六14点
+
+- [ ] 小红：文件命名不符合规范
+```
+
+### 修复流程
+```
+指令：/修复
+→ 展示待修复列表
+→ 逐个处理或批量自动修复
+→ 修复完成从列表移除
+```
+
+---
+
+## 十、组合使用示例
+
+### 完整优化流程示例
+
+**Step 1：智能预加载班级**
+```
+教师：/周六（或 /今天）
+→ 自动加载：发现世界-周六09点
+```
+
+**Step 2：加载班级模板**
+```
+教师：/模板 周四19点
+→ 自动生成学生名单模板
+```
+
+**Step 3：速记符号输入（自动补全）**
+```
+乔乔：gj5→zd3→zt ↑++
+昊昊：慢热→zd3→反复调 →
+```
+
+**Step 4：生成并立即保存（三级备份）**
+```
+→ 生成乔乔课评 → 立即保存（三级备份）✅
+→ 生成昊昊课评 → 立即保存（三级备份）✅
+```
+
+**Step 5：实时校验提醒**
+```
+✅ 乔乔：全部通过
+⚠️ 昊昊：课程编号不规范，建议改为DISC-011
+→ 教师确认修改 → 自动修复后保存
+```
+
+**Step 6：完成！**
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ 全部完成！
+已保存学生：2人
+已备份文件：4份（主文件+备份）
+待修复项目：0项
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+## 依赖文件
+
+```
+# 规则文件
+.claude/rules/00-core.md
+.claude/rules/20-workflow.md
+.claude/rules/21-shorthand.md
+
+# 学生数据
+.claude/memory/class/{班级}/{学生}/profile.md
+.claude/memory/class/{班级}/{学生}/feedback/
+
+# 备份目录（自动创建）
+.claude/.backup/
+.claude/.tasks/
+```
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 更新内容 |
+|-----|------|---------|
+| **v1.0.0** | **2026-05-16** | 初始版本：三级备份、自动补全、路径自动创建、速记补全、实时校验、智能预加载、批量处理、待修复列表 |
+
+---
+
+*维护者：穹狼教学团队*
+*最后更新：2026-05-16*