Files
ClassFeedback/.claude/rules/30-input-format.md
小Q(李秋燕) 4810387dab 优化课评系统:新增速记符号、状态面板、快速编辑功能
- 新增36-shorthand-learning.md:速记符号阶梯学习指南
- 新增37-status-panel.md:课评状态管理面板
- 新增38-quick-edit.md:快速编辑功能规则
- 新增班级学期总览模板和成长时间线模板
- 更新多条规则文件优化课评生成流程
- 补充第7周班级汇总和学生档案数据
2026-04-19 19:24:09 +08:00

260 lines
6.5 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层→反复调整
情绪:稳定
```
### 示例3批量混合标记
```
输入:
周四19点 DISC-007
乔乔gj5→zd3→zt ↑++
昊昊慢热→zd3→反复调 →
张小明[体验]搭了3层开心
```
---
## 📦 存储流程(优化后)
```
教师输入 → AI解析 → 预加载档案 → 生成课评 → 自动保存班级汇总 → 展示给教师
教师确认/修改 ← 一键发送 ← 自动保存个人档案 ← 教师点击发送
```
### 自动保存规则
| 学生类型 | 班级周汇总 | 个人档案 | 教师操作 |
|----------|-----------|----------|----------|
| 正式学生 | ✅ 自动保存 | ✅ 确认后保存 | 查看→发送 |
| [补课] | ✅ 自动保存 | ❓ 询问后决定 | 查看→选择→发送 |
| [体验] | ✅ 自动保存(标记) | ❌ 不保存 | 查看→发送 |
| [缺课] | ✅ 记录缺席 | ❌ 不生成 | 无 |
---
## 📞 常见问题
**Q速记符号记不住怎么办**
A不用记直接用自然语言描述AI一样能理解。速记是给熟练用户的可选提速方式。
**Q忘记打标记怎么办**
AAI会检测档案自动判断。有档案=正式学生,无档案=提示选择[补课]/[体验]。
**Q标记可以组合吗**
A可以`张小明[体验][new]`表示体验课新学生。
**Q上下文记忆持续多久**
A一次会话内有效。换班级时重新指定即可。
---
## 版本历史
| 版本 | 日期 | 更新内容 |
|-----|------|---------|
| **v4.0** | **2026-04-19** | **优化版**:新增速记符号系统、标记驱动处理、会话上下文记忆 |
| v3.2 | 2026-04-16 | 新增补课/体验学生处理说明 |
| v3.0 | 2026-03-26 | 大幅增强格式包容性,支持任意自然语言输入 |
---
*核心理念用最自然的方式记录让AI处理格式*