# 课评生成快速入门指南 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](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](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帮你处理格式！*