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

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帮你处理格式！*