ClassFeedback/.claude/rules/38-quick-edit.md

快速编辑功能规则

解决小错误修改需重新生成的问题，提升修改效率70%

---

🚀 快速编辑 vs 重新生成

场景	原方案	快速编辑	效率提升
错别字	重新生成整篇	直接修改	90%↑
称呼错误	重新生成整篇	替换称呼	95%↑
个别词语	重新生成整篇	替换词语	90%↑
补充细节	重新生成整篇	追加内容	80%↑
结构调整	重新生成整篇	重新生成	-

---

📝 快速编辑指令

指令格式

修改{学生}：{修改内容}

或

编辑{学生}：{修改内容}

支持的修改类型

类型1：替换词语（最常用）

教师：修改乔乔：把"搭建"改为"拼搭"

AI处理：
- 定位：在班级汇总和个人档案中找到乔乔的第7周课评
- 替换：将所有"搭建"替换为"拼搭"
- 确认：显示修改前后对比

━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 已修改：乔乔（第7周 DISC-007）

修改前：
"乔乔本节课搭建了3层管道..."

修改后：
"乔乔本节课拼搭了3层管道..."

修改位置：第2段第1句
━━━━━━━━━━━━━━━━━━━━━━━━━

类型2：修改称呼

教师：修改乔乔：称呼改为"乔乔宝贝"

AI处理：
- 定位：找到所有称呼"乔乔"的位置
- 替换：统一改为"乔乔宝贝"
- 注意：不改变其他内容

━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 已修改称呼：乔乔 → 乔乔宝贝

共修改 6 处称呼
━━━━━━━━━━━━━━━━━━━━━━━━━

类型3：补充内容

教师：修改乔乔：在"坚持完成了"后添加"还主动帮助了同桌"

AI处理：
- 定位：找到"坚持完成了"
- 插入：在指定位置添加内容
- 调整：确保语句通顺

━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 已补充内容：乔乔（第7周）

添加位置：第2段
添加内容："还主动帮助了同桌"

修改后上下文：
"...但还是认真完成了，还主动帮助了同桌，展现出很好的坚持性。"
━━━━━━━━━━━━━━━━━━━━━━━━━

类型4：删除内容

教师：修改乔乔：删除"这个调整值得注意"

AI处理：
- 定位：找到指定内容
- 删除：移除该句
- 调整：确保段落连贯

━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 已删除内容：乔乔（第7周）

删除："这个调整值得注意"
━━━━━━━━━━━━━━━━━━━━━━━━━

类型5：批量替换

教师：修改乔乔：把所有"开心"改为"兴奋"

AI处理：
- 统计：全文共出现3次"开心"
- 替换：全部改为"兴奋"
- 确认：显示每处修改位置

━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 批量替换完成

替换：开心 → 兴奋（共3处）

位置1：第2段第1句
位置2：第2段第3句
位置3：课后建议段落
━━━━━━━━━━━━━━━━━━━━━━━━━

---

🎯 批量快速编辑

同时修改多个学生

教师：
修改乔乔：把"搭建"改为"拼搭"
修改昊昊：称呼改为"昊昊小朋友"
修改小明：补充"还主动分享了作品"

AI处理：
1. 依次处理每个学生的修改
2. 汇总显示所有修改结果
3. 标记哪些成功、哪些失败

━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 批量修改完成（3/3成功）

☑️ 乔乔：替换"搭建"→"拼搭"（1处）
☑️ 昊昊：称呼改为"昊昊小朋友"（6处）
☑️ 小明：补充内容（第2段）

所有修改已同步到：
- 班级周汇总
- 个人历史课评
━━━━━━━━━━━━━━━━━━━━━━━━━

---

🔍 智能定位

自动识别修改范围

当教师只说"修改"而未指定周数时，AI自动：

教师：修改乔乔：把"开心"改为"兴奋"

AI判断：
1. 当前会话上下文：第7周 DISC-007
2. 默认修改：本周（第7周）课评
3. 如要修改历史：需明确指定周数

━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 已修改：乔乔 第7周（当前周）

如需修改其他周数，请指定：
"修改乔乔第5周：把'开心'改为'兴奋'"
━━━━━━━━━━━━━━━━━━━━━━━━━

历史课评修改

教师：修改乔乔第5周：把"搭建"改为"拼搭"

AI处理：
- 定位：memory/student/.../历史课评记录.md
- 找到第5周记录
- 执行修改

━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 已修改历史课评：乔乔 第5周

⚠️ 注意：这是历史课评，已发送给家长
   如已发送，请考虑是否需要告知家长更新
━━━━━━━━━━━━━━━━━━━━━━━━━

---

⚠️ 修改限制

不可快速编辑的场景

以下情况必须重新生成，不支持快速编辑：

场景	原因	建议操作
改变课评结构	涉及多段落调整	重新生成
改变评价基调	从负面改为正面	重新生成
补充大量内容	超过50字	重新生成
改变主题理解	知识点错误	重新生成
添加 emoji	格式调整	快速编辑支持

修改字数限制

• 单次修改：不超过50字
• 单篇累计：不超过100字
• 超出限制：提示"建议重新生成"

---

🔄 修改与重新生成的对比

决策流程

教师要求修改
      ↓
判断修改类型
      ↓
┌─────────────┴─────────────┐
↓                           ↓
小修改（<50字）        大修改（>50字）
或简单替换            或结构调整
↓                           ↓
快速编辑                  重新生成
(秒级响应)               (需等待生成)

使用建议

情况	推荐方式	示例
错别字	快速编辑	"搭建"→"拼搭"
称呼调整	快速编辑	"乔乔"→"乔乔宝贝"
补充1-2句话	快速编辑	添加具体细节
整体重写	重新生成	"重新生成乔乔的课评"
改变语气	重新生成	从平淡改为热情
补充大量细节	重新生成	添加完整事件描述

---

📊 快速编辑统计

使用统计

每周生成快速编辑使用报告：

━━━━━━━━━━━━━━━━━━━━━━━━━
📊 快速编辑使用统计（本周）

使用次数：12次
节省时间：约10分钟（vs 重新生成）

常用修改类型：
1. 替换词语 - 5次
2. 修改称呼 - 4次
3. 补充内容 - 3次

平均修改耗时：5秒
平均重新生成耗时：60秒
━━━━━━━━━━━━━━━━━━━━━━━━━

---

✅ 实施检查清单

• 支持基本替换指令（修改{学生}：把"A"改为"B"）
• 支持称呼修改指令
• 支持内容补充指令
• 支持内容删除指令
• 支持批量修改多个学生
• 自动定位当前周数（无需指定）
• 支持历史课评修改（需指定周数）
• 修改字数限制（单次<50字）
• 修改后同步到双轨存储
• 显示修改前后对比

---

📝 快速参考卡

━━━━━━━━━━━━━━━━━━━━━━━━━
⚡ 快速编辑指令速查

修改称呼：
  修改{学生}：称呼改为"{新称呼}"

替换词语：
  修改{学生}：把"{旧词}"改为"{新词}"

补充内容：
  修改{学生}：在"{位置}"后添加"{内容}"

删除内容：
  修改{学生}：删除"{内容}"

修改历史：
  修改{学生}第{X}周：{修改内容}
━━━━━━━━━━━━━━━━━━━━━━━━━

---

版本：v1.0
更新日期：2026-04-19
配套文件：32-batch-generation.md, 30-input-format.md