456 lines
12 KiB
Markdown
456 lines
12 KiB
Markdown
---
|
||
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* |