初始化课评系统仓库:包含规则配置、学生档案、课程教案、班级汇总

This commit is contained in:
qiuyan
2026-05-08 14:15:00 +08:00
commit 16af260a11
300 changed files with 30338 additions and 0 deletions

View File

@@ -0,0 +1,309 @@
# 课评生成快速入门指南 v2.5(旧版本)
> ⚠️ **注意**:本文档为 v2.5 旧版本归档文件,描述的是"生成-确认-保存"两阶段流程。
> 当前系统已升级为 v3.1 "生成即双轨保存"模式,详见 [20-workflow.md](../20-workflow.md) 第7节和第10节。
>
> **最新快速入门请直接查看**`CLAUDE.md` → "快捷输入速查"章节
---
## 🚀 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会充分展开
- 不用担心字数多 → 家长更喜欢看到孩子的具体成长
---
## 🔄 旧流程:生成 → 确认 → 保存v2.5 及之前版本)
```
教师输入 → AI自动生成 → 【自动保存班级汇总】 → 展示给教师
教师查看 → [一键发送] → 【自动保存个人档案】 → 完成
```
> **v3.1 更新**:现已简化为"生成即双轨保存",无需确认步骤。详见 [20-workflow.md](../20-workflow.md)。
---
## 📊 批量生成界面预览
```
━━━━━━━━━━━━━━━━━━━━━━━
📊 批量生成完成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)
### 跨班级补课说明
**场景**学生档案在A班如"发现世界-周四19点"来B班如"发现世界-周六09点")补课
**处理方式**
- 如果教师选择"跨班级保存",课评将同时保存到:
- B班补课班级的周汇总
- A班原班级的个人历史课评记录.md标注跨班级补课信息
- 这样可以在原班级追踪学生的完整成长轨迹
---
## 💡 进阶技巧
### 技巧1会话上下文
**首次指定班级后,后续无需重复**
```
/课评 班级:发现世界-周四19点 # 只需一次
# 后续直接输入
乔乔搭3层开心
昊昊:慢热,稳定
```
### 技巧2语音快速录入
```
语音:"呃...乔乔啊...观望了5分钟...主动搭3层..."
AI自动解析为乔乔gj5→zd3→zt
```
### 技巧3混合输入
```
# 同一批输入中混合使用自然语言和速记
乔乔今天表现很好搭了3层还自己调整开心
昊昊慢热→zd3→反复调 →
张小明[体验]:积极参与
```
---
## ❓ 常见问题速答
**Q速记符号记不住怎么办**
A不用记直接用自然语言描述AI一样能理解。
**Q忘记打标记会怎样**
AAI会自动检测档案。在当前班级有档案=正式学生;在其他班级有档案=跨班级补课(询问处理方式);无档案=提示选择[补课]/[体验]。
**Q跨班级补课学生如何保存**
A如果学生档案在A班来B班补课可以选择①仅保存到B班班级汇总②同时追加到A班个人档案推荐可追踪完整轨迹
**Q批量生成后发现有错误怎么办**
A点击[标记修改]指出修改意见AI会重新生成该学生课评。
**Q课评生成后可以修改吗**
A可以发送前都可以修改。发送后如需修改可手动编辑文件。
**Q体验课学生后续转正式了怎么办**
A输入`转为正式`AI会为该学生建立档案后续课评正常双轨保存。
---
## 🎯 推荐工作流程
### 课后5分钟快速流程
```
Step 11分钟: 指定班级
/课评 班级:发现世界-周四19点
Step 22分钟: 速记输入
乔乔gj5→zd3→zt ↑++
昊昊慢热→zd3→反复调 →
小明[体验]zd3 ↑
小红[补课]:专注完成 →
Step 32分钟: 查看并一键发送
AI生成 → 查看质量报告 → [全部发送]
完成8份课评已自动保存。
```
---
## 📞 支持
- **完整规则**:参见 `.claude/rules/` 目录
- **速记符号表**:参见 `30-input-format.md`
- **批量生成规则**:参见 `32-batch-generation.md`
---
*记住说人话就行AI帮你处理格式*