Files
ClassFeedback/.claude/rules/30-input-format.md
小Q(李秋燕) dcf1049b92 优化课评系统:新增速记符号、状态面板、快速编辑功能
- 新增36-shorthand-learning.md:速记符号阶梯学习指南
- 新增37-status-panel.md:课评状态管理面板
- 新增38-quick-edit.md:快速编辑功能规则
- 更新40-keping-快速入门.md:优化快速入门指南v3.0
- 新增CHANGELOG.md:版本变更日志
- 更新第7周、第8周班级汇总文件
- 规范化学生档案存储
- 完善补课/体验学生处理逻辑
2026-04-25 20:56:12 +08:00

317 lines
8.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 快捷输入格式规则 v4.0(优化版)
> 核心理念:**说人话就行**AI自动理解语境、补充细节、规整格式
>
> 本次优化:新增速记符号系统、标记驱动处理、会话上下文记忆
---
## 🎯 黄金法则
1. **有姓名** → AI知道是谁
2. **有行为** → AI知道做了什么
3. **其他随意** → AI自动补充
**支持**:口语化、碎片化、无序化、语音转文字
---
## ⚡ 速记符号系统(新增)
### 行为速记
| 速记 | 全称 | 使用场景 |
|------|------|----------|
| `gj` | 观望 | `gj5` = 观望5分钟 |
| `zd` | 主动 | `zd3` = 主动搭3层 |
| `zt` | 自己调整 | 球卡住时自己调整 |
| `wb` | 完成 | 独立完成搭建 |
| `mr` | 融入 | 融入小组活动 |
| `zx` | 专注 | 专注完成任务 |
| `sb` | 失败→调整 | 失败后调整再尝试 |
### 情绪速记
| 速记 | 含义 | 示例 |
|------|------|------|
| `↑` / `kx` | 开心/积极 | 情绪↑ 或 kx |
| `→` / `wd` | 稳定/平和 | 情绪→ 或 wd |
| `↓` / `fd` | 烦躁/低落 | 情绪↓ 或 fd |
| `~` / `bd` | 波动 | 情绪~ 或 bd |
### 对比速记
| 速记 | 含义 | 示例 |
|------|------|------|
| `++` / `!` | 比上周进步 | 比上周++ |
| `=` / `0` | 和之前一样 | 和之前= |
| `--` / `?` | 需关注 | 需-- |
| `new` | 新学生/首次 | 标记首次上课 |
### 速记组合示例
```
输入: 乔乔gj5→zd3→zt ↑++
展开: 乔乔观望5分钟后主动搭3层自己调整开心比上周进步
输入: 昊昊慢热→zd3→反复调 →
展开: 昊昊慢热主动搭3层反复调整情绪稳定
输入: 小强:频换玩法 wb↓--
展开: 小强频繁换玩法,未完成,情绪烦躁,需关注
```
---
## 🏷️ 标记驱动处理(新增)
**使用标记快速指定学生类型,无需中断流程**
| 标记 | 含义 | 处理方式 | 保存位置 |
|------|------|----------|----------|
| 无标记 | 正式学生 | 双轨保存 | 班级汇总+个人档案 |
| `[补课]` | 补课学生 | 询问是否建档 | 先班级汇总 |
| `[体验]` | 体验课学生 | 仅班级汇总 | 班级汇总(标记体验) |
| `[缺课]` | 今天缺席 | 记录缺席 | 班级汇总(标记缺课) |
| `[new]` | 新学生首次 | 创建档案 | 双轨保存 |
### 标记使用示例
```
批量输入示例:
周四19点 DISC-007
乔乔gj5→zd3→zt ↑++
昊昊慢热→zd3→反复调 →
张小明[体验]搭了3层开心
李小红[补课]:专注完成,稳定
```
**AI自动处理**
- 乔乔、昊昊:双轨保存
- 张小明[体验]:仅保存到班级汇总,不询问
- 李小红[补课]:生成后询问是否建档
---
## ✨ 自然语言输入(推荐)
### 方式1极简一句话
```
乔乔今天开始不敢碰,后来主动搭了三层,球卡住自己调高度,挺稳定的,比上周主动多了
昊昊还是老样子慢热型观察了5分钟才开始不过后来搭得挺稳的反复调整了几遍
```
### 方式2关键词速记
```
乔乔gj5→zd3→zt ↑++
昊昊慢热→zd3→反复调 →
小强:频换玩法 wb↓--
```
### 方式3会话上下文新增
**首次指定班级后,后续无需重复**
```
/课评 班级:发现世界-周四19点 # 只需一次
# 后续直接输入学生表现
乔乔搭3层开心
昊昊:慢热,稳定
```
---
## 🔊 语音输入优化
### 谐音自动纠正
AI自动匹配班级学生名单实时纠正
- "良心桥" → "梁昕乔"
- "中云浩" → "钟昀昊"
- "李一同" → "李怡瞳"
### 语音速记混合
```
语音输入:"呃...乔乔啊...观望了5分钟...主动搭3层...自己调整...开心"
AI解析
学生:乔乔(匹配小名)
行为gj5→zd3→zt
情绪:↑
```
---
## 📊 批量输入格式
### 列表式(推荐)
```
课程DISC-007
班级:发现世界-周四19点
1. 乔乔gj5→zd3→zt ↑++
2. 昊昊慢热→zd3→反复调 →
3. 张小明[体验]搭3层开心
4. 李小红[补课]:专注完成,稳定
```
### 简化表格式
```
乔乔 gj5→zd3→zt ↑ ++
昊昊 慢热→zd3→反复调 → 渐入佳境
小明[体验] 搭3层 ↑ 积极参与
```
---
## 🔄 输入示例大全
### 示例1极简速记
```
输入乔乔gj5→zd3→zt ↑++
AI解析
学生:乔乔(小名)
行为观望5分钟→主动搭3层→自己调整
情绪:开心
对比:比上周进步
```
### 示例2语音风格
```
输入:呃,昊昊啊,今天上课啊,就是慢热,观察了一会儿才开始,然后搭了三层,反复调整,情绪挺稳定的
AI解析
学生:昊昊
行为观望→搭3层→反复调整
情绪:稳定
输出字数约200字精简版
```
### 示例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批量混合标记
```
输入:
周四19点 DISC-007
乔乔gj5→zd3→zt ↑++
昊昊慢热→zd3→反复调 →
张小明[体验]搭了3层开心
```
---
## 📦 存储规则
存储流程和学生类型处理规则详见 [CLAUDE.md 存储双轨制](../../CLAUDE.md) 和 [33-first-class-rules.md](33-first-class-rules.md)。
**简要说明**
- 正式学生:双轨保存(班级汇总 + 个人档案)
- `[补课]`学生:检查档案 → 存在则双轨,不存在则询问
- `[体验]`学生:仅班级汇总
- `[缺课]`学生:仅记录缺席
### ⚠️ 重要:课评正文禁止提及补课
**无论学生是否标记为`[补课]`,课评正文中绝对不能提及补课相关内容**
- ❌ 禁止出现"补课"、"补课上"、"来补课"、"本次补课"等词汇
- ❌ 禁止暗示学生非正常上课(如"今天特别来参加"、"临时加入"、"从其他班级过来"等)
- ❌ 禁止在课评正文中区分"本班学生"和"补课学生"
**正确处理**
-`[补课]`标记**仅用于后台档案管理**,课评正文**完全按正常学生**撰写
- ✅ 课评开头直接写"XX本节课学习了..."**不加任何特殊说明**
- ✅ 补课信息仅保存在班级汇总元数据中,不进入课评正文
**示例**
```
教师输入:李小红[补课]搭了3层专注完成
课评输出(正确):
小红本节课学习了"旋转飞机",认识了游乐园旋转设施的中心轴结构...
课评输出(错误):
小红本节课作为补课学生,学习了"旋转飞机"... ❌(禁止提及补课)
小红今天来补课,学习了"旋转飞机"... ❌(禁止提及补课)
```
---
## 📞 常见问题
**Q速记符号记不住怎么办**
A不用记直接用自然语言描述AI一样能理解。速记是给熟练用户的可选提速方式。
**Q忘记打标记怎么办**
AAI会检测档案自动判断。有档案=正式学生,无档案=提示选择[补课]/[体验]。
**Q标记可以组合吗**
A可以`张小明[体验][new]`表示体验课新学生。
**Q上下文记忆持续多久**
A一次会话内有效。换班级时重新指定即可。
---
*核心理念用最自然的方式记录让AI处理格式*