ClassFeedback/.claude/rules/40-keping-快速入门.md

课评生成快速入门指南 v3.0（优化版）

穹狼乐高编程AI课评系统 - 3分钟上手版

本次优化：新增速记符号、会话上下文、批量一键确认

---

🚀 30秒极速上手

第1步：指定班级（一次即可）

/课评 班级：发现世界-周四19点

第2步：输入学生表现

乔乔：观望5分钟→主动搭3层→自己调整，开心，比上周进步
昊昊：慢热，搭3层，反复调整，稳定

第3步：一键确认发送

AI生成 → 查看 → [全部发送]

完成！3份课评已自动保存到班级汇总和个人档案。

---

⚡ 速记符号速查

核心速记（必会）

速记	含义	示例
gj#	观望#分钟	gj5 = 观望5分钟
zd#	主动搭#层	zd3 = 主动搭3层
zt	自己调整	遇到问题时自己调整
↑	开心	↑++ = 开心，比上周进步
→	稳定	→ = 情绪稳定

完整速记符号表参见 36-shorthand-learning.md

速记组合示例

乔乔：gj5→zd3→zt ↑++

展开：乔乔观望5分钟后主动搭3层，自己调整，开心，比上周进步

---

🏷️ 学生类型标记

输入时添加标记，AI自动处理

标记	含义	处理方式
[体验]	体验课学生	仅保存到班级汇总
[补课]	补课学生	询问是否建档
[缺课]	今天缺席	记录缺席，不生成课评
[new]	新学生首次	创建档案，双轨保存

示例：

乔乔：gj5→zd3→zt ↑++
张小明[体验]：搭了3层，开心
李小红[补课]：专注完成，稳定

⚠️ 重要：课评正文不显示标记

无论输入时是否添加[补课]或[体验]标记，生成的课评正文中都不会提及这些信息。

• [补课]、[体验]等标记仅用于后台档案管理
• 课评正文统一按正常学生撰写，不区分学生类型
• 家长看到的课评中不会出现"补课"、"体验"等字样

示例：

教师输入：李小红[补课]：搭了3层，专注完成

课评输出：
小红本节课学习了"旋转飞机"，认识了游乐园旋转设施的中心轴结构...
（正常撰写，完全不提"补课"相关信息）

---

📝 三种常用方式

方式1：极简一句话（最自由）

乔乔今天开始不敢碰，后来主动搭了三层，球卡住自己调高度，挺稳定的，比上周主动多了

特点：

• 任意格式，AI自动解析
• 支持口语化、语音转文字
• 适合边走边记
• 字数：输入简洁 → 输出约200字

方式2：详细描述（最丰富）

乔乔今天开始观望了5分钟，后来主动搭了3层管道，球卡住的时候自己调整高度，还主动帮助旁边的小朋友一起搭，最后完成作品特别开心，说这是她最喜欢的作品。比上周主动多了，上周观望了10分钟才开始。

特点：

• 描述越详细，课评越丰富
• AI会提取所有精彩瞬间
• 家长能看到更多孩子成长细节
• 字数：输入丰富 → 输出约280字

方式3：速记符号（最高效）

乔乔：gj5→zd3→zt ↑++
昊昊：慢热→zd3→反复调 →
小强：频换玩法 wb↓--

特点：

• 输入速度最快
• 适合熟练用户
• 批量处理首选
• 字数：根据输入内容自动调整

方式4：批量表格（最清晰）

课程：DISC-007
班级：发现世界-周四19点

1. 乔乔：gj5→zd3→zt ↑++
2. 昊昊：慢热→zd3→反复调 →
3. 张小明[体验]：搭了3层，开心
4. 李小红[补课]：专注完成，稳定

特点：

• 全班一览清晰
• 支持标记分类
• 适合课后整理
• 字数：根据每位学生输入内容自动调整

---

💡 字数弹性说明（新增）

核心理念：输入越丰富，课评越详细

输入类型	示例	输出字数
精简输入	"搭了3层，开心"	180-220字
标准输入	"观望5分钟→主动搭3层→自己调整→还帮助同伴"	220-280字
详细输入	包含多个亮点、精彩瞬间、纵向对比	280-350字

建议：

• 常规课堂 → 简洁记录即可
• 有亮点/突破/精彩瞬间 → 详细描述，AI会充分展开
• 不用担心字数多 → 家长更喜欢看到孩子的具体成长

---

🔄 优化后流程：生成 → 确认 → 保存

教师输入 → AI自动生成 → 【自动保存班级汇总】 → 展示给教师
                                           ↓
教师查看 → [一键发送] → 【自动保存个人档案】 → 完成

效率提升：8人课评从15-20分钟缩短至3-5分钟

---

📊 批量生成界面预览

━━━━━━━━━━━━━━━━━━━━━━━
📊 批量生成完成（4份）｜发现世界-周四19点｜DISC-007
━━━━━━━━━━━━━━━━━━━━━━━

✅ 乔乔      198字  正常
✅ 昊昊      205字  正常
✅ 张小明[体验] 192字  体验学生
✅ 李小红[补课] 201字  补课学生

【批量操作】
[全部发送] [逐个查看] [标记修改] [取消]
━━━━━━━━━━━━━━━━━━━━━━━

---

📁 文件存储位置

双轨自动保存

存储位置	文件路径	用途
班级周汇总	memory/class-evaluation-summary/第X周/{班级}.md	集中查看当周全班表现
个人历史课评	memory/student/{班级}/{学生名}/历史课评记录.md	追踪个人完整成长轨迹

学生类型处理规则详见 33-first-class-rules.md

---

💡 进阶技巧

技巧1：会话上下文

首次指定班级后，后续无需重复

/课评 班级：发现世界-周四19点  # 只需一次

# 后续直接输入
乔乔：搭3层，开心
昊昊：慢热，稳定

技巧2：语音快速录入

语音："呃...乔乔啊...观望了5分钟...主动搭3层..."

AI自动解析为：乔乔：gj5→zd3→zt

技巧3：混合输入

# 同一批输入中混合使用自然语言和速记

乔乔今天表现很好，搭了3层还自己调整，开心
昊昊：慢热→zd3→反复调 →
张小明[体验]：积极参与

---

❓ 常见问题速答

Q：速记符号记不住怎么办？
A：不用记！直接用自然语言描述，AI一样能理解。

Q：忘记打标记会怎样？
A：AI会自动检测档案。有档案=正式学生，无档案=提示选择[补课]/[体验]。

Q：批量生成后发现有错误怎么办？
A：点击[标记修改]，指出修改意见，AI会重新生成该学生课评。

Q：课评生成后可以修改吗？
A：可以！发送前都可以修改。发送后如需修改，可手动编辑文件。

Q：体验课学生后续转正式了怎么办？
A：输入转为正式，AI会为该学生建立档案，后续课评正常双轨保存。

---

🎯 推荐工作流程

课后5分钟快速流程

Step 1（1分钟）: 指定班级
/课评 班级：发现世界-周四19点

Step 2（2分钟）: 速记输入
乔乔：gj5→zd3→zt ↑++
昊昊：慢热→zd3→反复调 →
小明[体验]：zd3 ↑
小红[补课]：专注完成 →

Step 3（2分钟）: 查看并一键发送
AI生成 → 查看质量报告 → [全部发送]

完成！8份课评已自动保存。

---

📞 支持

• 完整规则：参见 .claude/rules/ 目录
• 速记符号表：参见 30-input-format.md
• 批量生成规则：参见 32-batch-generation.md

---

记住：说人话就行，AI帮你处理格式！