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：快速编辑功能规则
- 更新40-keping-快速入门.md：优化快速入门指南v3.0
- 新增CHANGELOG.md：版本变更日志
- 更新第7周、第8周班级汇总文件
- 规范化学生档案存储
- 完善补课/体验学生处理逻辑
This commit is contained in:
小Q
2026-04-25 20:56:12 +08:00
parent 4810387dab
commit dcf1049b92
60 changed files with 2391 additions and 1569 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@@ -113,6 +113,9 @@
| 第3周 | AI03-003 | 代码辅助 | AI编程助手、代码解释、调试帮助 | 编程效率、学习能力 |
| 第4周 | AI03-004 | 数据分析 | 数据处理、图表生成、结论提炼 | 数据思维、逻辑思维 |
| **第5周** | **AI03-005** | **项目整合** | **多AI协作、工作流设计、成果输出** | **系统思维、项目管理** |
| 第6周 | AI03-006 | 未来职业预测器 | AI工具链整合、项目开发、测试迭代 | AI协作、产品开发 |
| 第7周 | AI03-007 | 超能力抽签机 | 随机算法、交互设计、视觉美化 | 编程逻辑、创意设计 |
| **第8周** | **AI03-008** | **我的个人主页（上）** | **内容先行、板块化设计、自定义智能体** | **拆解力、审美力、AI协作** |
| ... | ... | ... | ... | ... |
---

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

@@ -6,8 +6,48 @@
|------|------|
| 适用年龄 | 2.5-6岁（托班至大班） |
| 课程类型 | COURSE_BUILD（创意搭建） |
| 输出字数 | 180-220字 |
| 段落数 | **3段**（第1段：课程知识30-40字；第2段：课堂细节长段落100-130字；第3段：课后建议30-40字） |
| 输出字数 | **弹性范围：180-320字**（根据输入内容丰富度自动调整） |
| 段落数 | **3段**（第1段：课程知识30-50字；第2段：课堂细节长段落100-180字；第3段：课后建议30-50字） |
## 字数弹性规则
### 自动判断逻辑
根据教师输入的内容丰富度，自动选择合适篇幅：
| 输入类型 | 字数范围 | 适用场景 |
|:-------:|:-------:|:---------|
| **精简版** | 180-220字 | 输入简洁，无特别亮点 |
| **标准版** | 220-280字 | 输入有具体细节或成长亮点 |
| **详细版** | 280-320字 | 输入有精彩瞬间、多个亮点或特殊表现 |
### 字数分配（弹性）
| 段落 | 精简版 | 标准版 | 详细版 | 内容特点 |
|------|:------:|:------:|:------:|:---------|
| **第1段**（课程知识点）| 30-40字 | 35-45字 | 40-50字 | 基础介绍，适度扩展 |
| **第2段**（课堂细节）| 100-130字 | 130-170字 | 170-200字 | **核心段落，根据亮点多少灵活扩展** |
| **第3段**（课后建议）| 30-40字 | 35-45字 | 40-50字 | 具体建议，可略详细 |
### 触发详细版的信号词
当输入中出现以下内容时，自动进入详细版（260-320字）：
- **精彩瞬间**："特别棒的是"、"让我惊讶的是"、"印象深刻的是"
- **多个亮点**：输入中包含3个以上的独立行为描述
- **突破性行为**："第一次主动"、"从未有过"、"历史性突破"
- **情感丰富**：包含情绪变化、社交互动、创造性表现
- **对比强烈**："以前从来不...今天居然..."
### 示例对比
**精简版**（输入简洁）：
> 乔乔今天观望了5分钟，然后搭了3层，自己调整了高度，挺稳定的，比上周有进步。
>
> 输出：约200字
**详细版**（输入丰富）：
> 乔乔今天开始观望了5分钟，后来主动搭了3层管道，球卡住的时候自己调整高度，还帮助旁边的小朋友一起搭，最后完成作品特别开心，说这是她最喜欢的作品。比上周主动多了，上周观望了10分钟才开始。
>
> 输出：约280字（扩展第2段，详细描述帮助同伴、情绪反应、纵向对比）
## 语气风格
@@ -41,10 +81,13 @@
| 段落 | 覆盖模块 | 核心维度 | 字数 |
|------|---------|---------|:----:|
| **第1段** | 课程知识点 | 兴趣度 | 30-40字 |
| **第2段** | 掌握程度+课堂环节+成长亮点 | 学习表现+目标达成+成长发展 | 100-130字 |
| **第3段** | 课后建议 | 延伸学习 | 30-40字 |
| **第2段** | 掌握程度+课堂环节+成长亮点 | 学习表现+目标达成+成长发展 | **100-180字（弹性）** |
| **第3段** | 课后建议 | 延伸学习 | 30-50字 |
**段落控制**：全文控制在**3个段落**，第2段为长段落整合多个模块内容
- **第2段核心**：根据输入内容丰富度，可在100-180字之间灵活调整
- **精简场景**：输入简洁，100-120字即可
- **丰富场景**：输入有多个亮点，扩展到150-180字，充分展现学生表现
---

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

@@ -6,8 +6,48 @@
|------|------|
| 适用年龄 | 6-10岁（小学一至四年级） |
| 课程类型 | COURSE_KITTEN（图形编程） |
| 输出字数 | 190-230字 |
| 段落数 | **3段**（第1段：课程知识；第2段：课堂细节长段落；第3段：课后建议） |
| 输出字数 | **弹性范围：190-320字**（根据输入内容丰富度自动调整） |
| 段落数 | **3段**（第1段：课程知识35-50字；第2段：课堂细节长段落100-200字；第3段：课后建议35-50字） |
## 字数弹性规则
### 自动判断逻辑
根据教师输入的内容丰富度，自动选择合适篇幅：
| 输入类型 | 字数范围 | 适用场景 |
|:-------:|:-------:|:---------|
| **精简版** | 190-230字 | 输入简洁，无特别亮点 |
| **标准版** | 230-280字 | 输入有具体细节或成长亮点 |
| **详细版** | 280-350字 | 输入有精彩瞬间、多个亮点或特殊表现 |
### 字数分配（弹性）
| 段落 | 精简版 | 标准版 | 详细版 | 内容特点 |
|------|:------:|:------:|:------:|:---------|
| **第1段**（课程知识点）| 35-45字 | 40-50字 | 45-55字 | 准确术语，适度扩展 |
| **第2段**（课堂细节）| 100-130字 | 140-170字 | 170-220字 | **核心段落，根据亮点多少灵活扩展** |
| **第3段**（课后建议）| 35-45字 | 40-50字 | 45-55字 | 具体任务，可略详细 |
### 触发详细版的信号词
当输入中出现以下内容时，自动进入详细版（280-350字）：
- **精彩瞬间**："特别棒的是"、"让我惊讶的是"、"印象深刻的是"
- **多个亮点**：输入中包含3个以上的独立行为描述
- **突破性行为**："第一次主动"、"从未有过"、"历史性突破"
- **技术细节**：输入中有具体的编程逻辑、调试过程、错误排查
- **情感丰富**：包含情绪变化、社交互动、创造性表现
### 示例对比
**精简版**（输入简洁）：
> 李想今天学习了循环，理解了重复执行，自己调试了三次，最后成功了，挺开心的。
>
> 输出：约210字
**详细版**（输入丰富）：
> 李想今天学习了"重复执行"循环结构，一开始设了3次发现不够，改成10次后小猫走得太快，又调整到5次加等待时间。调试过程中主动说"让我再试一次"，最后成功的时候自己鼓掌。还主动帮同桌找bug，说是"你少了结束括号"。这个分享行为是第一次出现。
>
> 输出：约310字（充分展现调试过程、坚持精神、帮助他人的亮点）
## 语气风格
@@ -29,65 +69,68 @@
## 必写模块
> **Emoji使用说明**：小学版课评在每段末尾添加1个简洁emoji，总计5个，保持专业感与趣味性平衡
> - **模块1**（课程知识点）：💡 或 📚
> - **模块2**（掌握程度）：✓ 或 ⚡
> - **模块3**（课程环节与目标达成）：🎯 或 ✅
> - **模块4**（成长亮点）：📈 或 💪
> - **模块5**（课后建议）：🏠 或 🔧
> **Emoji使用说明**：小学版课评采用**3段式**，每段末尾添加1个简洁emoji，总计**3个**，保持专业感与趣味性平衡
> - **第1段**（课程知识点）：💡 或 📚
> - **第2段**（课堂细节+成长亮点）：📈 或 💪
> - **第3段**（课后建议）：🏠 或 🔧
>
> **首次上课/补课说明**：详见 [33-first-class-rules.md](33-first-class-rules.md)
### 1. 课程知识点（35-45字）
### 1. 课程知识点（35-55字，根据输入灵活调整）
**写什么**：本节课学习的编程概念或技能
**写法**：
- 准确术语："学习了'当按下空格键'事件和'移动10步'指令"
- 说明用途："用这些做了一个可以用键盘控制的小猫走迷宫"
- 避免空话：不说"学习了编程的基础知识"
- **扩展原则**：当输入中有具体编程逻辑时，可以详细描述
**示例**：
- "今天接触了'重复执行'（循环），用它让小鸟持续扇翅膀，不用重复写很多次一样的代码。"
- "学习了'如果...那么'判断语句，让小猫碰到红色区域时说出'你输了'。"
### 2. 掌握程度（35-45字）
### 2. 掌握程度（35-70字，根据输入灵活调整）
**写什么**：对知识点的理解和应用情况
**写法**：
- 具体表现："能独立搭建循环结构，但循环次数需要试几次才确定"
- 错误分析："条件判断的方向写反了，改成'碰到红色'后运行正常"
- 避免笼统：不说"掌握得不错"
- **扩展原则**：当输入中有具体的调试过程、错误排查时，充分展开描述
**示例**：
- "理解了循环能省事的道理，但第一次设成重复3次，发现翅膀扇得太快，调整后改成重复5次、每次等待0.2秒。"
- "条件判断的逻辑听明白了，实际操作时把'>'和'<'搞混了一次，检查后发现并改正。"
- **简洁版**："理解了循环能省事的道理，但第一次设成重复3次，发现翅膀扇得太快，调整后改成重复5次、每次等待0.2秒。"
- **详细版**："循环的概念理解得很清楚，第一次设成重复3次，发现小猫走得不够远；改成10次后速度又太快了；最后调整到5次加0.2秒等待时间，终于达到理想效果。整个调试过程很耐心，尝试了3次才找到最佳参数。"
### 3. 课程环节与目标达成（40-50字）
### 3. 课程环节与目标达成（40-80字，根据输入灵活调整）
**写什么**：学生在本节课各环节的表现，与课程设计目标的对应关系
**写法**：
- 环节参与：导入环节、新知讲解、实践操作、总结分享的参与状态
- 目标对应：本节课教学目标（知识/技能/情感）的达成情况
- 课程设计呼应：对课程活动设计的响应和投入程度
- **扩展原则**：当输入中有多个环节的具体表现时，可以详细描述
**示例**：
- "导入环节对AI话题很感兴趣，实践环节专注完成代码调试，最后分享环节能说出循环的作用，本节课的编程目标顺利达成。"
- "在Trae Builder模式探索中投入度高，Markdown练习环节主动尝试不同排版，最后能独立完成故事设定文档。"
### 4. 成长亮点（35-45字）
### 4. 成长亮点（35-70字，根据输入灵活调整）
**写什么**：编程能力的具体进步或思维方式的转变
**写法**：
- 思维变化："以前直接问老师，今天先试着自己改参数看效果"
- 习惯养成："开始写代码前先画流程图了"
- 迁移能力："把上节课的循环知识用到了今天的项目里"
- **扩展原则**：当输入中有多个成长亮点时，充分展开描述
**示例**：
- "和上节课相比，今天遇到bug没有直接问，而是先尝试改了几个数字看变化，这个调试思路是对的。"
- "主动用了上节课学的注释功能，给重要的代码块加了说明，方便自己回头看。"
### 5. 课后建议（35-45字）
### 5. 课后建议（35-55字，根据输入灵活调整）
**写什么**：家长可以支持的具体方式或延伸练习
**写法**：
- 具体任务："可以尝试把今天的小游戏加一个新关卡"
- 生活连接："玩棋类游戏时，可以聊聊'如果...就...'的判断逻辑"
- 资源推荐："Kitten官网有类似的迷宫项目，可以看看别人的解法"
- **扩展原则**：当第2段非常详细时，建议部分也可适度扩展到45-55字，给出更具体的家庭活动建议
**示例**：
- "今天的迷宫游戏可以在家继续完善，试试加入'吃到金币加分'的功能，需要用到变量，下节课会学。"
@@ -104,13 +147,9 @@
李想本节课学习了"重复执行"（循环）和"如果碰到颜色就..."（条件判断），用这两个概念做了一个小猫走迷宫的游戏 💡
循环的作用理解了，但第一次把循环次数设成3次，小猫走得不够远；改成10次后正常。条件判断一开始方向写反了，检查代码后发现并修正 ✓
导入环节对迷宫游戏很感兴趣，实践环节专注完成代码搭建，最后分享环节能说出循环的作用，本节课的编程目标顺利达成 🎯
和上周相比，本节课会主动给代码分区域摆放（运动放一起、外观放一起），这个整理习惯有助于后续写更复杂的程序 📈
循环的作用理解了，但第一次把循环次数设成3次，小猫走得不够远；改成10次后正常，条件判断一开始方向写反了，检查代码后发现并修正。导入环节对迷宫游戏很感兴趣，实践环节专注完成代码搭建，最后分享环节能说出循环的作用，本节课的编程目标顺利达成。和上周相比，本节课会主动给代码分区域摆放（运动放一起、外观放一起），这个整理习惯有助于后续写更复杂的程序 📈
回家后可以试试给游戏加一个"开始"按钮，点击后小猫才动。需要用到"当角色被点击"事件，可以预习一下。下周我们继续 🏠
---
**字数：218字 | 段落：3段 | Emoji：5个**
**字数：218字 | 段落：3段 | Emoji：3个**

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

@@ -6,7 +6,7 @@
|------|------|
| 适用年龄 | 8-10岁（小学三至四年级） |
| 课程类型 | COURSE_ROBOT（机器人竞技） |
| 输出字数 | 200-240字 |
| 输出字数 | **弹性范围：200-350字**（根据输入内容丰富度自动调整） |
| 段落数 | **3段**（第1段：课程知识；第2段：课堂细节长段落；第3段：课后建议） |
## 语气风格
@@ -30,12 +30,10 @@
## 必写模块
> **Emoji使用说明**：机器人竞赛版课评在每段末尾添加1个专业emoji，总计5个，体现竞技感与技术感
> - **模块1**（课程知识点）：⚙️ 或 🤖
> - **模块2**（掌握程度）：📊 或 ⚡
> - **模块3**（课程环节与目标达成）：🎯 或 ✅
> - **模块4**（成长亮点）：📈 或 🚀
> - **模块5**（课后建议）：🏠 或 🔧
> **Emoji使用说明**：机器人竞赛版课评采用**3段式**，每段末尾添加1个专业emoji，总计**3个**，体现竞技感与技术感
> - **第1段**（课程知识点）：⚙️ 或 🤖
> - **第2段**（课堂细节）：📈 或 🚀
> - **第3段**（课后建议）：🏠 或 🔧
>
> **首次上课/补课说明**：详见 [33-first-class-rules.md](33-first-class-rules.md)
@@ -105,13 +103,9 @@
王浩本节课训练了颜色传感器的巡线校准（重新标定白/黑值）和新的任务策略（先近后远、分段计时），主要解决之前巡线误判和策略执行拖沓的问题 ⚙️
校准后巡线成功率从上次60%提升到85%。但新策略执行不够果断，计划的"前30秒拿近处"实际用了45秒，挤压了后期高分任务的时间 📊
导入环节对竞技策略话题很感兴趣，实操训练专注完成巡线调试，复盘环节能分析出问题原因，本节课的训练目标顺利达成 🎯
和两周前相比，遇到程序异常时不再直接重试，而是先分析可能原因（传感器/参数/结构），有针对性调整，调试效率明显提高 📈
校准后巡线成功率从上次60%提升到85%，新策略执行不够果断，计划的"前30秒拿近处"实际用了45秒。导入环节对竞技策略话题很感兴趣，实操训练专注完成巡线调试，复盘环节能分析出问题原因，本节课的训练目标顺利达成。和两周前相比，遇到程序异常时不再直接重试，而是先分析可能原因（传感器/参数/结构），有针对性调整，调试效率明显提高 📈
周末可以用模拟器测试几种不同的时间分配方案（20+100、30+90、40+80），记录哪种得分更高，下周带数据来讨论策略优化 🏠
---
**字数：226字 | 段落：3段 | Emoji：5个**
**字数：226字 | 段落：3段 | Emoji：3个**

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

@@ -196,9 +196,58 @@ AI解析：
学生：昊昊
行为：观望→搭3层→反复调整
情绪：稳定
输出字数：约200字（精简版）
```
### 示例3：批量混合标记
### 示例3：详细输入 → 详细输出
```
输入：乔乔今天开始观望了5分钟，后来主动搭了3层管道，球卡住的时候自己调整高度，还帮助旁边的小朋友一起搭，最后完成作品特别开心，说这是她最喜欢的作品。比上周主动多了，上周观望了10分钟才开始。
AI解析：
学生：乔乔
行为：观望5分钟→主动搭3层→自己调整→帮助同伴
情绪：开心（特别开心）
对比：比上周进步（上周观望10分钟）
亮点：主动帮助同伴、表达情感、纵向对比明显
输出字数：约280字（详细版）
```
---
## 📏 课评字数弹性规则
### 核心理念
**输入越丰富 → 课评越详细**
课评字数不再固定为200字，而是根据你输入的内容丰富度自动调整：
| 输入类型 | 示例 | 输出字数 | 说明 |
|---------|------|---------|------|
| **精简输入** | "搭了3层，开心" | 180-220字 | 基础描述，简洁明了 |
| **标准输入** | "观望5分钟后主动搭3层，自己调整，还帮助同伴" | 220-280字 | 有具体细节或亮点，充分展现 |
| **详细输入** | "观望5分钟→主动搭3层→自己调整→帮助同伴→说这是最喜欢的作品→比上周主动多了" | 280-350字 | 精彩瞬间多，全面记录 |
### 给教师的建议
1. **简单记录 → 简洁课评**
- 适合：常规课堂、表现平稳
- 输入：简要描述行为即可
2. **详细描述 → 丰富课评**
- 适合：有亮点、有突破、有情感瞬间
- 输入：尽可能多描述细节，AI会充分展开
3. **不用担心字数**
- 描述得多 ≠ 啰嗦
- AI会智能整合，保持可读性
- 家长更喜欢看到孩子具体的成长瞬间
---
### 示例4：批量混合标记
```
输入：
@@ -211,23 +260,41 @@ AI解析：
---
## 📦 存储流程（优化后）
## 📦 存储规则
存储流程和学生类型处理规则详见 [CLAUDE.md 存储双轨制](../../CLAUDE.md) 和 [33-first-class-rules.md](33-first-class-rules.md)。
**简要说明**：
- 正式学生：双轨保存（班级汇总 + 个人档案）
- `[补课]`学生：检查档案 → 存在则双轨，不存在则询问
- `[体验]`学生：仅班级汇总
- `[缺课]`学生：仅记录缺席
### ⚠️ 重要：课评正文禁止提及补课
**无论学生是否标记为`[补课]`，课评正文中绝对不能提及补课相关内容**：
- ❌ 禁止出现"补课"、"补课上"、"来补课"、"本次补课"等词汇
- ❌ 禁止暗示学生非正常上课（如"今天特别来参加"、"临时加入"、"从其他班级过来"等）
- ❌ 禁止在课评正文中区分"本班学生"和"补课学生"
**正确处理**：
- ✅ `[补课]`标记**仅用于后台档案管理**，课评正文**完全按正常学生**撰写
- ✅ 课评开头直接写"XX本节课学习了..."，**不加任何特殊说明**
- ✅ 补课信息仅保存在班级汇总元数据中，不进入课评正文
**示例**：
```
教师输入 → AI解析 → 预加载档案 → 生成课评 → 自动保存班级汇总 → 展示给教师
↓
教师确认/修改 ← 一键发送 ← 自动保存个人档案 ← 教师点击发送
教师输入：李小红[补课]：搭了3层，专注完成
课评输出（正确）：
小红本节课学习了"旋转飞机"，认识了游乐园旋转设施的中心轴结构...
课评输出（错误）：
小红本节课作为补课学生，学习了"旋转飞机"... ❌（禁止提及补课）
小红今天来补课，学习了"旋转飞机"... ❌（禁止提及补课）
```
### 自动保存规则
| 学生类型 | 班级周汇总 | 个人档案 | 教师操作 |
|----------|-----------|----------|----------|
| 正式学生 | ✅ 自动保存 | ✅ 确认后保存 | 查看→发送 |
| [补课] | ✅ 自动保存 | ❓ 询问后决定 | 查看→选择→发送 |
| [体验] | ✅ 自动保存（标记） | ❌ 不保存 | 查看→发送 |
| [缺课] | ✅ 记录缺席 | ❌ 不生成 | 无 |
---
## 📞 常见问题
@@ -246,14 +313,4 @@ A：一次会话内有效。换班级时重新指定即可。
---
## 版本历史
| 版本 | 日期 | 更新内容 |
|-----|------|---------|
| **v4.0** | **2026-04-19** | **优化版**：新增速记符号系统、标记驱动处理、会话上下文记忆 |
| v3.2 | 2026-04-16 | 新增补课/体验学生处理说明 |
| v3.0 | 2026-03-26 | 大幅增强格式包容性，支持任意自然语言输入 |
---
*核心理念：用最自然的方式记录，让AI处理格式*

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

@@ -6,7 +6,7 @@
---
## 🚀 批量生成流程（优化后）
## 🚀 批量生成流程
```
输入表格 → AI并行解析每个学生 → 预加载课程/档案 →
@@ -14,13 +14,7 @@
批量展示 → 教师一键确认 → 自动双轨保存
```
### 效率对比
| 环节 | 优化前 | 优化后 | 提升 |
|------|--------|--------|------|
| 生成方式 | 顺序生成 | 并行生成 | 速度↑ |
| 确认次数 | 每人1次 | 批量1次 | 效率↑↑ |
| 保存操作 | 手动双轨 | 自动保存 | 便捷↑ |
> **核心优势**：8人课评从15-20分钟缩短至**3-5分钟**（效率提升75%）
---
@@ -80,22 +74,14 @@ DISC-007 发现世界-周四19点
✅ 张小明[体验] 192字 体验学生
✅ 李小红[补课] 201字 补课学生
【档案状态】
✓ 乔乔：有档案 → 双轨保存
✓ 昊昊：有档案 → 双轨保存
⚠ 张小明[体验]：仅班级汇总
⚠ 李小红[补课]：询问是否建档
【批量操作】
[全部发送] [逐个查看] [标记修改] [取消]
━━━━━━━━━━━━━━━━━━━━━━━
```
### 智能分级确认（新增）
**自动通过条件**（同时满足）：
- ✅ 学生有完整档案
- ✅ 字数180-220字范围内
- ✅ 字数在弹性范围内
- ✅ 无敏感词/异常表述
- ✅ 情绪描述合理
@@ -108,35 +94,16 @@ DISC-007 发现世界-周四19点
---
## 🔍 自动质量检查（新增）
## 🔍 自动质量检查
### 检查维度
```
━━━━━━━━━━━━━━━━━━━━━━━
🔍 质量检查报告
━━━━━━━━━━━━━━━━━━━━━━━
✅ 字数检查
全部符合180-220字范围
⚠️ 重复检查
3份课评开头都使用了"今天"
建议差异化：
- 乔乔→"很高兴看到乔乔..."
- 昊昊→"昊昊今天一如既往..."
- 小强→"这节课小强..."
✅ 差异化检查
5份课评侧重点各不相同
⚠️ 待关注项
小强：情绪从"兴奋"转为"烦躁"
建议：课评中增加情绪引导建议
[一键优化] [忽略继续] [查看详情]
━━━━━━━━━━━━━━━━━━━━━━━
```
| 检查项 | 描述 |
|--------|------|
| 字数检查 | 是否符合弹性范围（180-350字） |
| 重复检查 | 开头句式是否差异化 |
| 差异化检查 | 各课评侧重点是否不同 |
| 待关注项 | 特殊情绪/行为标记 |
### 差异化策略
@@ -152,64 +119,51 @@ DISC-007 发现世界-周四19点
**2. 侧重点差异化**
```
同一节课：DISC-007 旋转飞机
乔乔（谨慎型）→ 侧重：参与度和勇气
"今天能主动尝试侧面连接结构..."
昊昊（熟练型）→ 侧重：创意和拓展
"不仅完成基础旋转结构，还自己设计了..."
小强（困难型）→ 侧重：过程价值
"虽然最后没有完成作品，但前15分钟的探索..."
```
同一节课，不同学生类型侧重不同：
- **谨慎型** → 参与度和勇气
- **熟练型** → 创意和拓展
- **困难型** → 过程价值
**3. 建议差异化**
```
乔乔（参与少）：在家可以用纸筒做简单旋转玩具
昊昊（能力强）：可以尝试用不同材料做对比实验
小强（坚持短）：可以从5分钟小目标开始练习专注
```
根据学生能力推荐不同课后活动：
- **参与少**：在家可以用纸筒做简单旋转玩具
- **能力强**：可以尝试用不同材料做对比实验
- **坚持短**：可以从5分钟小目标开始练习专注
---
## 📦 存储流程（优化后）
### 自动保存机制
```
生成课评 → 自动保存到班级周汇总（待确认状态）
↓
教师确认 → 自动双轨保存 → 发送家长
↓
┌─────────┴─────────┐
↓ ↓
班级周汇总.md 个人历史课评.md
(标记已确认) (追加新记录)
```
### 存储路径
| 位置 | 路径 | 说明 |
|------|------|------|
| 班级周汇总 | `memory/class-evaluation-summary/第7周/发现世界-周四19点.md` | 全班汇总，含确认状态 |
| 班级周汇总 | `memory/class-evaluation-summary/第X周/{班级}.md` | 全班汇总，含确认状态 |
| 个人档案 | `memory/student/{班级}/{学生}/历史课评记录.md` | 个人完整轨迹 |
> 完整存储规则和学生类型处理详见 [CLAUDE.md](../../CLAUDE.md) 和 [33-first-class-rules.md](33-first-class-rules.md)
---
## 🏷️ 特殊情况批量处理
### 标记速查
| 标记 | 处理方式 | 保存位置 |
|------|----------|----------|
| `[补课]` | 生成后询问是否建档 | 班级汇总+（可选）个人档案 |
| 标记 | 处理逻辑 | 保存位置 |
|------|---------|---------|
| `[补课]` | **检查当前班级档案** → 存在则双轨，不存在则询问 | 班级汇总+（可选）个人档案 |
| `[体验]` | 仅班级汇总，不询问 | 仅班级汇总（标记体验） |
| `[缺课]` | 记录缺席，不生成课评 | 班级汇总（标记缺课） |
| `[new]` | 创建新档案，双轨保存 | 班级汇总+个人档案 |
**[补课]处理详细逻辑**：
1. 检查 `memory/student/{当前班级}/{学生名}/`
2. 如存在 → 该学生为本班补课 → 双轨保存
3. 如不存在 → 可能为其他班级补课 → 询问处理方式
- [1] 其他老师班级学生 → 仅班级汇总
- [2] 新转班学生 → 创建档案
### 批量处理示例
```
@@ -223,9 +177,9 @@ DISC-007 发现世界-周四19点
5. 王大力[缺课]
AI处理：
✓ 乔乔、昊昊：正常生成，双轨保存
⚠ 张小明[体验]：生成标记为"体验学生"
⚠ 李小红[补课]：生成后询问"是否为李小红创建档案？"
✓ 乔乔、昊昊：正常生成，双轨保存（正式学生）
⚠ 张小明[体验]：生成标记为"体验学生"，仅班级汇总
⚠ 李小红[补课]：检查档案 → 存在则双轨，不存在则询问
✓ 王大力[缺课]：记录"王大力：缺课"，不生成课评
```
@@ -243,49 +197,27 @@ AI处理：
昊昊：慢热
```
### 2. 快捷键输入（设想）
### 2. 语音批量录入
```
输入模板：
gj# = 观望#分钟
zd# = 主动搭#层
zt = 自己调整
示例：
输入：乔乔：gj5zd3zt↑
识别：乔乔观望5分钟后主动搭3层，自己调整，开心
```
### 3. 语音批量录入
```
语音："乔乔观望5分钟主动搭3层开心...
昊昊慢热搭3层稳定...
张小明体验课搭3层开心"
AI自动分段生成5份课评
```
语音输入多学生表现，AI自动分段生成课评。
---
## 📊 批量生成检查清单
### 生成前检查
- [ ] 班级信息正确（或已在上下文中）
- [ ] 学生姓名无遗漏
- [ ] 标记使用正确（[补课]/[体验]/[缺课]）
### 生成后检查
- [ ] 全部学生课评已生成
- [ ] 字数符合要求（180-220字）
- [ ] 字数符合弹性范围
- [ ] 开头句式差异化
- [ ] 建议内容个性化
- [ ] 特殊学生已标记
### 发送前检查
- [ ] 内容准确无误
- [ ] 称呼正确（小名/去姓）
- [ ] 补课/体验学生处理完毕
@@ -323,14 +255,4 @@ Step 5: 自动保存并发送
---
## 版本历史
| 版本 | 日期 | 更新内容 |
|-----|------|---------|
| **v2.0** | **2026-04-19** | **优化版**：新增并行生成、智能分级确认、自动质量检查 |
| v1.1 | 2026-04-16 | 新增补课/体验学生批量处理说明 |
| v1.0 | 2026-03-25 | 初始版本 |
---
*核心理念：批量不批量，千人千面不打折*

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

@@ -30,28 +30,77 @@
---
### 规则2：补课学生
### 规则2：补课学生（分两种情况处理）
**定义**：
- 已在机构有档案，但第一次上这节课
- 从其他班级/时段调整到本班上课
**补课学生定义**：
因各种原因（请假、调课等）需要在非原班级时间补课的学生。
**处理规则**：
**⚠️ 重要：补课学生分两类，处理方式不同**
#### 情况A：自己班级的学生补课
- **判断标准**：学生在 `memory/student/{当前班级}/` 目录中存在
- **处理方式**：**正常双轨保存**（班级汇总 + 个人档案）
- **说明**：这是你自己的学生，只是补课，无需额外确认
**示例**：
```
教师输入：乔乔[补课]：搭了3层，开心
AI检测：乔乔在本班级档案中存在 → 按正式学生处理
处理结果：双轨保存
```
#### 情况B：其他老师的学生来补课
- **判断标准**：学生在 `memory/student/{当前班级}/` 目录中**不存在**
- **处理方式**：**先询问再决定**
- **询问内容**：确认是否需要为该学生建档，或仅记录到班级汇总
**询问示例**：
```
⚠️ 未找到「张小明」在本班级的个人档案
该学生标记为[补课]，但不在本班级学生名单中。
可能情况：
[1] 其他老师的学生来补课 → 仅保存到班级汇总
[2] 新转班学生 → 创建个人档案
[3] 档案路径有误 → 手动指定班级
请选择处理方式：
```
#### 统一规则
- **不要写"第一次上课"相关表述**，即使这是该学生第一次上这节课
- 补课学生**不是新学生**，只是课程调整
- 正常生成课评，按已有档案处理
- 正常生成课评，按已有档案处理（或询问后的选择处理）
#### ⚠️ 重要规则：课评正文禁止提及补课
**绝对禁止**：
- ❌ **课评正文中绝对不能提及学生来补课相关内容**
- ❌ 禁止出现"补课"、"补课上"、"来补课"、"本次补课"等词汇
- ❌ 禁止暗示学生非正常上课（如"今天特别来参加"、"临时加入"等）
**正确处理**：
- ✅ 课评正文**完全按正常学生**撰写，仿佛学生就是本班正常上课的学生
- ✅ `[补课]`标记**仅作为后台参考**，用于档案存储路径判断
- ✅ 补课信息仅保存在班级汇总的元数据中，不进入课评正文
**正确示例**：
```
教师输入：小明（补课）：搭了3层，开心
课评输出：小明今天搭了3层管道，表现很开心...
教师输入：林瀚丞[补课]：积极分析课程任务，专注完成了绿色身体、黑色头部的蜥蜴设计
课评输出（正确）：
瀚丞本节课学习了"蜥蜴"的仿生搭建...（正常撰写，完全不提补课）
课评输出（错误）：
瀚丞本节课作为补课学生，学习了"蜥蜴"... ❌（禁止提及补课）
瀚丞今天来补课，学习了"蜥蜴"... ❌（禁止提及补课）
```
**错误示例**：
```
教师输入：小明（补课）：搭了3层，开心
课评输出：这节课是小明第一次上课... ❌（补课≠新学生）
```
**说明**：
- 家长看到课评时不应知道孩子是补课还是正常上课
- 补课标记仅用于教师内部管理和档案存储
- 保持课评的一致性和专业性
---
@@ -94,24 +143,31 @@
当检测到学生无个人档案时：
### 检测流程
1. AI自动检测 `memory/student/{班级}/{学生名}/` 是否存在
2. 如不存在，提醒教师该学生暂无档案
3. 请教师选择处理方式
1. AI自动检测 `memory/student/{当前班级}/{学生名}/` 是否存在
2. **如存在**：该学生为本班级补课学生 → **正常双轨保存**
3. **如不存在**：可能是其他老师班级学生 → **询问教师处理方式**
### 处理方式
| 场景 | 处理方式 | 存储位置 |
|------|---------|---------|
| 补课学生（有档案在其他班级） | 创建档案或仅保存到班级汇总 | 双轨或仅班级汇总 |
| 体验课学生（临时试听） | 仅保存到班级汇总，不建档 | 仅班级汇总 |
| 场景 | 判断条件 | 处理方式 | 存储位置 |
|------|---------|---------|---------|
| **自己班级补课学生** | 档案在当前班级目录存在 | 双轨保存 | 班级汇总 + 个人档案 |
| **其他老师班级补课学生** | 档案不在当前班级目录 | 询问后决定 | 班级汇总（可选个人档案）|
| **体验课学生** | 无标记或标记[体验] | 仅班级汇总 | 班级汇总（标记体验）|
### 询问流程（其他老师班级补课学生）
### 教师选择
```
⚠️ 未找到「张小明」的个人档案
⚠️ 未找到「张小明」在「发现世界-周四19点」班级的个人档案
处理方式：
[1] 创建档案（补课/新学生）
[2] 仅保存到班级汇总（体验课学生）
该学生标记为[补课]，但不在本班级学生名单中。
可能情况：
[1] 其他老师的学生来补课 → 仅保存到班级汇总
[2] 新转班学生 → 创建个人档案（双轨保存）
[3] 档案在其他班级目录 → 询问是否迁移或仅班级汇总
请选择处理方式：
```
---
@@ -288,10 +344,3 @@ AI处理：
- 输入格式规则：[30-input-format.md](30-input-format.md)
- 批量生成规则：[32-batch-generation.md](32-batch-generation.md)
- 快速入门：[40-keping-快速入门.md](40-keping-快速入门.md)
---
## 版本
- v1.1 | 2026-04-19 | 新增简化转正流程
- v1.0 | 2026-04-17 | 从各文件提取统一规范

4
.claude/rules/36-shorthand-learning.md
View File

@@ -156,7 +156,3 @@ wb 未完成 -- 需关注
| 复杂情况 | 小强频繁换玩法未完成情绪烦躁需关注 | 小强：频换玩法 wb↓-- | 50% |
---
*版本：v1.0*
*更新日期：2026-04-19*
*配套文件：30-input-format.md*

241
.claude/rules/37-status-panel.md
View File

@@ -4,212 +4,30 @@
---
## 🎛️ 状态面板设计
## 📊 状态类型
### 面板位置
在`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中：
在`memory/class-evaluation-summary/第X周/{班级}.md`文件顶部添加状态面板：
```markdown
---
@@ -225,31 +43,34 @@ status:
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中添加状态元数据
- [ ] 测试状态流转是否正常
| 教师输入 | 功能 |
|:---------|:-----|
| `确认全部` | 一键确认所有待确认课评 |
| `查看待确认` | 只显示待确认学生 |
| `确认{学生}` | 确认单个学生课评 |
| `修改{学生}：XXX` | 修改指定学生课评内容 |
---
*版本：v1.0*
*更新日期：2026-04-19*
*配套文件：32-batch-generation.md*
## 📊 数据持久化
状态信息保存在班级汇总文件的YAML Frontmatter中，便于：
- 快速统计课评完成情况
- 追踪学生课评状态变化
- 支持批量操作

253
.claude/rules/38-quick-edit.md
View File

@@ -4,202 +4,48 @@
---
## 🚀 快速编辑 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周
⚠️ 注意：这是历史课评，已发送给家长
如已发送，请考虑是否需要告知家长更新
━━━━━━━━━━━━━━━━━━━━━━━━━
```
- 需明确指定周数
- 示例：`修改乔乔第5周：把"搭建"改为"拼搭"`
- ⚠️ 注意：历史课评已发送给家长，修改需谨慎
---
@@ -207,15 +53,14 @@ AI处理：
### 不可快速编辑的场景
以下情况**必须重新生成**，不支持快速编辑：
以下情况**必须重新生成**：
| 场景 | 原因 | 建议操作 |
|------|------|---------|
| 改变课评结构 | 涉及多段落调整 | 重新生成 |
| 改变评价基调 | 从负面改为正面 | 重新生成 |
| 补充大量内容 | 超过50字 | 重新生成 |
| 改变主题理解 | 知识点错误 | 重新生成 |
| 添加 emoji | 格式调整 | 快速编辑支持 |
| 场景 | 原因 |
|------|------|
| 改变课评结构 | 涉及多段落调整 |
| 改变评价基调 | 从负面改为正面 |
| 补充大量内容 | 超过50字 |
| 改变主题理解 | 知识点错误 |
### 修改字数限制
@@ -225,9 +70,7 @@ AI处理：
---
## 🔄 修改与重新生成的对比
### 决策流程
## 🔄 决策流程
```
教师要求修改
@@ -243,63 +86,24 @@ AI处理：
(秒级响应) (需等待生成)
```
### 使用建议
| 情况 | 推荐方式 | 示例 |
|------|---------|------|
| 错别字 | 快速编辑 | "搭建"→"拼搭" |
| 称呼调整 | 快速编辑 | "乔乔"→"乔乔宝贝" |
| 补充1-2句话 | 快速编辑 | 添加具体细节 |
| 整体重写 | 重新生成 | "重新生成乔乔的课评" |
| 改变语气 | 重新生成 | 从平淡改为热情 |
| 补充大量细节 | 重新生成 | 添加完整事件描述 |
---
## 📊 快速编辑统计
### 使用统计
每周生成快速编辑使用报告：
```
━━━━━━━━━━━━━━━━━━━━━━━━━
📊 快速编辑使用统计（本周）
使用次数：12次
节省时间：约10分钟（vs 重新生成）
常用修改类型：
1. 替换词语 - 5次
2. 修改称呼 - 4次
3. 补充内容 - 3次
平均修改耗时：5秒
平均重新生成耗时：60秒
━━━━━━━━━━━━━━━━━━━━━━━━━
```
---
## ✅ 实施检查清单
- [ ] 支持基本替换指令（修改{学生}：把"A"改为"B"）
- [ ] 支持称呼修改指令
- [ ] 支持内容补充指令
- [ ] 支持内容删除指令
- [ ] 支持内容补充/删除指令
- [ ] 支持批量修改多个学生
- [ ] 自动定位当前周数（无需指定）
- [ ] 自动定位当前周数
- [ ] 支持历史课评修改（需指定周数）
- [ ] 修改字数限制（单次<50字）
- [ ] 修改后同步到双轨存储
- [ ] 显示修改前后对比
---
## 📝 快速参考卡
```
━━━━━━━━━━━━━━━━━━━━━━━━━
⚡ 快速编辑指令速查
修改称呼：
@@ -316,11 +120,4 @@ AI处理：
修改历史：
修改{学生}第{X}周：{修改内容}
━━━━━━━━━━━━━━━━━━━━━━━━━
```
---
*版本：v1.0*
*更新日期：2026-04-19*
*配套文件：32-batch-generation.md, 30-input-format.md*

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

@@ -28,49 +28,30 @@ AI生成 → 查看 → [全部发送]
---
## ⚡ 速记符号速查（新增）
## ⚡ 速记符号速查
### 行为速记
### 核心速记（必会）
| 速记 | 含义 | 示例 |
|------|------|------|
| `gj#` | 观望#分钟 | `gj5` = 观望5分钟 |
| `zd#` | 主动搭#层 | `zd3` = 主动搭3层 |
| `zt` | 自己调整 | 遇到问题时自己调整 |
| `wb` | 未完成 | 未完成搭建 |
| `mr` | 融入 | 融入小组活动 |
| `zx` | 专注 | 专注完成任务 |
| `↑` | 开心 | `↑++` = 开心，比上周进步 |
| `→` | 稳定 | `→` = 情绪稳定 |
### 情绪速记
| 速记 | 含义 |
|------|------|
| `↑` / `kx` | 开心 |
| `→` / `wd` | 稳定 |
| `↓` / `fd` | 烦躁 |
| `~` / `bd` | 波动 |
### 对比速记
| 速记 | 含义 |
|------|------|
| `++` / `!` | 比上周进步 |
| `=` / `0` | 和之前一样 |
| `--` / `?` | 需关注 |
> 完整速记符号表参见 [36-shorthand-learning.md](36-shorthand-learning.md)
### 速记组合示例
```
完整描述：
乔乔观望5分钟后主动搭3层，自己调整，开心，比上周进步
速记写法：
乔乔：gj5→zd3→zt ↑++
```
展开：乔乔观望5分钟后主动搭3层，自己调整，开心，比上周进步
---
## 🏷️ 学生类型标记（新增）
## 🏷️ 学生类型标记
**输入时添加标记，AI自动处理**
@@ -88,6 +69,23 @@ AI生成 → 查看 → [全部发送]
李小红[补课]：专注完成，稳定
```
### ⚠️ 重要：课评正文不显示标记
**无论输入时是否添加`[补课]`或`[体验]`标记，生成的课评正文中都不会提及这些信息**。
- `[补课]`、`[体验]`等标记**仅用于后台档案管理**
- 课评正文统一按正常学生撰写，不区分学生类型
- 家长看到的课评中不会出现"补课"、"体验"等字样
**示例**：
```
教师输入：李小红[补课]：搭了3层，专注完成
课评输出：
小红本节课学习了"旋转飞机"，认识了游乐园旋转设施的中心轴结构...
（正常撰写，完全不提"补课"相关信息）
```
---
## 📝 三种常用方式
@@ -102,8 +100,21 @@ AI生成 → 查看 → [全部发送]
- 任意格式，AI自动解析
- 支持口语化、语音转文字
- 适合边走边记
- **字数**：输入简洁 → 输出约200字
### 方式2：速记符号（最高效）
### 方式2：详细描述（最丰富）
```
乔乔今天开始观望了5分钟，后来主动搭了3层管道，球卡住的时候自己调整高度，还主动帮助旁边的小朋友一起搭，最后完成作品特别开心，说这是她最喜欢的作品。比上周主动多了，上周观望了10分钟才开始。
```
**特点**：
- 描述越详细，课评越丰富
- AI会提取所有精彩瞬间
- 家长能看到更多孩子成长细节
- **字数**：输入丰富 → 输出约280字
### 方式3：速记符号（最高效）
```
乔乔：gj5→zd3→zt ↑++
@@ -115,8 +126,9 @@ AI生成 → 查看 → [全部发送]
- 输入速度最快
- 适合熟练用户
- 批量处理首选
- **字数**：根据输入内容自动调整
### 方式3：批量表格（最清晰）
### 方式4：批量表格（最清晰）
```
课程：DISC-007
@@ -132,6 +144,24 @@ AI生成 → 查看 → [全部发送]
- 全班一览清晰
- 支持标记分类
- 适合课后整理
- **字数**：根据每位学生输入内容自动调整
---
## 💡 字数弹性说明（新增）
**核心理念：输入越丰富，课评越详细**
| 输入类型 | 示例 | 输出字数 |
|---------|------|---------|
| **精简输入** | "搭了3层，开心" | 180-220字 |
| **标准输入** | "观望5分钟→主动搭3层→自己调整→还帮助同伴" | 220-280字 |
| **详细输入** | 包含多个亮点、精彩瞬间、纵向对比 | 280-350字 |
**建议**：
- 常规课堂 → 简洁记录即可
- 有亮点/突破/精彩瞬间 → 详细描述，AI会充分展开
- 不用担心字数多 → 家长更喜欢看到孩子的具体成长
---
@@ -143,14 +173,7 @@ AI生成 → 查看 → [全部发送]
教师查看 → [一键发送] → 【自动保存个人档案】 → 完成
```
### 流程对比
| 环节 | 优化前 | 优化后 |
|------|--------|--------|
| 生成速度 | 顺序生成 | 并行生成 |
| 确认次数 | 每人1次 | 批量1次 |
| 保存操作 | 手动双轨 | 自动保存 |
| 预计时间（8人） | 15-20分钟 | **3-5分钟** |
> 效率提升：8人课评从15-20分钟缩短至**3-5分钟**
---
@@ -182,12 +205,7 @@ AI生成 → 查看 → [全部发送]
| **班级周汇总** | `memory/class-evaluation-summary/第X周/{班级}.md` | 集中查看当周全班表现 |
| **个人历史课评** | `memory/student/{班级}/{学生名}/历史课评记录.md` | 追踪个人完整成长轨迹 |
### 自动保存规则
- ✅ **正式学生**：自动双轨保存（班级+个人）
- ⚠️ **补课学生**[补课]：先班级汇总，询问后决定是否建档
- 📌 **体验学生**[体验]：仅班级汇总，标记"体验"
- ❌ **缺课学生**[缺课]：仅记录"缺课"，不生成课评
> 学生类型处理规则详见 [33-first-class-rules.md](33-first-class-rules.md)
---
@@ -274,14 +292,4 @@ AI生成 → 查看质量报告 → [全部发送]
---
## 版本
| 版本 | 日期 | 更新内容 |
|-----|------|---------|
| **v3.0** | **2026-04-19** | **优化版**：新增速记符号、会话上下文、批量一键确认 |
| v2.0 | 2026-04-10 | 新增双轨保存说明 |
| v1.0 | 2026-03-25 | 初始版本 |
---
*记住：说人话就行，AI帮你处理格式！*

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

@@ -15,7 +15,7 @@
## 📱 整体风格定位
### 核心特点
- **表情丰富**：每个模块配1-2个表情符号
- **表情丰富**：每段末尾添加1-2个表情符号，总计**3个**
- **段落简短**：每段1-2句话，易于阅读
- **画面感强**：描述作品细节，让家长能想象出画面
- **三维度覆盖**：课程设计、学习表现、兴趣度
@@ -32,21 +32,24 @@
---
## 📝 三段式结构模板（覆盖五模块）
## 📝 三段式结构模板（覆盖五模块 - 字数弹性版）
| 模块 | 核心维度 | 字数 | 段落归属 |
|------|---------|------|:--------:|
| 课程主题+知识点 | **兴趣度** | 30-40字 | **第1段** |
| 课堂表现+掌握程度 | **学习表现** | 40-50字 | **第2段（长段落）** |
| 课程环节与目标达成 | **目标达成** | 40-50字 | **第2段（长段落）** |
| 成长亮点 | 成长发展 | 40-50字 | **第2段（长段落）** |
| 课后建议 | 延伸学习 | 30-40字 | **第3段** |
| 模块 | 核心维度 | 字数范围 | 段落归属 |
|------|---------|:--------:|:--------:|
| 课程主题+知识点 | **兴趣度** | 30-50字 | **第1段** |
| 课堂表现+掌握程度 | **学习表现** | 100-180字（弹性） | **第2段（长段落）** |
| 课程环节与目标达成 | **目标达成** | 整合于第2段 | **第2段（长段落）** |
| 成长亮点 | 成长发展 | 整合于第2段 | **第2段（长段落）** |
| 课后建议 | 延伸学习 | 30-50字 | **第3段** |
**段落控制**：全文控制在**3个段落**
- **第1段**：课程知识点（30-40字）- 介绍本节课核心知识/技能
- **第2段**：课堂细节长段落（100-130字）- 包含掌握程度、课程环节表现、成长亮点等详细描述，用1-2个emoji自然分隔
- **第3段**：课后建议（30-40字）- 家庭延伸活动建议
- **Emoji使用**：每段末尾添加1-2个emoji，幼儿版总计10-15个
- **第1段**：课程知识点（30-50字）- 介绍本节课核心知识/技能
- **第2段**：课堂细节长段落（100-180字，**根据输入丰富度灵活扩展**）- 包含掌握程度、课程环节表现、成长亮点等详细描述
- **精简版**：100-120字，输入简洁时使用
- **标准版**：130-160字，输入有具体细节时使用
- **详细版**：160-220字，输入有精彩瞬间或多个亮点时使用
- **第3段**：课后建议（30-50字）- 家庭延伸活动建议
- **Emoji使用**：每段末尾添加1-2个emoji，幼儿版总计3个
---
@@ -72,13 +75,14 @@
---
### 第2段：课堂细节长段落（100-130字）
### 第2段：课堂细节长段落（100-180字，根据内容丰富度灵活调整）
**写什么**：整合掌握程度、课程环节表现、成长亮点的详细描述
**写法**：
- 掌握程度：学生对该知识点的学习表现
- 课程环节：导入、探索、实践、分享各环节的状态
- 成长亮点：与之前相比的进步或突出表现
- **弹性原则**：当输入中有多个亮点或精彩瞬间时，**充分展开描述，不要压缩到100-130字**，可扩展到150-180字
**格式**：
```
@@ -94,13 +98,14 @@
---
### 第3段：课后建议（30-40字）
### 第3段：课后建议（30-50字）
**写什么**：家长可以在家配合的具体活动，巩固兴趣和学习成果
**写法**：
- 可操作：不说"多练习"，说具体玩法
- 关联课程：在家可以用积木重复今天的互锁结构
- 尊重家庭：用"可以试试看"而非"必须"
- **弹性原则**：当第2段非常详细时，建议部分也可适度扩展到40-50字，给出更具体的家庭活动建议
**格式**：
```
@@ -155,19 +160,38 @@
## ⚙️ 技术规范
### 字数控制
| 年龄段 | 目标字数 | 范围 |
|-------|:-------:|:----:|
| 托班（2.5-3岁）| 180字 | 160-200 |
| 小班（3-4岁）| 190字 | 170-210 |
| 中班（4-5岁）| 200字 | 180-220 |
| 大班（5-6岁）| 210字 | 190-230 |
### 字数控制（弹性范围）
| 输入类型 | 字数范围 | 适用场景 |
|:-------:|:-------:|:---------|
| **精简版** | 180-220字 | 输入简洁，仅包含基本行为描述 |
| **标准版** | 220-280字 | 输入有具体细节或1-2个亮点 |
| **详细版** | 280-320字 | 输入有精彩瞬间、多个亮点或特殊表现 |
**各年龄段参考**：
- 托班（2.5-3岁）：可适当减少20-30字
- 小班（3-4岁）：按标准范围
- 中班（4-5岁）：按标准范围
- 大班（5-6岁）：可适当增加10-20字
**判断标准**：
- **精简版**：输入简洁，仅包含基本行为描述（如"搭了3层，开心"）
- **标准版**：输入有具体细节或1-2个亮点（如"主动搭3层，自己调整，还帮助同伴"）
- **详细版**：输入有精彩瞬间、多个亮点或特殊表现（如"第一次主动帮助同伴，调试了三次才成功，最后说这是最喜欢的作品"）
### 表情数量
- **标准**：幼儿版3段式，每段1个emoji，**总计3个**
- **位置**：每段末尾1个
- **可选**：第2段长段落可用2个emoji自然分隔
### Emoji对应表
| 段落 | 内容 | Emoji |
|------|------|:-----:|
| 第1段 | 课程知识点 | 🔍 或 💡 |
| 第2段 | 课堂细节 | 💪 或 ✨ |
| 第3段 | 课后建议 | 🏠 |
### 段落长度
- **每段**：1-3句话
- **每句**：不超过15字
@@ -189,13 +213,14 @@
- [ ] 语气恰当，无其他学生负面信息
### 学龄前版专项检查
- [ ] 字数180-220字（符合年龄段）
- [ ] 字数符合弹性范围（精简版180-220字/标准版220-280字/详细版280-320字，根据输入内容丰富度）
- [ ] **3段式结构**（第1段知识点、第2段课堂细节、第3段课后建议）
- [ ] 每段末尾有1个emoji（总计3个）
- [ ] 每段末尾有1-2个emoji（**总计3个**）
- [ ] 称呼正确（小名>去姓>叠字>全名）
- [ ] 无"第几周"字样
- [ ] 语气温暖亲切，有画面感
- [ ] 建议具体可操作
- [ ] **第2段充分展现输入中的精彩瞬间**（不压缩丰富内容）
---
@@ -203,15 +228,9 @@
| 维度 | 学龄前版（本文件）| 小学版 |
|------|------------------|--------|
| **表情** | 3-6个（每段1-2个），温暖活泼 | 5个（每段1个），简洁专业 |
| **表情** | 3个（每段1个，第2段可选2个），温暖活泼 | 3个（每段1个），简洁专业 |
| **段落** | **3段**（第1段知识点、第2段课堂细节、第3段课后建议）| 3段，结构化 |
| **语气** | 亲切温暖，画面感 | 尊重平等，专业 |
| **字数** | 180-220字 | 190-230/200-240字 |
| **信息密度** | 第2段为长段落，整合多模块内容 | 模块清晰，分点呈现 |
| **字数** | 弹性范围180-320字 | 弹性范围190-350字 |
| **信息密度** | 第2段为长段落，根据输入丰富度灵活扩展 | 结构化呈现，根据输入灵活扩展 |
| **emoji位置** | 每段末尾 | 每段末尾 |
---
*版本：v1.0*
*创建日期：2026-03-26*
*适用：2.5-6岁幼儿课程*

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

@@ -18,26 +18,16 @@
- **视觉分隔**：用图标、符号、线条区分内容
- **数据支撑**：适当用量表、进度条展示能力
- **专业简洁**：避免纯文本堆叠，用列表和表格
- **适度Emoji**：每段末尾添加1个专业emoji，总计5个
- **适度Emoji**：每段末尾添加1个专业emoji，总计**3个**
- **称呼规范**：优先使用小名/昵称，其次去姓称名（如"昕乔"），平等尊重学生
### Emoji使用规则（小学版）
**小学低年级**（6-8岁，Kitten/SPIKE）：
- **模块1**（课程知识点）：💡 或 📚
- **模块2**（掌握程度）：✓ 或 ⚡
- **模块3**（课程环节与目标达成）：🎯 或 ✅
- **模块4**（成长亮点）：📈 或 💪
- **模块5**（课后建议）：🏠 或 🔧
**小学高年级**（8-10岁，机器人/AI）：
- **模块1**（课程知识点）：⚙️ 或 🤖
- **模块2**（掌握程度）：📊 或 ⚡
- **模块3**（课程环节与目标达成）：🎯 或 ✅
- **模块4**（成长亮点）：📈 或 🚀
- **模块5**（课后建议）：🏠 或 🔧
> 注：小学版每段末尾仅1个emoji，保持简洁专业感
| 段落 | 内容 | Emoji |
|------|------|:-----:|
| 第1段 | 课程知识点 +掌握程度 | 💡 或 📚（低年级）/ ⚙️ 或 🤖（高年级）|
| 第2段 | 课堂细节 +成长亮点 | 📈 或 💪 |
| 第3段 | 课后建议 | 🏠 或 🔧 |
### 排版样式
```
@@ -514,12 +504,24 @@ Prompt编写的基本概念理解了，能写出简单指令让AI执行。复杂
## ⚙️ 技术规范
### 字数控制
| 年级 | 目标字数 | 结构化后等效 |
|-----|:-------:|:-----------:|
| 一年级（6-7岁）| 190-230 | 220-250 |
| 二年级（7-8岁）| 200-240 | 230-260 |
| 四年级（9-10岁）| 220-280 | 260-300 |
### 字数控制（弹性范围）
| 输入类型 | 字数范围 | 适用场景 |
|:-------:|:-------:|:---------|
| **精简版** | 190-230字 | 输入简洁，仅包含基本行为描述 |
| **标准版** | 230-280字 | 输入有具体细节或1-2个亮点 |
| **详细版** | 280-350字 | 输入有精彩瞬间、多个亮点或特殊表现 |
**各年级参考**：
- 一年级（6-7岁）：按标准范围下限
- 二年级（7-8岁）：按标准范围
- 四年级（9-10岁）：按标准范围上限，详细版可至350字
**触发详细版的信号**（同幼儿版）：
- "特别棒的是"、"让我惊讶的是"、"第一次主动"
- 输入中包含3个以上独立行为描述
- 有技术细节、调试过程、错误排查等详细描述
- 情感丰富、社交互动、创造性表现
### 纯文本段落版（3段式，带Emoji）
@@ -541,11 +543,14 @@ Prompt编写的基本概念理解了，能写出简单指令让AI执行。复杂
- **进度条/量表**：3-5个
- **列表项**：6-10个
### 段落结构
### 段落结构（弹性字数）
- **总段落数**：**3段**（与幼儿版统一）
- **第1段**：课程知识点（35-45字）
- **第2段**：课堂细节长段落（100-140字），整合掌握程度、课程环节、成长亮点
- **第3段**：课后建议（35-45字）
- **第1段**：课程知识点（35-55字，根据输入灵活调整）
- **第2段**：课堂细节长段落（100-220字，**核心段落，根据输入丰富度灵活扩展**）
- 精简版：100-130字，输入简洁
- 标准版：130-170字，输入有具体细节
- 详细版：170-220字，输入有精彩瞬间或多个亮点
- **第3段**：课后建议（35-55字）
- **Emoji**：每段末尾1个，总计3个
---
@@ -558,14 +563,15 @@ Prompt编写的基本概念理解了，能写出简单指令让AI执行。复杂
- [ ] 语气恰当，无其他学生负面信息
### 小学版专项检查
- [ ] 字数符合弹性范围（根据输入丰富度自动调整）
- [ ] 使用了结构化的视觉分隔（线条、图标）
- [ ] 使用了量表或进度条展示能力
- [ ] 详细反馈分模块呈现
- [ ] 有能力维度评估
- [ ] 课后任务使用清单格式
- [ ] 字数符合年级要求（190-300字）
- [ ] 无大段纯文字堆砌
- [ ] 语气专业且易懂
- [ ] **第2段充分展现输入中的精彩瞬间**（不压缩丰富内容）
---
@@ -577,11 +583,5 @@ Prompt编写的基本概念理解了，能写出简单指令让AI执行。复杂
| **结构** | **3段式**（知识点+课堂细节+建议）| **3段式**（知识点+课堂细节+建议）|
| **段落** | 第2段为长段落，整合多模块 | 第2段为长段落，整合多模块 |
| **语气** | 尊重专业，数据支撑 | 温暖亲切，画面感 |
| **字数** | 190-240字 | 180-220字 |
| **信息密度** | 高（技术细节）| 低（故事化）|
---
*版本：v1.0*
*创建日期：2026-03-26*
*适用：6-10岁小学课程*
| **字数** | 弹性范围190-350字 | 弹性范围180-320字 |
| **信息密度** | 高（技术细节），根据输入灵活扩展 | 低（故事化），根据输入灵活扩展 |