12 KiB
12 KiB
name, description, version, author
| name | description | version | author |
|---|---|---|---|
| keping-optimizer | 课评工作流程优化Skill。提供三级备份机制、自动补全缺失信息、路径自动创建、速记符号自动补全、智能班级预加载、实时校验提醒等功能，让课评更高效更安全。 | 1.0.0 | 穹狼教学团队 |
课评工作流程优化 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/ ← 自动创建
执行逻辑
目标路径：.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
待修复项目格式
# 待修复列表 - 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