079a09d743
- 将20+个独立规则合并为9个核心规则（00/10/15/20/21/22/30/50/51） - 旧规则移入90-archive并标注已合并，请勿直接引用 - 拆分新增：21-shorthand.md（速记符号）、22-student-mgmt.md（补课/新学生/转正） - 升级keping-advanced skill配置：v2.1 → v2.2（自动双轨保存、三段式结构、字数弹性180-350） - 删除旧skill文件（keping.json、速查卡、使用指南）和CHANGELOG.md - 删除各周多余的独立出勤统计文件（出勤已嵌入班级汇总） - SPIKE02班级文件夹名称规范化（去除特殊字符） - 将学生模板文件移入memory/student/模板/子目录 - 将fix_config.py移入src/，删除根目录test123.txt测试文件 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
427 lines
14 KiB
Markdown
427 lines
14 KiB
Markdown
> ⚠️ **本文件已归档**：内容已合并至核心规则文件，此处仅作历史备份。请勿直接引用本文件，请使用 `.claude/rules/` 下的核心规则。
|
||
|
||
# 快捷输入格式规则 v4.0（优化版）
|
||
|
||
> 核心理念：**说人话就行**，AI自动理解语境、补充细节、规整格式
|
||
>
|
||
> 本次优化：新增速记符号系统、标记驱动处理、会话上下文记忆
|
||
|
||
---
|
||
|
||
## 🎯 黄金法则
|
||
|
||
1. **有姓名** → AI知道是谁
|
||
2. **有行为** → AI知道做了什么
|
||
3. **其他随意** → AI自动补充
|
||
|
||
**支持**：口语化、碎片化、无序化、语音转文字
|
||
|
||
---
|
||
|
||
## ⚡ 速记符号系统（新增）
|
||
|
||
### 行为速记
|
||
|
||
| 速记 | 全称 | 使用场景 | 示例 |
|
||
|------|------|----------|------|
|
||
| `gj` | 观望 | `gj5` = 观望5分钟 | gj3→zd |
|
||
| `zd` | 主动 | `zd3` = 主动搭3层 | zd2→wb |
|
||
| `zt` | 自己调整 | 球卡住时自己调整 | zd→zt |
|
||
| `wb` | 完成 | 独立完成搭建 | zx→wb |
|
||
| `mr` | 融入 | 融入小组活动 | mr→hz |
|
||
| `zx` | 专注 | 专注完成任务 | zx15（专注15分钟） |
|
||
| `sb` | 失败→调整 | 失败后调整再尝试 | sb2（失败2次后成功） |
|
||
| `ts` | 探索 | 主动探索新玩法 | ts5（探索5分钟） |
|
||
| `cz` | 创造 | 创造性搭建/设计 | cz3（3种创意方案） |
|
||
| `wt` | 提问 | 主动提问 | wt3（提问3次） |
|
||
| `hz` | 合作 | 与同伴合作 | hz→完成 |
|
||
| `fx` | 分享 | 分享想法/作品 | fx→kx |
|
||
| `ms` | 模仿 | 模仿老师/同学 | ms→zt（模仿后自己调整） |
|
||
| `tq` | 求助 | 主动求助老师 | tq→zd（求助后主动尝试） |
|
||
|
||
### 情绪速记
|
||
|
||
| 速记 | 含义 | 示例 |
|
||
|------|------|------|
|
||
| `↑` / `kx` | 开心/积极 | 情绪↑ 或 kx |
|
||
| `→` / `wd` | 稳定/平和 | 情绪→ 或 wd |
|
||
| `↓` / `fd` | 烦躁/低落 | 情绪↓ 或 fd |
|
||
| `~` / `bd` | 波动 | 情绪~ 或 bd |
|
||
| `↑↑` / `kc` | 非常开心/兴奋 | 发现新玩法时↑↑ |
|
||
| `→→` / `wa` | 非常稳定/沉浸 | 全程→→ |
|
||
| `gd` | 孤独/独自玩 | 偏好gd |
|
||
| `jl` | 焦虑/紧张 | 新主题时jl |
|
||
|
||
### 社交互动速记
|
||
|
||
| 速记 | 含义 | 示例 |
|
||
|------|------|------|
|
||
| `hz` | 合作 | hz完成（合作完成） |
|
||
| `fx` | 分享 | fx想法（分享想法） |
|
||
| `jy` | 建议给同伴 | jy→接受 |
|
||
| `bd` | 被带动 | bd→参与 |
|
||
| `zl` | 孤立/独自 | zl→专注 |
|
||
| `cq` | 冲突/争执 | cq→解决 |
|
||
|
||
### 编程/技术速记（适合SPIKE/AI03）
|
||
|
||
| 速记 | 全称 | 使用场景 | 示例 |
|
||
|------|------|----------|------|
|
||
| `bc` | 编程 | 编写程序 | bc→ts（编程后调试） |
|
||
| `ts` | 调试 | 测试并调整 | ts3（调试3次） |
|
||
| `cx` | 创新/优化 | 改进原有方案 | cx→效果更好 |
|
||
| `fx` | 分析 | 分析问题 | fx→解决 |
|
||
| `cw` | 错误/bug | 发现错误 | cw→fx→修正 |
|
||
| `sy` | 实验 | 尝试不同方案 | sy3（实验3种方案） |
|
||
|
||
### 对比速记
|
||
|
||
| 速记 | 含义 | 示例 |
|
||
|------|------|------|
|
||
| `++` / `!` | 比上周进步 | 比上周++ |
|
||
| `=` / `0` | 和之前一样 | 和之前= |
|
||
| `--` / `?` | 需关注 | 需-- |
|
||
| `new` | 新学生/首次 | 标记首次上课 |
|
||
| `↑+` | 情绪好转 | 从↓到→到↑+ |
|
||
| `↓-` | 状态下滑 | 本周↓- |
|
||
|
||
### 速记组合示例
|
||
|
||
**基础组合**：
|
||
```
|
||
输入： 乔乔：gj5→zd3→zt ↑++
|
||
展开： 乔乔观望5分钟后主动搭3层，自己调整，开心，比上周进步
|
||
|
||
输入： 昊昊：慢热→zd3→反复调 →
|
||
展开： 昊昊慢热，主动搭3层，反复调整，情绪稳定
|
||
|
||
输入： 小强：频换玩法 wb↓--
|
||
展开： 小强频繁换玩法，未完成，情绪烦躁，需关注
|
||
```
|
||
|
||
**扩展组合（新增）**：
|
||
```
|
||
输入： 丞丞：ts5→cz2→wt3 ↑↑
|
||
展开： 丞丞探索5分钟，创造了2种方案，主动提问3次，非常兴奋
|
||
|
||
输入： 一栩：bc→ts3→cx ↑+
|
||
展开： 一栩编程后调试3次，然后优化了方案，情绪好转
|
||
|
||
输入： 小鱼：gj3→tq→zd→wb →
|
||
展开： 小鱼观望3分钟，求助老师后主动尝试，最终完成，情绪稳定
|
||
|
||
输入： 昊昊：hz→jy→fx想法 ↑
|
||
展开： 昊昊与同伴合作，给同伴建议，分享自己的想法，开心
|
||
|
||
输入： 佳兴：zx20→cz3→fx作品 ↑↑
|
||
展开： 佳兴专注20分钟，创造了3种设计，分享作品，非常开心
|
||
```
|
||
|
||
### 速记与自然语言混用规则
|
||
|
||
**优先级**：速记符号 > 自然语言描述
|
||
|
||
| 场景 | 示例 | 处理方式 |
|
||
|------|------|---------|
|
||
| 无冲突 | `gj5→主动搭3层` | 正常解析 |
|
||
| 时间冲突 | `gj5→观望了一会儿` | 以 `gj5`（5分钟）为准，「观望了一会儿」作为补充描述 |
|
||
| 行为冲突 | `zd3→搭了5层` | 以 `zd3`（3层）为准，数值冲突时提示确认 |
|
||
| 顺序标记 | `gj5→zd3→观望了很久` | 速记按序解析，自然语言作为过程描述填充到对应节点 |
|
||
|
||
**解析流程**：
|
||
```
|
||
1. 提取所有速记符号
|
||
2. 按→顺序排列行为序列
|
||
3. 自然语言作为过程描述填充到对应节点
|
||
4. 冲突时以速记数值为准
|
||
```
|
||
|
||
**示例**：
|
||
```
|
||
输入：乔乔：gj5→观望了一会儿→zd3→搭了挺高
|
||
|
||
解析结果：
|
||
- 行为序列：观望5分钟 → 主动搭3层
|
||
- 过程描述：「观望了一会儿」补充gj5，「搭了挺高」补充zd3
|
||
- 输出：乔乔观望了5分钟（一会儿），然后主动搭了3层（挺高的结构）
|
||
```
|
||
|
||
**冲突警告**：当速记与自然语言数值差异明显时（如`zd3→搭了8层`），提示确认：
|
||
```
|
||
⚠️ 数值差异提醒
|
||
速记：zd3（主动搭3层）
|
||
描述："搭了8层"
|
||
是否以速记为准？[是] [以描述为准8层] [手动修改]
|
||
```
|
||
|
||
---
|
||
|
||
## 🏷️ 标记驱动处理（新增）
|
||
|
||
**使用标记快速指定学生类型，无需中断流程**
|
||
|
||
| 标记 | 含义 | 处理方式 | 保存位置 |
|
||
|------|------|----------|----------|
|
||
| 无标记 | 正式学生 | 双轨保存 | 班级汇总+个人档案 |
|
||
| `[补课]` | 补课学生 | 自动检测档案位置，跨班级自动双轨保存 | 班级汇总+个人档案（含跨班级自动保存）|
|
||
| `[体验]` | 体验课学生 | 仅班级汇总 | 班级汇总（标记体验） |
|
||
| `[缺课]` | 今天缺席 | 记录缺席 | 班级汇总（标记缺课） |
|
||
| `[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)。
|
||
|
||
**简要说明**：
|
||
- 正式学生：双轨保存（班级汇总 + 个人档案）
|
||
- `[补课]`学生：
|
||
- 当前班级档案存在 → 双轨保存（本班补课）
|
||
- 其他班级档案存在 → **自动跨班级双轨保存**（无需询问）
|
||
- 任何班级都不存在 → 询问处理方式
|
||
- `[体验]`学生：仅班级汇总
|
||
- `[缺课]`学生：仅记录缺席
|
||
|
||
### 跨班级补课说明
|
||
|
||
**场景**：学生档案在A班（如"发现世界-周四19点"），来B班（如"发现世界-周六09点"）补课
|
||
|
||
**自动处理方式**：
|
||
- **检测到跨班级补课** → **自动双轨保存**
|
||
- ✅ 课评保存到B班（补课班级）的周汇总
|
||
- ✅ 课评追加到A班（原班级）的个人历史课评记录.md（标注"【跨班级补课】本节课程在B班完成"）
|
||
- **无需询问，自动完成**
|
||
|
||
**手动调整**（如需改变默认行为）：
|
||
- 输入 `仅班级汇总 {学生名}` → 仅保存到补课班级，不追加到原档案
|
||
- 输入 `创建新档案 {学生名}` → 在补课班级创建新档案，原档案保留
|
||
|
||
### ⚠️ 重要：课评正文禁止提及补课
|
||
|
||
**无论学生是否标记为`[补课]`，课评正文中绝对不能提及补课相关内容**：
|
||
|
||
- ❌ 禁止出现"补课"、"补课上"、"来补课"、"本次补课"等词汇
|
||
- ❌ 禁止暗示学生非正常上课（如"今天特别来参加"、"临时加入"、"从其他班级过来"等）
|
||
- ❌ 禁止在课评正文中区分"本班学生"和"补课学生"
|
||
|
||
**正确处理**：
|
||
- ✅ `[补课]`标记**仅用于后台档案管理**，课评正文**完全按正常学生**撰写
|
||
- ✅ 课评开头直接写"XX本节课学习了..."，**不加任何特殊说明**
|
||
- ✅ 补课信息仅保存在班级汇总元数据中，不进入课评正文
|
||
|
||
**示例**：
|
||
```
|
||
教师输入：李小红[补课]：搭了3层，专注完成
|
||
|
||
课评输出（正确）：
|
||
小红本节课学习了"旋转飞机"，认识了游乐园旋转设施的中心轴结构...
|
||
|
||
课评输出（错误）：
|
||
小红本节课作为补课学生，学习了"旋转飞机"... ❌（禁止提及补课）
|
||
小红今天来补课，学习了"旋转飞机"... ❌（禁止提及补课）
|
||
```
|
||
|
||
---
|
||
|
||
## 📞 常见问题
|
||
|
||
**Q：速记符号记不住怎么办？**
|
||
A：不用记！直接用自然语言描述，AI一样能理解。速记是给熟练用户的可选提速方式。
|
||
|
||
**Q：忘记打标记怎么办？**
|
||
A：AI会检测档案自动判断。有档案=正式学生，无档案=提示选择[补课]/[体验]。
|
||
|
||
**Q：标记可以组合吗？**
|
||
A：可以！`张小明[体验][new]`表示体验课新学生。
|
||
|
||
**Q：上下文记忆持续多久？**
|
||
A：一次会话内有效。换班级时重新指定即可。
|
||
|
||
---
|
||
|
||
*核心理念：用最自然的方式记录，让AI处理格式*
|