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