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>
312 lines
8.9 KiB
Markdown
312 lines
8.9 KiB
Markdown
> ⚠️ **本文件已归档**：内容已合并至核心规则文件，此处仅作历史备份。请勿直接引用本文件，请使用 `.claude/rules/` 下的核心规则。
|
||
|
||
# 课评生成快速入门指南 v2.5（旧版本）
|
||
|
||
> ⚠️ **注意**：本文档为 v2.5 旧版本归档文件，描述的是"生成-确认-保存"两阶段流程。
|
||
> 当前系统已升级为 v3.1 "生成即双轨保存"模式，详见 [20-workflow.md](../20-workflow.md) 第7节和第10节。
|
||
>
|
||
> **最新快速入门请直接查看**：`CLAUDE.md` → "快捷输入速查"章节
|
||
|
||
---
|
||
|
||
## 🚀 30秒极速上手
|
||
|
||
### 第1步：指定班级（一次即可）
|
||
```
|
||
/课评 班级：发现世界-周四19点
|
||
```
|
||
|
||
### 第2步：输入学生表现
|
||
```
|
||
乔乔：观望5分钟→主动搭3层→自己调整，开心，比上周进步
|
||
昊昊：慢热，搭3层，反复调整，稳定
|
||
```
|
||
|
||
### 第3步：一键确认发送
|
||
```
|
||
AI生成 → 查看 → [全部发送]
|
||
```
|
||
|
||
**完成！3份课评已自动保存到班级汇总和个人档案。**
|
||
|
||
---
|
||
|
||
## ⚡ 速记符号速查
|
||
|
||
### 核心速记（必会）
|
||
|
||
| 速记 | 含义 | 示例 |
|
||
|------|------|------|
|
||
| `gj#` | 观望#分钟 | `gj5` = 观望5分钟 |
|
||
| `zd#` | 主动搭#层 | `zd3` = 主动搭3层 |
|
||
| `zt` | 自己调整 | 遇到问题时自己调整 |
|
||
| `↑` | 开心 | `↑++` = 开心，比上周进步 |
|
||
| `→` | 稳定 | `→` = 情绪稳定 |
|
||
|
||
> 完整速记符号表参见 [36-shorthand-learning.md](36-shorthand-learning.md)
|
||
|
||
### 速记组合示例
|
||
|
||
```
|
||
乔乔：gj5→zd3→zt ↑++
|
||
```
|
||
展开：乔乔观望5分钟后主动搭3层，自己调整，开心，比上周进步
|
||
|
||
---
|
||
|
||
## 🏷️ 学生类型标记
|
||
|
||
**输入时添加标记，AI自动处理**
|
||
|
||
| 标记 | 含义 | 处理方式 |
|
||
|------|------|----------|
|
||
| `[体验]` | 体验课学生 | 仅保存到班级汇总 |
|
||
| `[补课]` | 补课学生 | 询问是否建档 |
|
||
| `[缺课]` | 今天缺席 | 记录缺席，不生成课评 |
|
||
| `[new]` | 新学生首次 | 创建档案，双轨保存 |
|
||
|
||
**示例**：
|
||
```
|
||
乔乔：gj5→zd3→zt ↑++
|
||
张小明[体验]：搭了3层，开心
|
||
李小红[补课]：专注完成，稳定
|
||
```
|
||
|
||
### ⚠️ 重要：课评正文不显示标记
|
||
|
||
**无论输入时是否添加`[补课]`或`[体验]`标记，生成的课评正文中都不会提及这些信息**。
|
||
|
||
- `[补课]`、`[体验]`等标记**仅用于后台档案管理**
|
||
- 课评正文统一按正常学生撰写，不区分学生类型
|
||
- 家长看到的课评中不会出现"补课"、"体验"等字样
|
||
|
||
**示例**：
|
||
```
|
||
教师输入：李小红[补课]：搭了3层，专注完成
|
||
|
||
课评输出：
|
||
小红本节课学习了"旋转飞机"，认识了游乐园旋转设施的中心轴结构...
|
||
（正常撰写，完全不提"补课"相关信息）
|
||
```
|
||
|
||
---
|
||
|
||
## 📝 三种常用方式
|
||
|
||
### 方式1：极简一句话（最自由）
|
||
|
||
```
|
||
乔乔今天开始不敢碰，后来主动搭了三层，球卡住自己调高度，挺稳定的，比上周主动多了
|
||
```
|
||
|
||
**特点**：
|
||
- 任意格式，AI自动解析
|
||
- 支持口语化、语音转文字
|
||
- 适合边走边记
|
||
- **字数**：输入简洁 → 输出约200字
|
||
|
||
### 方式2：详细描述（最丰富）
|
||
|
||
```
|
||
乔乔今天开始观望了5分钟，后来主动搭了3层管道，球卡住的时候自己调整高度，还主动帮助旁边的小朋友一起搭，最后完成作品特别开心，说这是她最喜欢的作品。比上周主动多了，上周观望了10分钟才开始。
|
||
```
|
||
|
||
**特点**：
|
||
- 描述越详细，课评越丰富
|
||
- AI会提取所有精彩瞬间
|
||
- 家长能看到更多孩子成长细节
|
||
- **字数**：输入丰富 → 输出约280字
|
||
|
||
### 方式3：速记符号（最高效）
|
||
|
||
```
|
||
乔乔：gj5→zd3→zt ↑++
|
||
昊昊：慢热→zd3→反复调 →
|
||
小强：频换玩法 wb↓--
|
||
```
|
||
|
||
**特点**：
|
||
- 输入速度最快
|
||
- 适合熟练用户
|
||
- 批量处理首选
|
||
- **字数**：根据输入内容自动调整
|
||
|
||
### 方式4：批量表格（最清晰）
|
||
|
||
```
|
||
课程：DISC-007
|
||
班级：发现世界-周四19点
|
||
|
||
1. 乔乔：gj5→zd3→zt ↑++
|
||
2. 昊昊：慢热→zd3→反复调 →
|
||
3. 张小明[体验]：搭了3层，开心
|
||
4. 李小红[补课]：专注完成，稳定
|
||
```
|
||
|
||
**特点**：
|
||
- 全班一览清晰
|
||
- 支持标记分类
|
||
- 适合课后整理
|
||
- **字数**：根据每位学生输入内容自动调整
|
||
|
||
---
|
||
|
||
## 💡 字数弹性说明（新增）
|
||
|
||
**核心理念：输入越丰富，课评越详细**
|
||
|
||
| 输入类型 | 示例 | 输出字数 |
|
||
|---------|------|---------|
|
||
| **精简输入** | "搭了3层，开心" | 180-220字 |
|
||
| **标准输入** | "观望5分钟→主动搭3层→自己调整→还帮助同伴" | 220-280字 |
|
||
| **详细输入** | 包含多个亮点、精彩瞬间、纵向对比 | 280-350字 |
|
||
|
||
**建议**：
|
||
- 常规课堂 → 简洁记录即可
|
||
- 有亮点/突破/精彩瞬间 → 详细描述，AI会充分展开
|
||
- 不用担心字数多 → 家长更喜欢看到孩子的具体成长
|
||
|
||
---
|
||
|
||
## 🔄 旧流程：生成 → 确认 → 保存（v2.5 及之前版本）
|
||
|
||
```
|
||
教师输入 → AI自动生成 → 【自动保存班级汇总】 → 展示给教师
|
||
↓
|
||
教师查看 → [一键发送] → 【自动保存个人档案】 → 完成
|
||
```
|
||
|
||
> **v3.1 更新**：现已简化为"生成即双轨保存"，无需确认步骤。详见 [20-workflow.md](../20-workflow.md)。
|
||
|
||
---
|
||
|
||
## 📊 批量生成界面预览
|
||
|
||
```
|
||
━━━━━━━━━━━━━━━━━━━━━━━
|
||
📊 批量生成完成（4份）｜发现世界-周四19点｜DISC-007
|
||
━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
✅ 乔乔 198字 正常
|
||
✅ 昊昊 205字 正常
|
||
✅ 张小明[体验] 192字 体验学生
|
||
✅ 李小红[补课] 201字 补课学生
|
||
|
||
【批量操作】
|
||
[全部发送] [逐个查看] [标记修改] [取消]
|
||
━━━━━━━━━━━━━━━━━━━━━━━
|
||
```
|
||
|
||
---
|
||
|
||
## 📁 文件存储位置
|
||
|
||
### 双轨自动保存
|
||
|
||
| 存储位置 | 文件路径 | 用途 |
|
||
|---------|---------|------|
|
||
| **班级周汇总** | `memory/class-evaluation-summary/第X周/{班级}.md` | 集中查看当周全班表现 |
|
||
| **个人历史课评** | `memory/student/{班级}/{学生名}/历史课评记录.md` | 追踪个人完整成长轨迹 |
|
||
|
||
> 学生类型处理规则详见 [33-first-class-rules.md](33-first-class-rules.md)
|
||
|
||
### 跨班级补课说明
|
||
|
||
**场景**：学生档案在A班（如"发现世界-周四19点"），来B班（如"发现世界-周六09点"）补课
|
||
|
||
**处理方式**：
|
||
- 如果教师选择"跨班级保存"，课评将同时保存到：
|
||
- B班（补课班级）的周汇总
|
||
- A班（原班级）的个人历史课评记录.md（标注跨班级补课信息）
|
||
- 这样可以在原班级追踪学生的完整成长轨迹
|
||
|
||
---
|
||
|
||
## 💡 进阶技巧
|
||
|
||
### 技巧1：会话上下文
|
||
|
||
**首次指定班级后，后续无需重复**
|
||
|
||
```
|
||
/课评 班级：发现世界-周四19点 # 只需一次
|
||
|
||
# 后续直接输入
|
||
乔乔：搭3层，开心
|
||
昊昊：慢热，稳定
|
||
```
|
||
|
||
### 技巧2：语音快速录入
|
||
|
||
```
|
||
语音："呃...乔乔啊...观望了5分钟...主动搭3层..."
|
||
|
||
AI自动解析为：乔乔：gj5→zd3→zt
|
||
```
|
||
|
||
### 技巧3：混合输入
|
||
|
||
```
|
||
# 同一批输入中混合使用自然语言和速记
|
||
|
||
乔乔今天表现很好，搭了3层还自己调整，开心
|
||
昊昊：慢热→zd3→反复调 →
|
||
张小明[体验]：积极参与
|
||
```
|
||
|
||
---
|
||
|
||
## ❓ 常见问题速答
|
||
|
||
**Q：速记符号记不住怎么办？**
|
||
A：不用记！直接用自然语言描述，AI一样能理解。
|
||
|
||
**Q：忘记打标记会怎样？**
|
||
A：AI会自动检测档案。在当前班级有档案=正式学生；在其他班级有档案=跨班级补课（询问处理方式）；无档案=提示选择[补课]/[体验]。
|
||
|
||
**Q：跨班级补课学生如何保存？**
|
||
A：如果学生档案在A班，来B班补课，可以选择：①仅保存到B班班级汇总；②同时追加到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/` 目录
|
||
- **速记符号表**：参见 `30-input-format.md`
|
||
- **批量生成规则**：参见 `32-batch-generation.md`
|
||
|
||
---
|
||
|
||
*记住：说人话就行，AI帮你处理格式！*
|