Initial commit: 课评反馈系统 v1.0

.claude/rules/30-input-format.md

@@ -0,0 +1,463 @@
+# 快捷输入格式规则 v3.0
+
+> 支持更灵活的输入方式，适应课后快速记录场景
+
+---
+
+## 🎯 输入原则（新版）
+
+**极简输入，AI智能理解**
+- 教师只需提供**关键词**和**关键事实**
+- AI自动理解语境、补充细节、规整格式
+- 支持**口语化、碎片化、无序化**输入
+- 接受**语音转文字、手写速记、随手记录**
+- **自动纠正谐音姓名**（如"良心桥"→"梁昕乔"）
+
+**核心目标**：让教师以最自然的方式记录，AI负责后续整理
+
+---
+
+## 🔊 语音输入特别说明
+
+### 谐音姓名自动纠正
+
+**问题**：语音输入时姓名可能被识别为谐音
+- "梁昕乔" → "良心桥"、"亮新巧"
+- "钟昀昊" → "中云浩"、"钟运好"
+- "张宇" → "章鱼"、"张瑜"
+
+**解决**：AI自动匹配班级学生名单进行纠正
+- 高相似度（>90%）：自动纠正，不打扰
+- 中相似度（70-90%）：生成前提示确认
+- 低相似度（<70%）：要求重新输入
+
+**示例**：
+```
+教师语音输入："良心桥今天搭了三层"
+AI处理：
+  1. 识别疑似姓名"良心桥"
+  2. 匹配班级名单：梁昕乔（相似度100%）
+  3. 自动纠正为"梁昕乔"
+  4. 查询画像小名："乔乔"
+  5. 课评输出："乔乔今天搭了三层..."
+```
+
+---
+
+## ✨ 支持的输入方式
+
+### 方式1：极简一句话（最自由）
+
+**特点**：任意格式，AI自动解析
+
+**示例1**：口语化
+```
+小明今天开始不敢碰，后来主动搭了三层，球卡住自己调高度，挺稳定的，比上周主动多了
+```
+
+**示例2**：碎片化
+```
+梁昕乔 快速启动 搭3层 自己加装饰 情绪好 创意突出
+```
+
+**示例3**：无序关键词
+```
+观望5分钟，主动尝试，自己调整，情绪稳定，比上周好，小明
+```
+
+**示例4**：语音转文字风格
+```
+呃...钟昀昊啊，今天上课啊，就是慢热，观察了一会儿才开始，然后搭了三层，反复调整，情绪挺稳定的
+```
+
+---
+
+### 方式2：自然对话式（推荐）
+
+**特点**：像和同事聊天一样描述
+
+**示例**：
+```
+今天梁昕乔表现挺好的，一上课就进入状态了，搭了3层还自己加了装饰，情绪很开心，和之前一样主动
+
+钟昀昊呢，还是老样子，慢热型，观察了5分钟才开始，不过后来搭得挺稳的，反复调整了几遍，最后完成了
+```
+
+**AI自动识别**：
+- 学生姓名（梁昕乔、钟昀昊）
+- 关键行为（快速启动、搭3层、加装饰）
+- 情绪状态（开心、稳定）
+- 对比信息（和之前一样）
+
+---
+
+### 方式3：列表速记（半结构化）
+
+**特点**：无序列表，无需严格格式
+
+**示例1**：简单列表
+```
+- 小明
+- 开始不敢碰管道
+- 后来主动搭3层
+- 球卡住自己调整
+- 情绪稳定
+- 比上周进步
+```
+
+**示例2**：混合关键词
+```
+小明：观望→主动→3层→调整，稳定，比上周好
+
+小红：全程专注，5层+弯管，开心，帮助旁边人
+
+小强：换玩法多，没完成，兴奋转烦躁，需引导
+```
+
+---
+
+### 方式4：表格简化版（批量）
+
+**特点**：极简表格，不要求对齐
+
+**示例**：
+```
+小明 观望5分钟 搭3层 自己调 稳定 比上周好
+小红 全程专注 5层加弯管 开心 帮助人
+小强 换玩法 没完成 烦躁 需引导
+豆豆 独自玩球 没搭 开心 社交需引导
+```
+
+**AI自动转换**为规整表格
+
+---
+
+### 方式5：分段描述（详细）
+
+**特点**：按时间/环节分段，自由描述
+
+**示例**：
+```
+【小明】
+导入阶段：坐着看其他小朋友玩
+探索阶段：第6分钟开始尝试
+搭建阶段：能搭3层直管
+调整阶段：球卡住自己调高度
+情绪：整体稳定
+亮点：比上周主动多了
+```
+
+---
+
+### 方式6：极简符号速记（专业用户）
+
+**特点**：用符号快速编码
+
+**符号对照**：
+```
+→ 表示行为发展/时间线
++ 表示正面/进步
+- 表示需关注/问题
+↑ 表示情绪积极
+↓ 表示情绪消极
+? 表示疑问/不确定
+! 表示亮点/惊喜
+```
+
+**示例**：
+```
+小明：观望5m → 主动3层 → 自调 ↑ + 比上周!
+小红：专注全程 → 5层+弯管 ↑↑ + 助人!
+小强：频换玩法 → 未完成 ↓ 需引导
+```
+
+---
+
+## 🔍 AI智能解析规则
+
+### 自动识别要素
+
+| 要素 | AI识别方式 | 示例 |
+|------|-----------|------|
+| **学生姓名** | 首词/大写/冒号前 | "小明"、"梁昕乔" |
+| **关键行为** | 动词+数量/结果 | "搭3层"、"自己调" |
+| **情绪状态** | 情绪词/表情描述 | "开心"、"稳定"、"烦躁" |
+| **对比信息** | 时间词+比较 | "比上周"、"和之前" |
+| **课程信息** | 上下文/历史记录 | 自动推断 |
+
+### 模糊匹配
+
+**行为词模糊匹配**：
+| 教师输入 | AI理解 | 标准输出 |
+|---------|-------|---------|
+| 不敢碰/不敢动/犹豫 | 观望型 | "开始有些犹豫" |
+| 主动/积极/马上 | 主动型 | "主动尝试" |
+| 自己弄/自己搞/自己调 | 自主解决 | "自己调整" |
+| 搭了3层/做了三层/堆了3个 | 完成3层 | "搭了3层" |
+
+**情绪词模糊匹配**：
+| 教师输入 | AI理解 |
+|---------|-------|
+| 开心/高兴/笑/兴奋 | 积极情绪 |
+| 稳定/平静/正常 | 平稳情绪 |
+| 低落/不开心/烦躁 | 消极情绪 |
+| 先好后差/开始可以后来不行 | 情绪波动 |
+
+---
+
+## 💡 输入优化建议
+
+### 最少有效信息
+
+只需提供：
+1. **学生姓名**（必须）
+2. **一个关键行为**（必须）
+
+AI会自动：
+- 匹配课程信息
+- 推断情绪状态
+- 对比历史表现
+- 生成完整课评
+
+**极简示例**：
+```
+小明：主动搭了3层
+```
+
+AI输出：
+```
+小明今天学习了互锁结构，能主动尝试并搭了3层...
+[基于画像的完整课评]
+```
+
+### 推荐信息量
+
+| 场景 | 建议输入 | 效果 |
+|------|---------|------|
+| **最省时间** | 姓名+1个行为 | 自动生成 |
+| **常规记录** | 姓名+2-3个行为+情绪 | 个性化强 |
+| **重点关注** | 姓名+详细表现+对比 | 深度定制 |
+
+---
+
+## 🚫 不推荐的输入方式
+
+虽然系统会尽力理解，但以下方式可能影响质量：
+
+| 不推荐 | 原因 | 建议替代 |
+|-------|------|---------|
+| 纯数字代码 | 无上下文 | 加姓名或关键词 |
+| 过于省略 | 信息不足 | 至少一个行为 |
+| 完全乱序 | 难以解析 | 大致按时间顺序 |
+| 错别字过多 | 理解困难 | 常用拼音即可 |
+
+---
+
+## 🔄 输入示例大全
+
+### 示例1：口语化输入（推荐）
+
+**教师输入**：
+```
+呃，小明啊，今天上课一开始不敢碰，就坐着看，后来我看他开始动了，搭了大概三层吧，然后那个球卡住了，他就自己调了一下高度，情绪还挺稳定的，比上周好一些，上周是完全不敢碰的
+```
+
+**AI解析结果**：
+- 学生：小明
+- 行为：观望→主动搭3层→自己调整
+- 情绪：稳定
+- 对比：比上周进步（上周完全不敢碰）
+
+---
+
+### 示例2：碎片化输入
+
+**教师输入**：
+```
+梁昕乔 快速启动 3层 加装饰 开心 和之前一样
+```
+
+**AI解析结果**：
+- 学生：梁昕乔
+- 行为：快速启动→搭3层→加装饰
+- 情绪：开心
+- 对比：和之前一样
+
+---
+
+### 示例3：无序关键词
+
+**教师输入**：
+```
+稳定，自己调整，观望5分钟，主动尝试，比上周好，小明
+```
+
+**AI解析结果**：
+- 学生：小明
+- 行为：观望5分钟→主动尝试→自己调整
+- 情绪：稳定
+- 对比：比上周好
+
+---
+
+### 示例4：批量简化
+
+**教师输入**：
+```
+周四19点 DISC-003
+
+小明 观望5分 搭3层 自调 稳定 比上周好
+昕乔 快速 3层 加装饰 开心 一样
+昀昊 慢热 3层 反复调 稳定 渐入佳境
+```
+
+**AI解析结果**：
+自动识别为批量模式，生成3份课评
+
+---
+
+### 示例5：详细描述
+
+**教师输入**：
+```
+【李怡瞳】四年级 AI03
+今天学Prompt编写
+开始比较慢，观察别人
+后来能写简单指令
+遇到困难主动问
+情绪平和
+初学阶段正常
+```
+
+**AI解析结果**：
+- 学生：李怡瞳
+- 年级：四年级
+- 课程：AI03
+- 行为：观察→写简单指令→主动求助
+- 情绪：平和
+- 状态：初学阶段
+
+---
+
+## 📝 输入模板速查
+
+### 模板1：最简版
+```
+[姓名]：[一个行为]
+```
+
+### 模板2：常规版
+```
+[姓名]：[行为1]，[行为2]，[情绪]，[对比]
+```
+
+### 模板3：自然版
+```
+今天[姓名][表现描述]，[情绪]，[对比]
+```
+
+### 模板4：批量版
+```
+课程：[代码]
+[姓名1] [表现1] [情绪1]
+[姓名2] [表现2] [情绪2]
+```
+
+---
+
+## 🎯 与旧版对比
+
+| 维度 | 旧版（v2.0）| 新版（v3.0）|
+|------|------------|------------|
+| **格式要求** | 较严格 | 非常灵活 |
+| **输入方式** | 5种固定格式 | 任意自然语言 |
+| **口语支持** | 有限 | 完全支持 |
+| **容错性** | 中 | 高 |
+| **智能解析** | 关键词匹配 | AI语义理解 |
+| **推荐场景** | 规范记录 | 快速随手记 |
+
+---
+
+## ✅ 使用建议
+
+### 不同场景推荐输入方式
+
+| 场景 | 推荐方式 | 示例 |
+|------|---------|------|
+| **边走边记** | 极简一句话 | "小明搭3层自己调" |
+| **语音输入** | 自然对话式 | "小明今天表现很好..." |
+| **课后整理** | 列表速记 | "- 小明 - 搭3层 - 开心" |
+| **批量生成** | 简化表格 | "小明 搭3层 开心" |
+| **重点关注** | 分段描述 | "【小明】导入...探索..." |
+
+### 黄金法则
+
+1. **有姓名** → AI知道是谁
+2. **有行为** → AI知道做了什么
+3. **其他随意** → AI自动补充
+
+**记住**：没有固定格式，说人话就行！
+
+---
+
+## 📦 存储位置（双轨制）
+
+> **新增**：确认后同时保存到两个位置
+
+| 存储位置 | 用途 | 文件路径 |
+|---------|------|---------|
+| **班级周汇总** | 集中查看当周全班表现 | `memory/class-evaluation-summary/第X周/{班级}.md` |
+| **个人历史课评** | 追踪学生完整成长轨迹 | `memory/student/{班级}/{学生名}/历史课评记录.md` |
+
+### 数据流转
+
+```
+教师输入 → AI生成 → 【等待确认】 → 确认后双轨保存
+                                      ↓
+                          ┌──────────┴──────────┐
+                          ↓                     ↓
+                 班级周汇总.md              个人历史课评.md
+```
+
+### 使用场景
+
+- **班级周汇总**：周回顾、备课参考、批量发送家长群
+- **个人历史课评**：一对一家长沟通、学期总结、成长档案
+
+---
+
+## 📞 常见问题
+
+### Q：我写得乱，AI能懂吗？
+**A**：能！只要包含姓名和关键行为，AI会自动理解并规整。
+
+### Q：语音转文字很多错别字怎么办？
+**A**：没关系，AI能根据上下文推断。关键是发音清晰的动词和名词。
+
+### Q：忘记写课程信息怎么办？
+**A**：AI会从历史记录或上下文中自动推断。
+
+### Q：批量输入需要严格对齐吗？
+**A**：不需要！用空格或制表符分隔即可，AI会自动整理。
+
+### Q：补课/体验学生怎么处理？
+**A**：详见 [33-first-class-rules.md](33-first-class-rules.md) 新学生与补课学生处理规则。
+
+### Q：体验课学生不想建档怎么办？
+**A**：直接回复「跳过」或「仅保存到班级汇总」。课评会保存在 `class-evaluation-summary/第X周/{班级}.md` 中，标记为体验学生，不影响后续正式学员的档案管理。
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 更新内容 |
+|-----|------|---------|
+| v3.2 | 2026-04-16 | **新增补课/体验学生处理说明**：说明无档案学生的检测、提醒和可选保存方式 |
+| v3.1 | 2026-04-15 | **新增双轨存储说明**：确认后同时保存到班级周汇总和个人历史课评，便于集中查看和追踪成长 |
+| v3.0 | 2026-03-26 | 大幅增强格式包容性，支持任意自然语言输入 |
+| v2.0 | 2026-03-26 | 新增单个/批量生成方式 |
+| v1.0 | 2026-03-25 | 初始版本，5种固定格式 |
+
+---
+
+*新版本核心理念：用最自然的方式记录，让AI处理格式*