xiaoq/ClassFeedback
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

优化课评系统：新增速记符号、状态面板、快速编辑功能

Browse Source 
- 新增36-shorthand-learning.md：速记符号阶梯学习指南
- 新增37-status-panel.md：课评状态管理面板
- 新增38-quick-edit.md：快速编辑功能规则
- 新增班级学期总览模板和成长时间线模板
- 更新多条规则文件优化课评生成流程
- 补充第7周班级汇总和学生档案数据
This commit is contained in:
小Q
2026-04-19 19:24:09 +08:00
parent c04f1d18a6
commit 4810387dab
73 changed files with 4070 additions and 898 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
.claude/rules/15-semester-weeks.md
View File

@@ -64,7 +64,7 @@
| 第4周 | DISC-004 | 概率转盘 | 圆形结构、中心轴、随机概念 | 数理启蒙、创意设计 |
| **第5周** | **DISC-005** | **天平秤** | **杠杆原理、平衡判断、重量比较** | **科学探究、逻辑思维** |
| 第6周 | DISC-006 | 长颈鹿 | 高度建构、稳定性、比例认知 | 空间想象、结构优化 |
| 第7周 | DISC-007 | 旋转飞机 | 旋转机构、离心力、对称结构 | 机械原理、创意表现 |
| 第7周 | DISC-007 | 旋转飞机 | **游乐园旋转设施、侧面连接、旋转运动** | 机械原理、创意表现 |
| 第8周 | DISC-008 | 蜥蜴 | 关节连接、可动结构、仿生设计 | 生物认知、精细操作 |
| 第9周 | DISC-009 | 机器人瓦力 | 履带结构、收纳功能、角色扮演 | 综合应用、故事创作 |
| 第10周 | DISC-010 | 梳妆台 | 功能分区、镜子安装、生活连接 | 生活认知、美学设计 |
@@ -139,7 +139,7 @@
**课程知识点模块**（自动填充）：
```
今天学习了"天平秤"，探索了杠杆原理——两边的重量相等时天平就会平衡，可以用它来比较物体谁轻谁重。
本节课学习了"天平秤"，探索了杠杆原理——两边的重量相等时天平就会平衡，可以用它来比较物体谁轻谁重。
```
**课后建议模块**（自动关联主题）：

6
.claude/rules/20-style-building.md
View File

@@ -120,11 +120,11 @@
**输出**（三段式）：
小明今天学习了"互锁结构"——把积木像砌墙一样交错叠放，这样搭出来的墙更稳固 🔍
小明本节课学习了"互锁结构"——把积木像砌墙一样交错叠放，这样搭出来的墙更稳固 🔍
这节课小明对房子主题很感兴趣，搭建环节专注投入约30分钟。互锁的方法听懂了，实际操作时前两块需要老师扶着手指对齐，第三块开始能自己完成。和上周比，今天结构倒了没有发脾气，而是拆开重新观察了一下底座平不平，这个调整值得注意 💪✨
本节课小明对房子主题很感兴趣，搭建环节专注投入约30分钟。互锁的方法听懂了，实际操作时前两块需要老师扶着手指对齐，第三块开始能自己完成。和上周比，本节课结构倒了没有发脾气，而是拆开重新观察了一下底座平不平，这个调整值得注意 💪✨
家里如果有积木，可以和孩子一起搭两堵墙，一堵直着叠、一堵交错叠，推推看哪个更稳，巩固今天的概念 🏠
家里如果有积木，可以和孩子一起搭两堵墙，一堵直着叠、一堵交错叠，推推看哪个更稳，巩固本节课的概念 🏠
---
**字数：198字 | 段落：3段 | Emoji：3个**

4
.claude/rules/21-style-coding.md
View File

@@ -102,13 +102,13 @@
**输出**：
李想今天学习了"重复执行"（循环）和"如果碰到颜色就..."（条件判断），用这两个概念做了一个小猫走迷宫的游戏 💡
李想本节课学习了"重复执行"（循环）和"如果碰到颜色就..."（条件判断），用这两个概念做了一个小猫走迷宫的游戏 💡
循环的作用理解了，但第一次把循环次数设成3次，小猫走得不够远；改成10次后正常。条件判断一开始方向写反了，检查代码后发现并修正 ✓
导入环节对迷宫游戏很感兴趣，实践环节专注完成代码搭建，最后分享环节能说出循环的作用，本节课的编程目标顺利达成 🎯
和上周相比，今天会主动给代码分区域摆放（运动放一起、外观放一起），这个整理习惯有助于后续写更复杂的程序 📈
和上周相比，本节课会主动给代码分区域摆放（运动放一起、外观放一起），这个整理习惯有助于后续写更复杂的程序 📈
回家后可以试试给游戏加一个"开始"按钮，点击后小猫才动。需要用到"当角色被点击"事件，可以预习一下。下周我们继续 🏠

2
.claude/rules/22-style-robotics.md
View File

@@ -103,7 +103,7 @@
**输出**：
王浩今天训练了颜色传感器的巡线校准（重新标定白/黑值）和新的任务策略（先近后远、分段计时），主要解决之前巡线误判和策略执行拖沓的问题 ⚙️
王浩本节课训练了颜色传感器的巡线校准（重新标定白/黑值）和新的任务策略（先近后远、分段计时），主要解决之前巡线误判和策略执行拖沓的问题 ⚙️
校准后巡线成功率从上次60%提升到85%。但新策略执行不够果断，计划的"前30秒拿近处"实际用了45秒，挤压了后期高分任务的时间 📊

532
.claude/rules/30-input-format.md
View File

@@ -1,450 +1,248 @@
# 快捷输入格式规则 v3.0
# 快捷输入格式规则 v4.0（优化版）
> 支持更灵活的输入方式，适应课后快速记录场景
> 核心理念：**说人话就行**，AI自动理解语境、补充细节、规整格式
>
> 本次优化：新增速记符号系统、标记驱动处理、会话上下文记忆
---
## 🎯 输入原则（新版）
## 🎯 黄金法则
**极简输入，AI智能理解**
- 教师只需提供**关键词**和**关键事实**
- AI自动理解语境、补充细节、规整格式
- 支持**口语化、碎片化、无序化**输入
- 接受**语音转文字、手写速记、随手记录**
- **自动纠正谐音姓名**（如"良心桥"→"梁昕乔"）
1. **有姓名** → AI知道是谁
2. **有行为** → AI知道做了什么
3. **其他随意** → AI自动补充
**核心目标**：让教师以最自然的方式记录，AI负责后续整理
**支持**：口语化、碎片化、无序化、语音转文字
---
## 🔊 语音输入特别说明
## ⚡ 速记符号系统（新增）
### 谐音姓名自动纠正
### 行为速记
**问题**：语音输入时姓名可能被识别为谐音
- "梁昕乔" → "良心桥"、"亮新巧"
- "钟昀昊" → "中云浩"、"钟运好"
- "张宇" → "章鱼"、"张瑜"
| 速记 | 全称 | 使用场景 |
|------|------|----------|
| `gj` | 观望 | `gj5` = 观望5分钟 |
| `zd` | 主动 | `zd3` = 主动搭3层 |
| `zt` | 自己调整 | 球卡住时自己调整 |
| `wb` | 完成 | 独立完成搭建 |
| `mr` | 融入 | 融入小组活动 |
| `zx` | 专注 | 专注完成任务 |
| `sb` | 失败→调整 | 失败后调整再尝试 |
**解决**：AI自动匹配班级学生名单进行纠正
- 高相似度（>90%）：自动纠正，不打扰
- 中相似度（70-90%）：生成前提示确认
- 低相似度（<70%）：要求重新输入
### 情绪速记
| 速记 | 含义 | 示例 |
|------|------|------|
| `↑` / `kx` | 开心/积极 | 情绪↑ 或 kx |
| `→` / `wd` | 稳定/平和 | 情绪→ 或 wd |
| `↓` / `fd` | 烦躁/低落 | 情绪↓ 或 fd |
| `~` / `bd` | 波动 | 情绪~ 或 bd |
### 对比速记
| 速记 | 含义 | 示例 |
|------|------|------|
| `++` / `!` | 比上周进步 | 比上周++ |
| `=` / `0` | 和之前一样 | 和之前= |
| `--` / `?` | 需关注 | 需-- |
| `new` | 新学生/首次 | 标记首次上课 |
### 速记组合示例
**示例**：
```
教师语音输入："良心桥今天搭了三层"
AI处理：
1. 识别疑似姓名"良心桥"
2. 匹配班级名单：梁昕乔（相似度100%）
3. 自动纠正为"梁昕乔"
4. 查询画像小名："乔乔"
5. 课评输出："乔乔今天搭了三层..."
输入： 乔乔：gj5→zd3→zt ↑++
展开： 乔乔观望5分钟后主动搭3层，自己调整，开心，比上周进步
输入： 昊昊：慢热→zd3→反复调 →
展开： 昊昊慢热，主动搭3层，反复调整，情绪稳定
输入： 小强：频换玩法 wb↓--
展开： 小强频繁换玩法，未完成，情绪烦躁，需关注
```
---
## ✨ 支持的输入方式
## 🏷️ 标记驱动处理（新增）
### 方式1：极简一句话（最自由）
**使用标记快速指定学生类型，无需中断流程**
**特点**：任意格式，AI自动解析
| 标记 | 含义 | 处理方式 | 保存位置 |
|------|------|----------|----------|
| 无标记 | 正式学生 | 双轨保存 | 班级汇总+个人档案 |
| `[补课]` | 补课学生 | 询问是否建档 | 先班级汇总 |
| `[体验]` | 体验课学生 | 仅班级汇总 | 班级汇总（标记体验） |
| `[缺课]` | 今天缺席 | 记录缺席 | 班级汇总（标记缺课） |
| `[new]` | 新学生首次 | 创建档案 | 双轨保存 |
### 标记使用示例
**示例1**：口语化
```
小明今天开始不敢碰，后来主动搭了三层，球卡住自己调高度，挺稳定的，比上周主动多了
批量输入示例：
周四19点 DISC-007
乔乔：gj5→zd3→zt ↑++
昊昊：慢热→zd3→反复调 →
张小明[体验]：搭了3层，开心
李小红[补课]：专注完成，稳定
```
**示例2**：碎片化
**AI自动处理**：
- 乔乔、昊昊：双轨保存
- 张小明[体验]：仅保存到班级汇总，不询问
- 李小红[补课]：生成后询问是否建档
---
## ✨ 自然语言输入（推荐）
### 方式1：极简一句话
```
梁昕乔 快速启动 搭3层 自己加装饰 情绪好 创意突出
乔乔今天开始不敢碰，后来主动搭了三层，球卡住自己调高度，挺稳定的，比上周主动多了
昊昊还是老样子，慢热型，观察了5分钟才开始，不过后来搭得挺稳的，反复调整了几遍
```
**示例3**：无序关键词
### 方式2：关键词速记
```
观望5分钟，主动尝试，自己调整，情绪稳定，比上周好，小明
乔乔：gj5→zd3→zt ↑++
昊昊：慢热→zd3→反复调 →
小强：频换玩法 wb↓--
```
**示例4**：语音转文字风格
### 方式3：会话上下文（新增）
**首次指定班级后，后续无需重复**
```
呃...钟昀昊啊，今天上课啊，就是慢热，观察了一会儿才开始，然后搭了三层，反复调整，情绪挺稳定的
/课评 班级：发现世界-周四19点 # 只需一次
# 后续直接输入学生表现
乔乔：搭3层，开心
昊昊：慢热，稳定
```
---
### 方式2：自然对话式（推荐）
## 🔊 语音输入优化
**特点**：像和同事聊天一样描述
### 谐音自动纠正
AI自动匹配班级学生名单，实时纠正：
- "良心桥" → "梁昕乔"
- "中云浩" → "钟昀昊"
- "李一同" → "李怡瞳"
### 语音速记混合
**示例**：
```
今天梁昕乔表现挺好的，一上课就进入状态了，搭了3层还自己加了装饰，情绪很开心，和之前一样主动
语音输入："呃...乔乔啊...观望了5分钟...主动搭3层...自己调整...开心"
钟昀昊呢，还是老样子，慢热型，观察了5分钟才开始，不过后来搭得挺稳的，反复调整了几遍，最后完成了
```
**AI自动识别**：
- 学生姓名（梁昕乔、钟昀昊）
- 关键行为（快速启动、搭3层、加装饰）
- 情绪状态（开心、稳定）
- 对比信息（和之前一样）
---
### 方式3：列表速记（半结构化）
**特点**：无序列表，无需严格格式
**示例1**：简单列表
```
- 小明
- 开始不敢碰管道
- 后来主动搭3层
- 球卡住自己调整
- 情绪稳定
- 比上周进步
```
**示例2**：混合关键词
```
小明：观望→主动→3层→调整，稳定，比上周好
小红：全程专注，5层+弯管，开心，帮助旁边人
小强：换玩法多，没完成，兴奋转烦躁，需引导
AI解析：
学生：乔乔（匹配小名）
行为：gj5→zd3→zt
情绪：↑
```
---
### 方式4：表格简化版（批量）
## 📊 批量输入格式
**特点**：极简表格，不要求对齐
### 列表式（推荐）
**示例**：
```
小明 观望5分钟 搭3层 自己调 稳定 比上周好
小红 全程专注 5层加弯管 开心 帮助人
小强 换玩法 没完成 烦躁 需引导
豆豆 独自玩球 没搭 开心 社交需引导
课程：DISC-007
班级：发现世界-周四19点
1. 乔乔：gj5→zd3→zt ↑++
2. 昊昊：慢热→zd3→反复调 →
3. 张小明[体验]：搭3层，开心
4. 李小红[补课]：专注完成，稳定
```
**AI自动转换**为规整表格
### 简化表格式
---
### 方式5：分段描述（详细）
**特点**：按时间/环节分段，自由描述
**示例**：
```
【小明】
导入阶段：坐着看其他小朋友玩
探索阶段：第6分钟开始尝试
搭建阶段：能搭3层直管
调整阶段：球卡住自己调高度
情绪：整体稳定
亮点：比上周主动多了
乔乔 gj5→zd3→zt ↑ ++
昊昊 慢热→zd3→反复调 → 渐入佳境
小明[体验] 搭3层 ↑ 积极参与
```
---
### 方式6：极简符号速记（专业用户）
**特点**：用符号快速编码
**符号对照**：
```
→ 表示行为发展/时间线
+ 表示正面/进步
- 表示需关注/问题
↑ 表示情绪积极
↓ 表示情绪消极
? 表示疑问/不确定
! 表示亮点/惊喜
```
**示例**：
```
小明：观望5m → 主动3层 → 自调 ↑ + 比上周!
小红：专注全程 → 5层+弯管 ↑↑ + 助人!
小强：频换玩法 → 未完成 ↓ 需引导
```
---
## 🔍 AI智能解析规则
### 自动识别要素
| 要素 | AI识别方式 | 示例 |
|------|-----------|------|
| **学生姓名** | 首词/大写/冒号前 | "小明"、"梁昕乔" |
| **关键行为** | 动词+数量/结果 | "搭3层"、"自己调" |
| **情绪状态** | 情绪词/表情描述 | "开心"、"稳定"、"烦躁" |
| **对比信息** | 时间词+比较 | "比上周"、"和之前" |
| **课程信息** | 上下文/历史记录 | 自动推断 |
### 模糊匹配
**行为词模糊匹配**：
| 教师输入 | AI理解 | 标准输出 |
|---------|-------|---------|
| 不敢碰/不敢动/犹豫 | 观望型 | "开始有些犹豫" |
| 主动/积极/马上 | 主动型 | "主动尝试" |
| 自己弄/自己搞/自己调 | 自主解决 | "自己调整" |
| 搭了3层/做了三层/堆了3个 | 完成3层 | "搭了3层" |
**情绪词模糊匹配**：
| 教师输入 | AI理解 |
|---------|-------|
| 开心/高兴/笑/兴奋 | 积极情绪 |
| 稳定/平静/正常 | 平稳情绪 |
| 低落/不开心/烦躁 | 消极情绪 |
| 先好后差/开始可以后来不行 | 情绪波动 |
---
## 💡 输入优化建议
### 最少有效信息
只需提供：
1. **学生姓名**（必须）
2. **一个关键行为**（必须）
AI会自动：
- 匹配课程信息
- 推断情绪状态
- 对比历史表现
- 生成完整课评
**极简示例**：
```
小明：主动搭了3层
```
AI输出：
```
小明今天学习了互锁结构，能主动尝试并搭了3层...
[基于画像的完整课评]
```
### 推荐信息量
| 场景 | 建议输入 | 效果 |
|------|---------|------|
| **最省时间** | 姓名+1个行为 | 自动生成 |
| **常规记录** | 姓名+2-3个行为+情绪 | 个性化强 |
| **重点关注** | 姓名+详细表现+对比 | 深度定制 |
---
## 🚫 不推荐的输入方式
虽然系统会尽力理解，但以下方式可能影响质量：
| 不推荐 | 原因 | 建议替代 |
|-------|------|---------|
| 纯数字代码 | 无上下文 | 加姓名或关键词 |
| 过于省略 | 信息不足 | 至少一个行为 |
| 完全乱序 | 难以解析 | 大致按时间顺序 |
| 错别字过多 | 理解困难 | 常用拼音即可 |
---
## 🔄 输入示例大全
### 示例1：口语化输入（推荐）
### 示例1：极简速记
**教师输入**：
```
呃，小明啊，今天上课一开始不敢碰，就坐着看，后来我看他开始动了，搭了大概三层吧，然后那个球卡住了，他就自己调了一下高度，情绪还挺稳定的，比上周好一些，上周是完全不敢碰的
输入：乔乔：gj5→zd3→zt ↑++
AI解析：
学生：乔乔（小名）
行为：观望5分钟→主动搭3层→自己调整
情绪：开心
对比：比上周进步
```
**AI解析结果**：
- 学生：小明
- 行为：观望→主动搭3层→自己调整
- 情绪：稳定
- 对比：比上周进步（上周完全不敢碰）
### 示例2：语音风格
---
### 示例2：碎片化输入
**教师输入**：
```
梁昕乔 快速启动 3层 加装饰 开心 和之前一样
输入：呃，昊昊啊，今天上课啊，就是慢热，观察了一会儿才开始，然后搭了三层，反复调整，情绪挺稳定的
AI解析：
学生：昊昊
行为：观望→搭3层→反复调整
情绪：稳定
```
**AI解析结果**：
- 学生：梁昕乔
- 行为：快速启动→搭3层→加装饰
- 情绪：开心
- 对比：和之前一样
### 示例3：批量混合标记
---
### 示例3：无序关键词
**教师输入**：
```
稳定，自己调整，观望5分钟，主动尝试，比上周好，小明
```
输入：
周四19点 DISC-007
**AI解析结果**：
- 学生：小明
- 行为：观望5分钟→主动尝试→自己调整
- 情绪：稳定
- 对比：比上周好
---
### 示例4：批量简化
**教师输入**：
```
周四19点 DISC-003
小明 观望5分 搭3层 自调 稳定 比上周好
昕乔 快速 3层 加装饰 开心 一样
昀昊 慢热 3层 反复调 稳定 渐入佳境
```
**AI解析结果**：
自动识别为批量模式，生成3份课评
---
### 示例5：详细描述
**教师输入**：
```
【李怡瞳】四年级 AI03
今天学Prompt编写
开始比较慢，观察别人
后来能写简单指令
遇到困难主动问
情绪平和
初学阶段正常
```
**AI解析结果**：
- 学生：李怡瞳
- 年级：四年级
- 课程：AI03
- 行为：观察→写简单指令→主动求助
- 情绪：平和
- 状态：初学阶段
---
## 📝 输入模板速查
### 模板1：最简版
```
[姓名]：[一个行为]
```
### 模板2：常规版
```
[姓名]：[行为1]，[行为2]，[情绪]，[对比]
```
### 模板3：自然版
```
今天[姓名][表现描述]，[情绪]，[对比]
```
### 模板4：批量版
```
课程：[代码]
[姓名1] [表现1] [情绪1]
[姓名2] [表现2] [情绪2]
乔乔：gj5→zd3→zt ↑++
昊昊：慢热→zd3→反复调 →
张小明[体验]：搭了3层，开心
```
---
## 🎯 与旧版对比
| 维度 | 旧版（v2.0）| 新版（v3.0）|
|------|------------|------------|
| **格式要求** | 较严格 | 非常灵活 |
| **输入方式** | 5种固定格式 | 任意自然语言 |
| **口语支持** | 有限 | 完全支持 |
| **容错性** | 中 | 高 |
| **智能解析** | 关键词匹配 | AI语义理解 |
| **推荐场景** | 规范记录 | 快速随手记 |
---
## ✅ 使用建议
### 不同场景推荐输入方式
| 场景 | 推荐方式 | 示例 |
|------|---------|------|
| **边走边记** | 极简一句话 | "小明搭3层自己调" |
| **语音输入** | 自然对话式 | "小明今天表现很好..." |
| **课后整理** | 列表速记 | "- 小明 - 搭3层 - 开心" |
| **批量生成** | 简化表格 | "小明 搭3层 开心" |
| **重点关注** | 分段描述 | "【小明】导入...探索..." |
### 黄金法则
1. **有姓名** → AI知道是谁
2. **有行为** → AI知道做了什么
3. **其他随意** → AI自动补充
**记住**：没有固定格式，说人话就行！
---
## 📦 存储位置（双轨制）
> **新增**：确认后同时保存到两个位置
| 存储位置 | 用途 | 文件路径 |
|---------|------|---------|
| **班级周汇总** | 集中查看当周全班表现 | `memory/class-evaluation-summary/第X周/{班级}.md` |
| **个人历史课评** | 追踪学生完整成长轨迹 | `memory/student/{班级}/{学生名}/历史课评记录.md` |
### 数据流转
## 📦 存储流程（优化后）
```
教师输入 → AI生成 → 【等待确认】 → 确认后双轨保存
↓
┌──────────┴──────────┐
↓ ↓
班级周汇总.md 个人历史课评.md
教师输入 → AI解析 → 预加载档案 → 生成课评 → 自动保存班级汇总 → 展示给教师
↓
教师确认/修改 ← 一键发送 ← 自动保存个人档案 ← 教师点击发送
```
### 使用场景
### 自动保存规则
- **班级周汇总**：周回顾、备课参考、批量发送家长群
- **个人历史课评**：一对一家长沟通、学期总结、成长档案
| 学生类型 | 班级周汇总 | 个人档案 | 教师操作 |
|----------|-----------|----------|----------|
| 正式学生 | ✅ 自动保存 | ✅ 确认后保存 | 查看→发送 |
| [补课] | ✅ 自动保存 | ❓ 询问后决定 | 查看→选择→发送 |
| [体验] | ✅ 自动保存（标记） | ❌ 不保存 | 查看→发送 |
| [缺课] | ✅ 记录缺席 | ❌ 不生成 | 无 |
---
## 📞 常见问题
### Q：我写得乱，AI能懂吗？
**A**：能！只要包含姓名和关键行为，AI会自动理解并规整。
**Q：速记符号记不住怎么办？**
A：不用记！直接用自然语言描述，AI一样能理解。速记是给熟练用户的可选提速方式。
### Q：语音转文字很多错别字怎么办？
**A**：没关系，AI能根据上下文推断。关键是发音清晰的动词和名词。
**Q：忘记打标记怎么办？**
A：AI会检测档案自动判断。有档案=正式学生，无档案=提示选择[补课]/[体验]。
### Q：忘记写课程信息怎么办？
**A**：AI会从历史记录或上下文中自动推断。
**Q：标记可以组合吗？**
A：可以！`张小明[体验][new]`表示体验课新学生。
### Q：批量输入需要严格对齐吗？
**A**：不需要！用空格或制表符分隔即可，AI会自动整理。
### Q：补课/体验学生怎么处理？
**A**：详见 [33-first-class-rules.md](33-first-class-rules.md) 新学生与补课学生处理规则。
### Q：体验课学生不想建档怎么办？
**A**：直接回复「跳过」或「仅保存到班级汇总」。课评会保存在 `class-evaluation-summary/第X周/{班级}.md` 中，标记为体验学生，不影响后续正式学员的档案管理。
**Q：上下文记忆持续多久？**
A：一次会话内有效。换班级时重新指定即可。
---
@@ -452,12 +250,10 @@ AI输出：
| 版本 | 日期 | 更新内容 |
|-----|------|---------|
| v3.2 | 2026-04-16 | **新增补课/体验学生处理说明**：说明无档案学生的检测、提醒和可选保存方式 |
| v3.1 | 2026-04-15 | **新增双轨存储说明**：确认后同时保存到班级周汇总和个人历史课评，便于集中查看和追踪成长 |
| **v4.0** | **2026-04-19** | **优化版**：新增速记符号系统、标记驱动处理、会话上下文记忆 |
| v3.2 | 2026-04-16 | 新增补课/体验学生处理说明 |
| v3.0 | 2026-03-26 | 大幅增强格式包容性，支持任意自然语言输入 |
| v2.0 | 2026-03-26 | 新增单个/批量生成方式 |
| v1.0 | 2026-03-25 | 初始版本，5种固定格式 |
---
*新版本核心理念：用最自然的方式记录，让AI处理格式*
*核心理念：用最自然的方式记录，让AI处理格式*

493
.claude/rules/32-batch-generation.md
View File

@@ -1,221 +1,336 @@
# 批量课评生成规则
# 批量课评生成规则 v2.0（优化版）
> 支持一节课给多个学生同时生成课评，保持千人千面
>
> **存储方式**（确认后双轨保存）：
> - 班级周汇总：`memory/class-evaluation-summary/第X周/{班级}.md`（便于查看当周全班）
> - 个人历史课评：`memory/student/{班级}/{学生名}/历史课评记录.md`（保留完整成长档案）
>
> **首次上课/补课说明**：详见 [33-first-class-rules.md](33-first-class-rules.md)
> **优化内容**：批量并行生成、智能分级确认、自动质量检查
## 批量输入格式
---
### 表格式（推荐）
## 🚀 批量生成流程（优化后）
```
课程：[课程代码]
班级：[班级代码]
日期：[日期]
| 学生 | 核心表现 | 情绪 | 亮点/需关注 | 对比 |
|-----|---------|------|------------|------|
| 小明 | 观望5分钟后主动搭3层，自己调高度 | 稳定 | 比上周主动 | 进步明显 |
| 小红 | 全程专注，搭5层加弯管 | 开心 | 主动帮助旁边 | 保持 |
| 小强 | 频繁换玩法，未完整搭建 | 兴奋→烦躁 | 需引导坚持 | 和之前类似 |
输入表格 → AI并行解析每个学生 → 预加载课程/档案 →
并行生成多份课评 → 自动保存班级周汇总 → 质量检查 →
批量展示 → 教师一键确认 → 自动双轨保存
```
### 列表式
### 效率对比
```
课程：TUBE-001
班级：小小班A班
日期：2026-03-25
| 环节 | 优化前 | 优化后 | 提升 |
|------|--------|--------|------|
| 生成方式 | 顺序生成 | 并行生成 | 速度↑ |
| 确认次数 | 每人1次 | 批量1次 | 效率↑↑ |
| 保存操作 | 手动双轨 | 自动保存 | 便捷↑ |
1. 小明：观望5分钟→主动搭3层→自己调高度，情绪稳定，比上周主动
2. 小红：全程专注搭5层加弯管，开心，主动帮助旁边
3. 小强：频繁换玩法未完整搭建，兴奋→烦躁，需引导坚持
4. 小美：搭2层就喊老师看求关注，正常，和之前类似
5. 豆豆：独自玩球不搭管道，开心，社交需引导
6. 天天：搭4层但一倒就哭，敏感，抗挫需关注
7. 糖糖：模仿小红搭得很稳，平静，模仿能力强
8. 乐乐：中途要上厕所，回来没继续，正常，身体原因
```
---
## 批量生成流程（确认后双轨保存）
## 📝 批量输入格式
```
输入表格 → AI解析每个学生 → 调取课程教案 → 调取班级档案 →
生成多份独立课评 → 暂存班级周汇总 → 教师审核确认 → 双轨保存
↓
┌──────────┴──────────┐
↓ ↓
班级周汇总.md 个人历史课评.md
```
### 标准列表式（推荐）
### 存储位置
| 存储位置 | 文件路径 | 用途 |
|---------|---------|------|
| **班级周汇总** | `memory/class-evaluation-summary/第X周/{班级}.md` | 集中查看当周全班表现 |
| **个人历史课评** | `memory/student/{班级}/{学生名}/历史课评记录.md` | 追踪个人完整成长轨迹 |
## 避免雷同的策略
### 1. 开头差异化
| 学生类型 | 开头句式 |
|---------|---------|
| 谨慎型 | "今天[学生]终于..." |
| 活跃型 | "[学生]今天一如既往..." |
| 第一次尝试（需教师明确标注） | "这节课是[学生]第一次..." |
| 进步型 | "和上周相比，[学生]..." |
### 2. 侧重点差异化
同一节课，不同学生关注不同维度：
```
课程：TUBE-001 管道滚球（目标：空间感知+手眼协调）
小明（谨慎型）→ 侧重：参与度和勇气
"今天能主动尝试管道搭建..."
小红（熟练型）→ 侧重：创意和拓展
"不仅完成基础搭建，还自己设计了弯管路线..."
小强（困难型）→ 侧重：过程价值
"虽然最后没有完成作品，但前15分钟的探索很有价值..."
```
### 3. 建议差异化
同一节课，不同学生给不同建议：
```
小明（参与少）：在家可以用纸筒做简单轨道
小红（能力强）：可以尝试用不同材料做对比实验
小强（坚持短）：可以从5分钟小目标开始练习
```
## 批量输出格式
### 分隔输出（推荐）
```
━━━━━━━━━━━━━━━━━━━━━━━
【学生1：小明】
198字 | 5段
[课评内容]
━━━━━━━━━━━━━━━━━━━━━━━
【学生2：小红】
210字 | 5段
[课评内容]
━━━━━━━━━━━━━━━━━━━━━━━
[...]
```
### 汇总检查表
批量生成后，提供快速检查：
```
批量生成完成（8份）
字数检查：
✓ 小明：198字（符合180-220）
✓ 小红：210字（符合180-220）
⚠ 小强：165字（偏短，建议补充）
✓ ...
重复检查：
✓ 8份课评开头句式各不相同
✓ 8份课评建议各不相同
✓ 无重复用词
请审核后发送
```
## 特殊情况批量标记
| 标记 | 含义 | 处理方式 |
|-----|------|---------|
| [缺课] | 今天没来 | 不生成课评，记录缺席 |
| [早退] | 中途离开 | 课评注明"今天提前离校" |
| [情绪] | 情绪问题 | 课评侧重情绪疏导 |
| [冲突] | 与同学冲突 | 单独简短说明 |
| **[补课]** | **补课学生** | **仅保存到班级周汇总，询问是否建档** |
| **[体验]** | **体验课学生** | **仅保存到班级周汇总，不建档** |
## 批量处理补课/体验学生
当批量生成时遇到无档案学生：
**场景**：输入8个学生，其中6个有档案，2个是补课/体验学生
**AI处理流程**：
1. 正常生成8份课评
2. 检测档案状态：
```
档案检查：
✓ 梁昕乔：有档案 → 双轨保存
✓ 钟昀昊：有档案 → 双轨保存
...
⚠ 张小明：无档案（补课学生）
⚠ 李小红：无档案（体验学生）
```
3. 提醒教师：
```
⚠️ 检测到2名学生暂无个人档案：
- 张小明（补课学生）
- 李小红（体验学生）
处理方式：
[1] 为补课学生创建档案（张小明）
[2] 体验学生仅保留在班级汇总（李小红）
[3] 全部仅保存到班级汇总
```
4. 根据教师选择执行保存
**批量输入时标记补课/体验学生**：
```
课程：DISC-007
班级：发现世界-周四19点
日期：4月16日
梁昕乔：快速启动，开心
钟昀昊：慢热，稳定
张小明[补课]：搭了3层，认真 ← 标记为补课学生
李小红[体验]：积极参与，开心 ← 标记为体验学生
1. 乔乔：gj5→zd3→zt ↑++
2. 昊昊：慢热→zd3→反复调 →
3. 张小明[体验]：搭了3层，开心
4. 李小红[补课]：专注完成，稳定
5. 小强：频换玩法 wb↓--
```
## 效率优化
### 快捷键输入（设想）
### 简化表格式
```
输入：小明：gj5→zd3→tz（观望5分钟→主动3层→调整）
AI识别：观望5分钟后主动搭3层，自己调整
课程：DISC-007 班级：发现世界-周四19点
学生 核心表现 情绪 对比
─────────────────────────────────────────
乔乔 gj5→zd3→zt ↑ ++
昊昊 慢热→zd3→反复调 → 渐入佳境
小明[体验] 搭3层参与 ↑ 积极
小红[补课] 专注完成 → 稳定
```
### 语音转文字
### 纯速记式（高效用户）
支持教师课后语音快速录入：
```
语音："小明今天开始不敢碰，后来搭了三层，球卡住自己调了高度"
→ 自动解析为结构化输入
DISC-007 发现世界-周四19点
乔乔 gj5→zd3→zt ↑++
昊昊 慢热→zd3→反复调 →
小明[体验] zd3 ↑
```
### 模板复用
---
## ⚡ 批量输出格式（优化）
### 统一展示界面
相似表现的学生，可标记"基于小红模板微调"：
```
小花的输入：同小红，但"没有帮助旁边"
→ 生成类似结构但不同细节的课评
━━━━━━━━━━━━━━━━━━━━━━━
📊 批量生成完成（5份）｜发现世界-周四19点｜DISC-007
━━━━━━━━━━━━━━━━━━━━━━━
✅ 乔乔 198字 正常
✅ 昊昊 205字 正常
⚠️ 小强 165字 偏短
✅ 张小明[体验] 192字 体验学生
✅ 李小红[补课] 201字 补课学生
【档案状态】
✓ 乔乔：有档案 → 双轨保存
✓ 昊昊：有档案 → 双轨保存
⚠ 张小明[体验]：仅班级汇总
⚠ 李小红[补课]：询问是否建档
【批量操作】
[全部发送] [逐个查看] [标记修改] [取消]
━━━━━━━━━━━━━━━━━━━━━━━
```
## 版本
- v1.1 | 2026-04-16 | 新增补课/体验学生批量处理说明，支持标记[补课]/[体验]快速分类
- v1.0 | 2026-03-25 | 初始版本
### 智能分级确认（新增）
**自动通过条件**（同时满足）：
- ✅ 学生有完整档案
- ✅ 字数180-220字范围内
- ✅ 无敏感词/异常表述
- ✅ 情绪描述合理
**需人工确认条件**（任一满足）：
- ⚠️ 体验/补课学生（无档案）
- ⚠️ 字数偏差>20字
- ⚠️ 检测到负面情绪词
- ⚠️ 与上周表现差异过大
- ⚠️ 内容重复度高
---
## 🔍 自动质量检查（新增）
### 检查维度
```
━━━━━━━━━━━━━━━━━━━━━━━
🔍 质量检查报告
━━━━━━━━━━━━━━━━━━━━━━━
✅ 字数检查
全部符合180-220字范围
⚠️ 重复检查
3份课评开头都使用了"今天"
建议差异化：
- 乔乔→"很高兴看到乔乔..."
- 昊昊→"昊昊今天一如既往..."
- 小强→"这节课小强..."
✅ 差异化检查
5份课评侧重点各不相同
⚠️ 待关注项
小强：情绪从"兴奋"转为"烦躁"
建议：课评中增加情绪引导建议
[一键优化] [忽略继续] [查看详情]
━━━━━━━━━━━━━━━━━━━━━━━
```
### 差异化策略
**1. 开头差异化**
| 学生类型 | 开头句式示例 |
|----------|-------------|
| 谨慎型 | "今天[学生]终于主动尝试了..." |
| 活跃型 | "[学生]今天一如既往充满活力..." |
| 进步型 | "和上周相比，[学生]有了明显进步..." |
| 补课型 | "这节课[学生]融入得很好..." |
| 体验型 | "欢迎[学生]第一次来到..." |
**2. 侧重点差异化**
```
同一节课：DISC-007 旋转飞机
乔乔（谨慎型）→ 侧重：参与度和勇气
"今天能主动尝试侧面连接结构..."
昊昊（熟练型）→ 侧重：创意和拓展
"不仅完成基础旋转结构，还自己设计了..."
小强（困难型）→ 侧重：过程价值
"虽然最后没有完成作品，但前15分钟的探索..."
```
**3. 建议差异化**
```
乔乔（参与少）：在家可以用纸筒做简单旋转玩具
昊昊（能力强）：可以尝试用不同材料做对比实验
小强（坚持短）：可以从5分钟小目标开始练习专注
```
---
## 📦 存储流程（优化后）
### 自动保存机制
```
生成课评 → 自动保存到班级周汇总（待确认状态）
↓
教师确认 → 自动双轨保存 → 发送家长
↓
┌─────────┴─────────┐
↓ ↓
班级周汇总.md 个人历史课评.md
(标记已确认) (追加新记录)
```
### 存储路径
| 位置 | 路径 | 说明 |
|------|------|------|
| 班级周汇总 | `memory/class-evaluation-summary/第7周/发现世界-周四19点.md` | 全班汇总，含确认状态 |
| 个人档案 | `memory/student/{班级}/{学生}/历史课评记录.md` | 个人完整轨迹 |
---
## 🏷️ 特殊情况批量处理
### 标记速查
| 标记 | 处理方式 | 保存位置 |
|------|----------|----------|
| `[补课]` | 生成后询问是否建档 | 班级汇总+（可选）个人档案 |
| `[体验]` | 仅班级汇总，不询问 | 仅班级汇总（标记体验） |
| `[缺课]` | 记录缺席，不生成课评 | 班级汇总（标记缺课） |
| `[new]` | 创建新档案，双轨保存 | 班级汇总+个人档案 |
### 批量处理示例
```
输入：
DISC-007 发现世界-周四19点
1. 乔乔：gj5→zd3→zt ↑++
2. 昊昊：慢热→zd3→反复调 →
3. 张小明[体验]：搭了3层，开心
4. 李小红[补课]：专注完成，稳定
5. 王大力[缺课]
AI处理：
✓ 乔乔、昊昊：正常生成，双轨保存
⚠ 张小明[体验]：生成标记为"体验学生"
⚠ 李小红[补课]：生成后询问"是否为李小红创建档案？"
✓ 王大力[缺课]：记录"王大力：缺课"，不生成课评
```
---
## 💡 效率优化技巧
### 1. 上下文复用
```
/课评 班级：发现世界-周四19点 # 首次指定
# 后续直接输入学生，无需重复班级
乔乔：搭3层
昊昊：慢热
```
### 2. 快捷键输入（设想）
```
输入模板：
gj# = 观望#分钟
zd# = 主动搭#层
zt = 自己调整
示例：
输入：乔乔：gj5zd3zt↑
识别：乔乔观望5分钟后主动搭3层，自己调整，开心
```
### 3. 语音批量录入
```
语音："乔乔观望5分钟主动搭3层开心...
昊昊慢热搭3层稳定...
张小明体验课搭3层开心"
AI自动分段生成5份课评
```
---
## 📊 批量生成检查清单
### 生成前检查
- [ ] 班级信息正确（或已在上下文中）
- [ ] 学生姓名无遗漏
- [ ] 标记使用正确（[补课]/[体验]/[缺课]）
### 生成后检查
- [ ] 全部学生课评已生成
- [ ] 字数符合要求（180-220字）
- [ ] 开头句式差异化
- [ ] 建议内容个性化
- [ ] 特殊学生已标记
### 发送前检查
- [ ] 内容准确无误
- [ ] 称呼正确（小名/去姓）
- [ ] 补课/体验学生处理完毕
---
## 🎯 使用建议
### 推荐工作流程
```
Step 1: 指定班级（一次）
/课评 班级：发现世界-周四19点
Step 2: 批量输入（使用速记）
乔乔：gj5→zd3→zt ↑++
昊昊：慢热→zd3→反复调 →
小明[体验]：zd3 ↑
Step 3: AI批量生成（自动质量检查）
Step 4: 查看质量报告，一键确认
Step 5: 自动保存并发送
```
### 不同场景推荐
| 场景 | 推荐方式 | 预计时间 |
|------|---------|----------|
| 常规课后（8人） | 速记批量输入 | 3-5分钟 |
| 重点关注学生 | 自然语言详细描述 | 2-3分钟/人 |
| 边走边记 | 语音转文字 | 实时 |
| 周汇总整理 | 查看班级周汇总文件 | 1分钟 |
---
## 版本历史
| 版本 | 日期 | 更新内容 |
|-----|------|---------|
| **v2.0** | **2026-04-19** | **优化版**：新增并行生成、智能分级确认、自动质量检查 |
| v1.1 | 2026-04-16 | 新增补课/体验学生批量处理说明 |
| v1.0 | 2026-03-25 | 初始版本 |
---
*核心理念：批量不批量，千人千面不打折*

168
.claude/rules/33-first-class-rules.md
View File

@@ -116,6 +116,173 @@
---
## 🔄 简化转正流程（新增 v1.1）
### 原流程问题
- 体验学生转正需要回复"转为正式"
- 历史课评需要从班级汇总迁移到个人档案
- 操作步骤多，容易遗忘
### 优化后流程
#### 方案1：智能检测转正（推荐）
当体验/补课学生连续上课达到**3次**时，AI主动提示：
```
━━━━━━━━━━━━━━━━━━━━━━━━━
💡 转正建议
张小明已连续上3节课（第5周、第6周、第7周）：
- 第5周：体验课，积极参与
- 第6周：体验课，专注完成
- 第7周：体验课，表现稳定
建议为其创建正式档案，便于：
✓ 追踪完整成长轨迹
✓ 生成学期总结报告
✓ 家长沟通更有依据
[创建正式档案] [继续体验] [下周再提醒]
━━━━━━━━━━━━━━━━━━━━━━━━━
```
#### 方案2：一键转正（快捷）
输入简化指令：
```
教师：小明转正
或
教师：小明[正式]
AI处理：
1. 创建个人档案：memory/student/{班级}/小明/
2. 自动迁移历史课评（从班级汇总提取）
3. 标记后续课评为"正式学生"
4. 双轨保存生效
━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 转正完成：张小明
已创建：
- 用户画像.md（模板，待完善）
- 历史课评记录.md（已迁移3次课评）
- 成长素材.md（空，待补充）
历史课评已迁移：
- 第5周 DISC-005 天平秤
- 第6周 DISC-006 长颈鹿
- 第7周 DISC-007 旋转飞机
下次输入"小明"将按正式学生处理
━━━━━━━━━━━━━━━━━━━━━━━━━
```
#### 方案3：输入时标记升级（灵活）
支持在输入时直接标记状态变化：
```
输入：小明[体验→正式]：今天表现很好
AI处理：
1. 自动创建档案
2. 迁移历史课评
3. 生成本次课评
4. 双轨保存
━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 转正并生成课评：张小明
状态变化：体验 → 正式
已创建个人档案并迁移历史记录
本次课评已双轨保存
━━━━━━━━━━━━━━━━━━━━━━━━━
```
### 转正数据迁移
#### 自动迁移内容
| 内容 | 来源 | 目标 | 操作 |
|------|------|------|------|
| 历史课评 | 班级周汇总 | 个人历史课评.md | 自动提取并追加 |
| 用户画像 | 无 | 新建用户画像.md | 创建模板 |
| 成长素材 | 无 | 新建成长素材.md | 创建空文件 |
#### 迁移示例
```markdown
# 迁移前（班级汇总）
### 张小明（体验学生）⚠️
【第5周课评内容】
【第6周课评内容】
【第7周课评内容】
---
# 迁移后（个人档案）
## 历史课评记录.md
### 2026-04-04 | 课程代码：DISC-005
**课评内容**：【第5周内容】
**备注**：体验期间，原记录在班级汇总
### 2026-04-11 | 课程代码：DISC-006
**课评内容**：【第6周内容】
**备注**：体验期间，原记录在班级汇总
### 2026-04-17 | 课程代码：DISC-007
**课评内容**：【第7周内容】
**备注**：体验期间，原记录在班级汇总
### 转正记录
- 转正日期：2026-04-17
- 转正周数：第7周
- 已上课时：3节
- 来源：体验课转正
```
### 转正后班级汇总更新
```markdown
# 原标记（体验期间）
### 张小明（体验学生）⚠️
# 更新后（转正后）
### 张小明（已转正 ✅）
- 转正日期：2026-04-17
- 个人档案：已创建
- 历史课评：已迁移至个人档案
```
### 转正统计
在班级学期总览中添加转正统计：
```
## 学生流动情况
| 类型 | 人数 | 说明 |
|------|:----:|:-----|
| 正式学生 | 30人 | 学期初已建档 |
| 体验转正 | 3人 | 本学期从体验转正式 |
| 补课转入 | 2人 | 从其他班级转入 |
| 当前体验 | 2人 | 正在体验中 |
### 本学期转正记录
| 学生 | 原状态 | 转正周 | 已上课时 | 转正原因 |
|------|:------:|:------:|:--------:|:---------|
| 张小明 | 体验 | 第7周 | 3节 | 连续参与，表现稳定 |
| 李小红 | 补课 | 第5周 | 2节 | 转入正式班级 |
```
---
## 相关文件
- 输入格式规则：[30-input-format.md](30-input-format.md)
@@ -126,4 +293,5 @@
## 版本
- v1.1 | 2026-04-19 | 新增简化转正流程
- v1.0 | 2026-04-17 | 从各文件提取统一规范

162
.claude/rules/36-shorthand-learning.md Normal file
View File

@@ -0,0 +1,162 @@
# 速记符号阶梯学习指南
> 降低学习成本，从"记住所有"到"先用起来"
---
## 🎯 学习理念
不需要一次性记住所有速记符号。**用4个核心符号先上手，再逐步扩展。**
---
## 📚 第1级：核心速记（必学，5分钟上手）
这4个符号覆盖80%的日常场景，**优先掌握**。
| 速记 | 含义 | 示例 | 使用频率 |
|------|------|------|:--------:|
| `gj#` | 观望#分钟 | `gj5` = 观望5分钟 | ⭐⭐⭐⭐⭐ |
| `zd#` | 主动搭#层 | `zd3` = 主动搭3层 | ⭐⭐⭐⭐⭐ |
| `↑` | 开心/积极 | 情绪↑ | ⭐⭐⭐⭐⭐ |
| `++` | 比上周进步 | 比上周++ | ⭐⭐⭐⭐⭐ |
### 第1级实战示例
```
输入前（自然语言）：
乔乔观望了5分钟后主动搭了3层，挺开心的，比上周有进步
输入后（速记）：
乔乔：gj5→zd3 ↑++
节省：从24字到13字，节省46%输入时间
```
---
## 📚 第2级：常用速记（进阶，1天后学习）
掌握第1级后，学习这4个扩展符号，覆盖90%场景。
| 速记 | 含义 | 示例 | 使用频率 |
|------|------|------|:--------:|
| `zt` | 自己调整 | 球卡住时zt | ⭐⭐⭐⭐ |
| `→` | 情绪稳定 | 情绪→ | ⭐⭐⭐⭐ |
| `wb` | 未完成 | 任务wb | ⭐⭐⭐⭐ |
| `--` | 需关注 | 需-- | ⭐⭐⭐ |
### 第2级实战示例
```
完整速记：
乔乔：gj5→zd3→zt ↑++
昊昊：慢热→zd3→反复调 →
小强：频换玩法 wb↓--
```
---
## 📚 第3级：辅助速记（高级，按需学习）
特殊场景使用，了解即可。
| 速记 | 含义 | 使用场景 |
|------|------|----------|
| `mr` | 融入 | 融入小组活动 |
| `zx` | 专注 | 专注完成任务 |
| `sb` | 失败→调整 | 失败后调整再尝试 |
| `~` | 情绪波动 | 情绪有起伏 |
| `=` | 和之前一样 | 表现持平 |
---
## 💡 智能推荐机制（AI辅助学习）
### 场景1：首次使用速记
当教师使用自然语言输入3次后，AI主动提示：
```
━━━━━━━━━━━━━━━━━━━━━━━━━
💡 速记小贴士
您刚才的输入可以用速记更快完成：
您的输入：
"乔乔观望了5分钟后主动搭了3层，挺开心的"
速记写法：
"乔乔：gj5→zd3 ↑"
节省50%时间！试试看在下次输入中使用。
━━━━━━━━━━━━━━━━━━━━━━━━━
```
### 场景2：速记使用统计
每周生成个人速记使用报告：
```
━━━━━━━━━━━━━━━━━━━━━━━━━
📊 您的速记使用周报
本周输入课评：24份
使用速记：18份（75%）
节省时间：约8分钟
常用速记TOP3：
1. gj#（观望）- 使用15次
2. zd#（主动）- 使用12次
3. ↑（开心）- 使用10次
💡 建议学习：zt（自己调整）
本周有6次可以用到，但您使用了自然语言
━━━━━━━━━━━━━━━━━━━━━━━━━
```
### 场景3：快捷提示面板
输入`/?`或`帮助`时显示速记速查：
```
━━━━━━━━━━━━━━━━━━━━━━━━━
⚡ 速记速查面板
【第1级-必会】
gj# 观望#分钟 zd# 主动搭#层
↑ 开心/积极 ++ 比上周进步
【第2级-常用】
zt 自己调整 → 情绪稳定
wb 未完成 -- 需关注
输入"速记2"查看第2级，"速记3"查看第3级
━━━━━━━━━━━━━━━━━━━━━━━━━
```
---
## 🎓 学习路径建议
| 阶段 | 时间 | 目标 | 验收标准 |
|------|------|------|---------|
| 入门 | 第1天 | 掌握第1级4个符号 | 能用速记输入简单课评 |
| 熟练 | 第1周 | 掌握第2级8个符号 | 80%输入使用速记 |
| 精通 | 第2周 | 了解第3级符号 | 根据场景灵活使用 |
---
## 🔄 速记与自然语言对比
| 场景 | 自然语言 | 速记 | 节省 |
|------|---------|------|------|
| 简单描述 | 乔乔观望5分钟主动搭3层很开心 | 乔乔：gj5→zd3 ↑ | 60% |
| 完整描述 | 乔乔观望5分钟主动搭3层自己调整很开心比上周进步 | 乔乔：gj5→zd3→zt ↑++ | 58% |
| 复杂情况 | 小强频繁换玩法未完成情绪烦躁需关注 | 小强：频换玩法 wb↓-- | 50% |
---
*版本：v1.0*
*更新日期：2026-04-19*
*配套文件：30-input-format.md*

255
.claude/rules/37-status-panel.md Normal file
View File

@@ -0,0 +1,255 @@
# 课评状态管理面板
> 解决"待确认"状态不直观问题，提升流程闭环率
---
## 🎛️ 状态面板设计
### 面板位置
在`memory/class-evaluation-summary/第X周/{班级}.md`文件顶部，插入状态管理面板：
```markdown
---
## 📊 本周课评状态面板
> 最后更新：{时间} | 当前操作员：{教师名}
### 快速统计
| 指标 | 数值 | 状态 |
|------|:----:|:----:|
| 应到人数 | {X}人 | - |
| **实到人数** | **{Y}人** | ✅ |
| 已确认 | {Z}人 | ☑️ |
| 待确认 | {W}人 | ⏳ |
| 待生成 | {V}人 | ⏸️ |
| 缺勤 | {U}人 | 🚫 |
| **课评完成率** | **{XX}%** | {进度条} |
### 操作快捷入口
| 操作 | 指令 | 说明 |
|------|------|------|
| 一键确认全部 | `[确认全部]` | 确认所有待确认课评 |
| 查看待确认 | `[查看待确认]` | 只显示待确认学生 |
| 生成缺勤 | `[标记缺勤]` | 为未到学生记录缺勤 |
| 更新状态 | `[刷新]` | 重新计算统计数据 |
---
```
---
## 📋 学生状态明细表
在学生列表部分，使用交互式状态表：
```markdown
### 学生状态明细
| 序号 | 学生 | 状态 | 生成时间 | 确认时间 | 操作 |
|:----:|:-----|:----:|:--------:|:--------:|:----:|
| 1 | 乔乔 | ☑️ 已确认 | 16:00 | 16:05 | [查看] [修改] |
| 2 | 昊昊 | ⏳ 待确认 | 16:02 | - | [确认] [修改] [删除] |
| 3 | 小明 | ⏸️ 待生成 | - | - | [输入表现] [标记缺勤] |
| 4 | 小红 | 🚫 缺勤 | - | - | [补录] |
**图例**：
- ☑️ 已确认 - 已审核通过，已双轨保存
- ⏳ 待确认 - 已生成，等待教师确认
- ⏸️ 待生成 - 教师未输入表现
- 🚫 缺勤 - 学生未到校
```
---
## 🔔 自动提醒机制
### 提醒触发条件
| 场景 | 触发时间 | 提醒内容 |
|------|---------|---------|
| 批量生成后未确认 | 5分钟后 | "您有{X}份课评待确认" |
| 课评生成后1小时 | 1小时后 | "{学生}的课评还未确认，是否遗忘？" |
| 当日结束 | 22:00 | "今日有{X}份待确认课评，建议处理" |
| 跨周提醒 | 下周一 | "上周有{X}份未确认课评，请尽快处理" |
### 提醒展示格式
```
━━━━━━━━━━━━━━━━━━━━━━━━━
⏰ 课评状态提醒
您当前有 3份课评待确认：
1. 昊昊（发现世界-周四19点）- 生成于16:02
2. 小明（发现世界-周四19点）- 生成于16:05
3. 小红（Wedo-周六1030）- 生成于昨天
[一键全部确认] [查看详情] [忽略]
━━━━━━━━━━━━━━━━━━━━━━━━━
```
---
## 🔄 状态流转规则
### 状态流转图
```
教师输入表现
↓
┌───────────────┐
标记缺勤 →│ 待生成 │← 取消缺勤
└───────┬───────┘
↓ AI生成课评
┌───────────────┐
教师确认 →│ 待确认 │← 教师修改
└───────┬───────┘
↓ 教师确认
┌───────────────┐
│ 已确认 │
└───────┬───────┘
↓ 自动双轨保存
┌───────────────┐
查看/修改 →│ 已保存 │
└───────────────┘
```
### 操作指令对照表
| 当前状态 | 教师操作 | 新状态 | 效果 |
|:--------:|---------|:------:|:-----|
| 待生成 | 输入表现 | 待确认 | 生成课评 |
| 待生成 | 标记缺勤 | 缺勤 | 记录缺勤 |
| 待确认 | 回复"确认" | 已确认 | 双轨保存 |
| 待确认 | 回复"修改：XXX" | 待确认 | 重新生成 |
| 待确认 | 点击[确认] | 已确认 | 双轨保存 |
| 已确认 | 回复"修改：XXX" | 已确认 | 更新内容 |
| 缺勤 | 补录表现 | 待确认 | 生成课评 |
---
## 📱 快速操作示例
### 场景1：一键确认全部
```
教师：确认全部
AI：
━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 已确认 3份课评
☑️ 昊昊 - 发现世界-周四19点 - DISC-007
☑️ 小明 - 发现世界-周四19点 - DISC-007
☑️ 小红 - Wedo-周六1030 - CREATE-007
已自动双轨保存到：
- 班级周汇总
- 个人历史课评
━━━━━━━━━━━━━━━━━━━━━━━━━
```
### 场景2：批量查看待确认
```
教师：查看待确认
AI：
━━━━━━━━━━━━━━━━━━━━━━━━━
⏳ 待确认课评列表（3份）
【发现世界-周四19点 - DISC-007】
1. 昊昊
生成时间：16:02
字数：205字
[确认] [查看] [修改]
2. 小明
生成时间：16:05
字数：198字
[确认] [查看] [修改]
【Wedo-周六1030 - CREATE-007】
3. 小红
生成时间：昨天
字数：210字
[确认] [查看] [修改]
[一键全部确认]
━━━━━━━━━━━━━━━━━━━━━━━━━
```
### 场景3：单个学生快速操作
```
教师：确认昊昊
AI：
━━━━━━━━━━━━━━━━━━━━━━━━━
☑️ 已确认：昊昊（发现世界-周四19点）
课评内容预览：
"昊昊本节课学习了..."
已保存到：
- 班级周汇总：第7周/发现世界-周四19点.md
- 个人档案：student/发现世界-周四19点/昊昊/历史课评记录.md
━━━━━━━━━━━━━━━━━━━━━━━━━
```
---
## 📊 数据持久化
### 状态存储位置
状态信息保存在班级汇总文件的YAML Frontmatter中：
```markdown
---
class: 发现世界-周四19点
week: 7
course: DISC-007
generated_at: 2026-04-17T16:00:00
status:
total: 2
confirmed: 1
pending: 1
missing: 0
students:
- name: 乔乔
status: confirmed
generated_at: "16:00"
confirmed_at: "16:05"
- name: 昊昊
status: pending
generated_at: "16:02"
confirmed_at: null
---
# 发现世界-周四19点 第7周汇总
...
```
---
## ✅ 实施检查清单
- [ ] 在班级汇总模板中添加状态面板
- [ ] 实现"一键确认全部"功能
- [ ] 实现"查看待确认"过滤功能
- [ ] 配置自动提醒（5分钟、1小时、当日结束）
- [ ] 在文件Frontmatter中添加状态元数据
- [ ] 测试状态流转是否正常
---
*版本：v1.0*
*更新日期：2026-04-19*
*配套文件：32-batch-generation.md*

326
.claude/rules/38-quick-edit.md Normal file
View File

@@ -0,0 +1,326 @@
# 快速编辑功能规则
> 解决小错误修改需重新生成的问题，提升修改效率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*

311
.claude/rules/40-keping-快速入门.md
View File

@@ -1,106 +1,287 @@
# 课评生成快速入门指南
# 课评生成快速入门指南 v3.0（优化版）
> 穹狼乐高编程AI课评系统 - 5分钟上手版
> 穹狼乐高编程AI课评系统 - **3分钟上手版**
>
> **完整文档**：参见 `SKILL.md` (keping-advanced)
> **本次优化**：新增速记符号、会话上下文、批量一键确认
---
## 🚀 两种方式速查
## 🚀 30秒极速上手
| 方式 | 命令 | 适用场景 | 学生数 |
|------|------|---------|--------|
| **单个生成** | `/课评 学生:XXX 表现:XXX` | 特殊情况、重点关注 | 1人 |
| **批量生成** | `/课评 批量:true` + 表格 | 常规课堂、多学生 | 2-15人 |
### 第1步：指定班级（一次即可）
```
/课评 班级：发现世界-周四19点
```
### 第2步：输入学生表现
```
乔乔：观望5分钟→主动搭3层→自己调整，开心，比上周进步
昊昊：慢热，搭3层，反复调整，稳定
```
### 第3步：一键确认发送
```
AI生成 → 查看 → [全部发送]
```
**完成！3份课评已自动保存到班级汇总和个人档案。**
---
## 📝 单个学生课评
## ⚡ 速记符号速查（新增）
### 最简格式（推荐）
```
/课评 乔乔：快速启动→搭3层→自己加装饰，情绪开心
```
### 行为速记
### 标准格式
```
/课评 学生:钟昀昊 班级:发现世界-周四19点 表现:慢热→搭3层→反复调整 情绪:稳定
```
### 关键字段
- **学生**：姓名（支持谐音自动纠正）
- **表现**：核心观察（用`→`表示行为发展）
- **情绪**：稳定/开心/低落等
- **对比**：比上周/和之前一样
---
## 📊 批量课评生成
### 命令格式
```
/课评 批量:true 课程:DISC-003 班级:发现世界-周四19点 日期:4月2日
| 学生 | 核心表现 | 情绪 | 亮点 |
|-----|---------|------|------|
| 乔乔 | 快速启动→搭3层→加装饰 | 开心 | 创意突出 |
| 昊昊 | 慢热→搭3层→反复调整 | 稳定 | 渐入佳境 |
```
---
## ⚡ 速记符号
| 符号 | 含义 | 示例 |
| 速记 | 含义 | 示例 |
|------|------|------|
| `→` | 行为发展/时间线 | `观望5分钟→主动尝试` |
| `,` | 并列行为 | `搭3层,自己调高度` |
| `→`情绪 | 情绪变化 | `兴奋→烦躁` |
| `比上周` | 纵向对比 | `比上周主动` |
| `gj#` | 观望#分钟 | `gj5` = 观望5分钟 |
| `zd#` | 主动搭#层 | `zd3` = 主动搭3层 |
| `zt` | 自己调整 | 遇到问题时自己调整 |
| `wb` | 未完成 | 未完成搭建 |
| `mr` | 融入 | 融入小组活动 |
| `zx` | 专注 | 专注完成任务 |
### 情绪速记
| 速记 | 含义 |
|------|------|
| `↑` / `kx` | 开心 |
| `→` / `wd` | 稳定 |
| `↓` / `fd` | 烦躁 |
| `~` / `bd` | 波动 |
### 对比速记
| 速记 | 含义 |
|------|------|
| `++` / `!` | 比上周进步 |
| `=` / `0` | 和之前一样 |
| `--` / `?` | 需关注 |
### 速记组合示例
```
完整描述：
乔乔观望5分钟后主动搭3层，自己调整，开心，比上周进步
速记写法：
乔乔：gj5→zd3→zt ↑++
```
---
## 🎯 流程：生成 → 确认 → 保存
## 🏷️ 学生类型标记（新增）
**输入时添加标记，AI自动处理**
| 标记 | 含义 | 处理方式 |
|------|------|----------|
| `[体验]` | 体验课学生 | 仅保存到班级汇总 |
| `[补课]` | 补课学生 | 询问是否建档 |
| `[缺课]` | 今天缺席 | 记录缺席，不生成课评 |
| `[new]` | 新学生首次 | 创建档案，双轨保存 |
**示例**：
```
教师输入 → AI生成课评 → 【等待确认】 → 确认后自动保存
↓
需修改？→ 重新生成
乔乔：gj5→zd3→zt ↑++
张小明[体验]：搭了3层，开心
李小红[补课]：专注完成，稳定
```
**确认指令**："确认"、"保存"、"没问题"
**修改指令**：直接指出修改意见
---
## 📝 三种常用方式
### 方式1：极简一句话（最自由）
```
乔乔今天开始不敢碰，后来主动搭了三层，球卡住自己调高度，挺稳定的，比上周主动多了
```
**特点**：
- 任意格式，AI自动解析
- 支持口语化、语音转文字
- 适合边走边记
### 方式2：速记符号（最高效）
```
乔乔：gj5→zd3→zt ↑++
昊昊：慢热→zd3→反复调 →
小强：频换玩法 wb↓--
```
**特点**：
- 输入速度最快
- 适合熟练用户
- 批量处理首选
### 方式3：批量表格（最清晰）
```
课程：DISC-007
班级：发现世界-周四19点
1. 乔乔：gj5→zd3→zt ↑++
2. 昊昊：慢热→zd3→反复调 →
3. 张小明[体验]：搭了3层，开心
4. 李小红[补课]：专注完成，稳定
```
**特点**：
- 全班一览清晰
- 支持标记分类
- 适合课后整理
---
## 🔄 优化后流程：生成 → 确认 → 保存
```
教师输入 → AI自动生成 → 【自动保存班级汇总】 → 展示给教师
↓
教师查看 → [一键发送] → 【自动保存个人档案】 → 完成
```
### 流程对比
| 环节 | 优化前 | 优化后 |
|------|--------|--------|
| 生成速度 | 顺序生成 | 并行生成 |
| 确认次数 | 每人1次 | 批量1次 |
| 保存操作 | 手动双轨 | 自动保存 |
| 预计时间（8人） | 15-20分钟 | **3-5分钟** |
---
## 📊 批量生成界面预览
```
━━━━━━━━━━━━━━━━━━━━━━━
📊 批量生成完成（4份）｜发现世界-周四19点｜DISC-007
━━━━━━━━━━━━━━━━━━━━━━━
✅ 乔乔 198字 正常
✅ 昊昊 205字 正常
✅ 张小明[体验] 192字 体验学生
✅ 李小红[补课] 201字 补课学生
【批量操作】
[全部发送] [逐个查看] [标记修改] [取消]
━━━━━━━━━━━━━━━━━━━━━━━
```
---
## 📁 文件存储位置
### 双轨自动保存
| 存储位置 | 文件路径 | 用途 |
|---------|---------|------|
| **班级周汇总** | `memory/class-evaluation-summary/第X周/{班级}.md` | 集中查看当周全班表现 |
| **个人历史课评** | `memory/student/{班级}/{学生名}/历史课评记录.md` | 追踪个人完整成长轨迹 |
### 自动保存规则
- ✅ **正式学生**：自动双轨保存（班级+个人）
- ⚠️ **补课学生**[补课]：先班级汇总，询问后决定是否建档
- 📌 **体验学生**[体验]：仅班级汇总，标记"体验"
- ❌ **缺课学生**[缺课]：仅记录"缺课"，不生成课评
---
## 💡 进阶技巧
### 技巧1：会话上下文
**首次指定班级后，后续无需重复**
```
memory/student/{班级}/{学生名}/历史课评记录.md
/课评 班级：发现世界-周四19点 # 只需一次
# 后续直接输入
乔乔：搭3层，开心
昊昊：慢热，稳定
```
### 技巧2：语音快速录入
```
语音："呃...乔乔啊...观望了5分钟...主动搭3层..."
AI自动解析为：乔乔：gj5→zd3→zt
```
### 技巧3：混合输入
```
# 同一批输入中混合使用自然语言和速记
乔乔今天表现很好，搭了3层还自己调整，开心
昊昊：慢热→zd3→反复调 →
张小明[体验]：积极参与
```
---
## ❓ 常见问题
## ❓ 常见问题速答
**Q：学生画像缺失怎么办？**
A：系统会继续生成，使用通用模板。建议后续补建画像。
**Q：速记符号记不住怎么办？**
A：不用记！直接用自然语言描述，AI一样能理解。
**Q：课程代码记不清？**
A：可用课程名称代替，系统会从班级信息自动推断。
**Q：忘记打标记会怎样？**
A：AI会自动检测档案。有档案=正式学生，无档案=提示选择[补课]/[体验]。
**Q：生成的课评不满意？**
A：修改输入描述增加具体细节，或直接手动编辑。
**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/` 目录
- **课程教案**：参见 `memory/lesson/` 目录
- **学生档案**：参见 `memory/student/` 目录
- **速记符号表**：参见 `30-input-format.md`
- **批量生成规则**：参见 `32-batch-generation.md`
---
*版本：v2.0（精简版）*
*完整版：参见 SKILL.md*
## 版本
| 版本 | 日期 | 更新内容 |
|-----|------|---------|
| **v3.0** | **2026-04-19** | **优化版**：新增速记符号、会话上下文、批量一键确认 |
| v2.0 | 2026-04-10 | 新增双轨保存说明 |
| v1.0 | 2026-03-25 | 初始版本 |
---
*记住：说人话就行，AI帮你处理格式！*

8
.claude/rules/50-output-format-preschool.md
View File

@@ -23,7 +23,7 @@
### 排版样式（三段式）
```
【称呼】今天学习了"【主题】"，【知识点】 🔍
【称呼】本节课学习了"【主题】"，【知识点】 🔍
这节课【称呼】【整体表现描述】。【掌握程度】，【课程环节表现】。和【对比时间】相比，【进步表现】，【具体亮点】 💪✨
@@ -60,7 +60,7 @@
**格式**：
```
【孩子称呼】今天学习了"【课程主题】"，【核心知识点描述】 🔍
【孩子称呼】本节课学习了"【课程主题】"，【核心知识点描述】 🔍
```
**示例**：
@@ -139,9 +139,9 @@
### 示例2：托班-意识世界（三段式）
```
昀昊今天玩了"管道滚球"，让小球在管道里旅行，感受了球滚动的乐趣 🔍
昀昊本节课玩了"管道滚球"，让小球在管道里旅行，感受了球滚动的乐趣 🔍
这节课昀昊开始有点害羞，看了2分钟才开始尝试，后来在老师鼓励下搭了2层管道让小球滚下来。导入环节对滚球游戏很感兴趣，探索环节专注尝试管道连接，最后能独立完成2层搭建，本节课的管道连接目标顺利达成。和上周相比，今天敢自己拿管道尝试了，不再只是看着，能安静专注地玩10分钟，这个专注力对托班宝宝来说很棒了 💪✨
本节课昀昊开始有点害羞，看了2分钟才开始尝试，后来在老师鼓励下搭了2层管道让小球滚下来。导入环节对滚球游戏很感兴趣，探索环节专注尝试管道连接，最后能独立完成2层搭建，本节课的管道连接目标顺利达成。和上周相比，本节课敢自己拿管道尝试了，不再只是看着，能安静专注地玩10分钟，这个专注力对托班宝宝来说很棒了 💪✨
爸爸妈妈可以用保鲜膜筒芯或报纸卷成管道，和小球一起玩，让球从高的地方滚下来，感受运动的快乐 🏠
```

58
.claude/rules/51-output-format-elementary.md
View File

@@ -161,13 +161,21 @@
---
## 📝 模块模板（合并为3段）
## 📝 三段式结构模板（强制3段）
> **段落控制**：全文控制在3个段落
> - 第1段：模块1+2+3合并（课程知识点+掌握程度+课程环节与目标达成）
> - 第2段：模块4（成长亮点）
> - 第3段：模块5（课后建议）
> - 每段末尾添加1个emoji，总计5个
> **段落控制**：全文严格控制在**3个段落**，与幼儿版保持一致
> - **第1段**：课程知识点（35-45字）- 介绍本节课核心概念
> - **第2段**：课堂细节长段落（100-140字）- 整合掌握程度、课程环节表现、成长亮点
> - **第3段**：课后建议（35-45字）- 家庭延伸活动
> - **Emoji使用**：每段末尾添加1个emoji，总计3个
### 三段式结构速查
| 段落 | 覆盖模块 | 核心内容 | 字数 | Emoji |
|------|---------|---------|:----:|:-----:|
| **第1段** | 课程知识点 | 本节课学习的编程概念/技能 | 35-45字 | 💡/⚙️ |
| **第2段** | 掌握程度+课程环节+成长亮点 | 学习表现、目标达成、纵向对比 | 100-140字 | 📈/💪 |
| **第3段** | 课后建议 | 家庭延伸活动 | 35-45字 | 🏠/🔧 |
### 模块1：标题栏
@@ -252,7 +260,7 @@ Prompt编写的基本概念理解了，能写出简单的指令让AI执行。但
📝 实践表现
━━━━━━━━━━━━━━━━━━━━━━━
这节课专注度可以，但启动阶段用了较长时间观察其他同学。实际操作时能完成基础任务，遇到问题会主动求助，调试过程需要老师逐步引导。
本节课专注度可以，但启动阶段用了较长时间观察其他同学。实际操作时能完成基础任务，遇到问题会主动求助，调试过程需要老师逐步引导。
📝 成长亮点
━━━━━━━━━━━━━━━━━━━━━━━
@@ -513,23 +521,19 @@ Prompt编写的基本概念理解了，能写出简单指令让AI执行。复杂
| 二年级（7-8岁）| 200-240 | 230-260 |
| 四年级（9-10岁）| 220-280 | 260-300 |
### 纯文本段落版（带Emoji）
### 纯文本段落版（3段式，带Emoji）
除结构化报告版外，小学版也可使用简洁的段落形式，每段末尾添加1个emoji：
除结构化报告版外，小学版也可使用简洁的3段式段落形式，每段末尾添加1个emoji：
**示例（AI03四年级）**：
**示例（AI03四年级，3段式）**：
```
怡瞳今天学习了Trae IDE的Builder模式，掌握了Markdown基础符号和故事三步设定方法 ⚙️
怡瞳本节课学习了Trae IDE的Builder模式，掌握了Markdown基础符号和故事三步设定方法 💡
Builder模式的操作理解了，能独立完成基础排版，但第一次用**加粗时符号位置放错了，调整后正常。故事设定环节完成了类型和角色卡的设定 📊
本节课对Markdown排版操作理解了，能独立完成基础标题和列表设置，但第一次用加粗符号时位置放错了，调整后正常。导入环节对写故事很感兴趣，实践环节专注尝试不同排版方式，最后分享环节能说出标题和列表的区别，本节课的基础排版目标顺利达成。和上周相比，本节课在遇到格式错误时没有急着放弃，而是尝试了几次调整，这个坚持的态度值得肯定 📈
导入环节对写故事很感兴趣，实践环节专注尝试Markdown排版，最后分享环节能说出标题和列表的区别，本节课的基础排版目标顺利达成 🎯
和上周相比，今天在遇到格式错误时没有急着放弃，而是尝试了几次调整，这个坚持的态度值得肯定 📈
回家后可以用Markdown整理一篇读书笔记，试试用#做标题、-做列表，巩固今天的排版技能 🏠
回家后可以用Markdown整理一篇读书笔记，试试用#做标题、-做列表，巩固本节课的排版技能 🏠
```
**字数**：220字 | **段落**：5段 | **Emoji**：5个
**字数**：220字 | **段落**：3段 | **Emoji**：3个
### 视觉元素密度
- **分隔线**：5-8条
@@ -538,9 +542,11 @@ Builder模式的操作理解了，能独立完成基础排版，但第一次用*
- **列表项**：6-10个
### 段落结构
- **总段落数**：8-12段
- **每段长度**：不超过3句话
- **模块数**：6个固定模块
- **总段落数**：**3段**（与幼儿版统一）
- **第1段**：课程知识点（35-45字）
- **第2段**：课堂细节长段落（100-140字），整合掌握程度、课程环节、成长亮点
- **第3段**：课后建议（35-45字）
- **Emoji**：每段末尾1个，总计3个
---
@@ -567,12 +573,12 @@ Builder模式的操作理解了，能独立完成基础排版，但第一次用*
| 维度 | 小学版（本文件）| 幼儿版 |
|------|----------------|--------|
| **表情符号** | 5个（每段1个），简洁专业 | 10-15个（每段1-2个），丰富活泼 |
| **结构** | 模块化，6个固定模块 | 自由段落，5模块 |
| **视觉** | 表格、进度条、量表 | 表情、短句、装饰 |
| **表情符号** | 3个（每段1个），简洁专业 | 3个（每段1个），温暖活泼 |
| **结构** | **3段式**（知识点+课堂细节+建议）| **3段式**（知识点+课堂细节+建议）|
| **段落** | 第2段为长段落，整合多模块 | 第2段为长段落，整合多模块 |
| **语气** | 尊重专业，数据支撑 | 温暖亲切，画面感 |
| **字数** | 200-300字 | 180-220字 |
| **信息密度** | 高（结构化）| 低（故事化）|
| **字数** | 190-240字 | 180-220字 |
| **信息密度** | 高（技术细节）| 低（故事化）|
---

2
.claude/rules/60-name-processing.md
View File

@@ -72,7 +72,7 @@
**示例**：
- 全名：梁昕乔
- 小名：乔乔
- 课评显示："乔乔今天学习了..."
- 课评显示："乔乔本节课学习了..."
#### 方式2：去姓称名（双字名）
**条件**：