xiaoq/ClassFeedback
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

同步课评规范V1.0 v4.0：课程编号规范、目录结构、完成率统计规则

Browse Source 
- 课程编号：CSP (C++) / AICODE (AI编程)，必须与校宝一致
- 目录结构：.claude/memory/class/{班级}/{学生}/feedback/YYYYMMDD_课程编号-课次.md
- 文件命名：(请假)/(补课-去班级名) 后缀标记
- 完成率统计：三级查找规则（本班级→跨班级补课→其他老师仓库）
- keping-advanced skill 完整重写至 v4.0
- 所有 AI03 → AICODE03，所有 memory/student/ → .claude/memory/class/
This commit is contained in:
qiuyan
2026-05-14 13:41:26 +08:00
parent 079a09d743
commit bfc69267f6
12 changed files with 612 additions and 447 deletions
Download Patch File Download Diff File Expand all files Collapse all files

156
.claude/skills/keping-advanced/SKILL.md
View File

@@ -1,7 +1,7 @@
---
name: keping-advanced
description: 穹狼乐高编程高级课评生成Skill。当用户需要生成个性化课评、写课后反馈、创建学生评价时使用。根据学生画像、课程教案、历史课评、学期周数等多维度信息，自动生成180-350字专业课评（根据输入丰富度弹性调整）。支持自动周数计算和主题关联。采用"生成即双轨保存"流程：课评生成后立即自动保存到班级周汇总和个人档案，无需教师确认。同时自动更新出勤统计。支持补课/体验学生的灵活处理（可仅保存到班级周汇总）。适用于2.5岁-小学四年级学生，支持幼儿积木、少儿编程、机器人竞赛等多种课程类型。触发词：/课评、/keping、/写课评、生成课评。
version: 3.1.0
description: 穹狼乐高编程高级课评生成Skill。当用户需要生成个性化课评、写课后反馈、创建学生评价时使用。根据学生画像、课程教案、历史课评、学期周数等多维度信息，自动生成180-350字专业课评（根据输入丰富度弹性调整）。支持自动周数计算和主题关联。采用"生成即自动保存"流程：课评生成后立即自动保存到 feedback/ 个人课评文件（课评规范V1.0标准），无需教师确认。支持补课/体验学生的灵活处理。适用于2.5岁-小学四年级学生，支持幼儿积木、少儿编程、机器人竞赛等多种课程类型。触发词：/课评、/keping、/写课评、生成课评。
version: 4.0.0
author: 穹狼教学团队
---
@@ -21,33 +21,32 @@ author: 穹狼教学团队
---
## 8步执行流程（v3.1 生成即双轨保存模式 + 出勤统计自动更新）
## 8步执行流程（v4.0 课评规范V1.0标准 + 自动保存）
```
┌─────────────────────────────────────────────────────────────────────────┐
│ Step 1: 读取学生用户画像 │
│ ├── 情况A：学生档案存在 → 正常读取 │
│ ├── 情况A：学生档案存在 → 正常读取 `.claude/memory/class/{班级}/{学生}/profile.md` │
│ └── 情况B：学生档案不存在（补课/体验学生）→ 标记类型 │
│ Step 2: 读取对应课程的课评规则 │
│ Step 3: 读取本节课教案内容（含周数计算） │
│ Step 4: 读取该学生近10次历史课评（如存在） │
│ Step 4: 读取该学生近10次历史课评（如存在，从 feedback/ 目录读取） │
│ Step 5: 结合教师提供的本节课表现 │
│ Step 6: 生成180-350字个性化课评（根据输入丰富度弹性调整） │
│ ↓ 【自动生成】 │
│ Step 7: 【自动双轨保存】 │
│ ├── 7.1 保存到班级周汇总：`memory/class-evaluation-summary/第X周/{班级}.md` │
│ ├── 7.2 保存到个人历史课评（如有档案）： │
│ │ ├── 常规学生：`memory/student/{班级}/{学生}/历史课评记录.md` │
│ │ └── 补课学生：同时保存到补课班级汇总 + 原班级个人档案 │
│ └── 7.3 更新出勤统计：`memory/class-evaluation-summary/第X周/出勤统计.md` │
│ Step 7: 【自动保存】（课评规范V1.0标准） │
│ ├── 7.1 保存个人课评文件：`.claude/memory/class/{班级}/{学生}/feedback/YYYYMMDD_课程编号-课次.md` │
│ ├── 7.2 班级总结：`.claude/memory/class/{班级}/summaries/YYYYMMDD_课程编号-课次_班级反馈.md` │
│ └── 7.3 补课/体验学生：补课班级 `补课/` 目录 + 原班级（双向追踪） │
│ Step 8: 展示保存结果，教师可随时查看/修改 │
└─────────────────────────────────────────────────────────────────────────┘
```
> **重要变更**：
> 1. **v3.1 生成即双轨保存**：课评生成后立即自动保存，无需教师确认
> 2. **自动更新出勤统计**：每次保存自动更新出勤统计文件
> 3. **全程可修改**：保存后教师可随时修改，修改自动同步到两个位置
> 1. **v4.0 课评规范V1.0标准**：改用 `.claude/memory/class/` 目录结构，个人课评存为 `feedback/YYYYMMDD_课程编号-课次.md`
> 2. **课程编号统一**：AI编程班统一用 `AICODE` 前缀（如 AICODE03），C++班统一用 `CSP` 前缀
> 3. **补课双向追踪**：补课学生在原班级侧生成追踪文件 `(补课-去班级名).md`
> 4. **全程可修改**：保存后教师可随时修改，修改自动同步
### 详细流程说明
@@ -55,11 +54,11 @@ author: 穹狼教学团队
**操作**：
1. **检查学生档案是否存在**：
- 检查路径：`memory/student/{班级}/{学生名}/`
- 检查文件：`用户画像.md`、`历史课评记录.md`
- 检查路径：`.claude/memory/class/{班级}/{学生}/`
- 检查文件：`profile.md`
2. **情况A：学生档案存在（常规学生）**
- 读取 `memory/student/{班级}/{学生名}/用户画像.md`
- 读取 `.claude/memory/class/{班级}/{学生}/profile.md`
- 提取完整信息：气质类型、学习风格、历史表现等
- **标记类型**：`student_type = "regular"`
@@ -154,7 +153,7 @@ author: 穹狼教学团队
|---------|:---:|:---------------:|:-----|
| 发现世界 | 第5周 | DISC-005 | 天平秤 |
| SPIKE | 第5周 | SPIKE-005 | 杯子盖球 |
| AI03 | 第5周 | AI03-005 | 项目整合 |
| AI编程 | 第5周 | AICODE03-005 | 项目整合 |
**3.3 提取教案内容**
- 根据课程代码（如：DISC-005, SPIKE-005）定位教案
@@ -173,8 +172,8 @@ author: 穹狼教学团队
#### Step 4: 读取该学生近10次历史课评
**操作**：
- 读取 `memory/student/{班级}/{学生名}/历史课评记录.md`
- 提取最近10条记录
- 读取 `.claude/memory/class/{班级}/{学生}/feedback/` 目录下的所有课评文件
- 提取最近10条记录（按文件名日期排序）
- 分析：
- 能力发展趋势
- 进步轨迹
@@ -276,51 +275,51 @@ author: 穹狼教学团队
- 小学低段：尊重专业，平等对话，简洁emoji
- 小学高段：成长视角，数据支撑，结构化
**输出**：`evaluation_text`（180-350字，含emoji），**等待教师确认后再执行Step7**
**输出**：`evaluation_text`（180-350字，含emoji），**自动进入保存流程**
---
#### Step 7: 双轨保存课评（需教师确认后执行）
**触发条件**：教师确认课评内容无误后
#### Step 7: 自动保存课评（课评规范V1.0标准，无需确认）
**触发条件**：课评生成完成后自动触发
**操作逻辑**：
```
IF student_type == "regular"（常规学生）:
├── 7.1 保存到班级周汇总
│ └── 路径：`memory/class-evaluation-summary/第X周/{班级}.md`
└── 7.2 保存到个人历史课评
└── 路径：`memory/student/{班级}/{学生}/历史课评记录.md`
├── 7.1 保存个人课评文件
│ └── 路径：`.claude/memory/class/{班级}/{学生}/feedback/YYYYMMDD_课程编号-课次.md`
│ └── 内容：三段式课评正文
└── 7.2 保存班级总结
└── 路径：`.claude/memory/class/{班级}/summaries/YYYYMMDD_课程编号-课次_班级反馈.md`
ELSE IF student_type == "guest"（补课/体验学生）:
└── 仅保存到班级周汇总
└── 路径：`memory/class-evaluation-summary/第X周/{班级}.md`
└── 标记：(补课/体验学生，无个人档案)
├── 7.1 保存个人课评文件
│ └── 路径：`.claude/memory/class/{补课班级}/补课/{学生}/feedback/YYYYMMDD_课程编号.md`
└── 7.2 原班级追踪（跨班级补课）
└── 生成追踪文件：`.claude/memory/class/{原班级}/{学生}/feedback/YYYYMMDD_课程编号(补课-去班级名).md`
```
**班级周汇总文件结构**：
**个人课评文件格式**：
```markdown
# 发现世界-周四19点 第7周汇总
# {日期} | {课程代码} | {课程主题}
## 学生课评列表
**课评内容**：
{三段式课评正文}
### 梁昕乔（常规学生）✓
[课评内容]
- 状态：已确认
- 个人档案：已同步
**课堂表现**（摘要）：
- 专注度：/5
- 动手操作：/5
- 问题解决：/5
- 情绪表现：{描述}
### 钟昀昊（常规学生）✓
[课评内容]
- 状态：已确认
- 个人档案：已同步
---
### 张小明（补课学生）⚠️
[课评内容]
- 状态：已确认
- 个人档案：未创建（补课/体验学生）
- 备注：如需创建档案，请回复「为张小明创建档案」
注意：状态通过文件名后缀自动识别
- 正常文件名 `.md` = 出勤
- `(请假).md` = 请假
- `(补课-去班级名).md` = 补课追踪
```
**输出**：保存确认 + 文件路径 + 学生类型标记
**输出**：保存确认 + 文件路径
---
@@ -330,20 +329,14 @@ ELSE IF student_type == "guest"（补课/体验学生）:
- 补课/体验学生（`student_type = "guest"`）跳过此步骤
**操作**：
- 更新 `memory/student/{班级}/{学生名}/用户画像.md` 中的成长轨迹表
- 更新 `memory/student/{班级}/{学生名}/历史课评记录.md`
- 添加新记录：
- 时间：本次课日期
- 课程：课程代码
- 关键表现：一句话摘要
- 能力变化：+/- 标记
- 更新 `.claude/memory/class/{班级}/{学生}/profile.md` 中的成长轨迹表
- 在 `.claude/memory/class/{班级}/{学生}/feedback/` 目录下已保存课评文件
**补课/体验学生的后续处理**：
如果教师后续决定为补课/体验学生创建档案：
1. 创建文件夹：`memory/student/{班级}/{学生名}/`
2. 创建通用用户画像
3. 将该学生的历史课评从班级周汇总迁移到个人档案
4. 标记为常规学生
1. 创建目录：`.claude/memory/class/{班级}/{学生}/`
2. 创建 `profile.md` 通用画像
3. 将该学生的历史课评从 `补课/` 目录迁移到正式 `feedback/` 目录
**输出**：更新确认
@@ -377,35 +370,26 @@ ELSE IF student_type == "guest"（补课/体验学生）:
## 依赖文件路径
```
# 学生画像
memory/student/{班级}/{学生名}/用户画像.md
# 学生画像（课评规范V1.0标准）
.claude/memory/class/{班级}/{学生}/profile.md
.claude/memory/class/{班级}/{学生}/feedback/
# 课程教案
memory/lesson/01-发现世界-螺丝刀/{课程代码}.md
memory/lesson/08-SPIKE/{课程代码}.md
memory/lesson/09-AI03-AICODE/{课程代码}.md
memory/lesson/09-AICODE-AICODE/{课程代码}.md
# **学期周数与主题映射（新增）**
# 学期周数与主题映射
.claude/rules/15-semester-weeks.md
# **班级周汇总（新增 - 按周期分班级）**
memory/class-evaluation-summary/第X周/{班级}.md
# 班级总结
.claude/memory/class/{班级}/summaries/
# 学期周数（保持独立）
.claude/rules/15-semester-weeks.md
# 风格规则（已合并至10-style.md）
# 风格规则
.claude/rules/10-style.md # 全年龄段风格规范
# 评价维度（已合并至00-core.md）
.claude/rules/00-core.md # 核心规则（含评价维度）
# 历史课评
memory/student/{班级}/{学生名}/历史课评记录.md
# 输出目录
memory/student/{班级}/{学生名}/课评/
memory/class-evaluation-summary/第X周/ # **新增**：按周期分班级的周汇总
# 评价维度
.claude/rules/00-core.md # 核心规则（含评价维度、课程编号规范）
```
---
@@ -511,15 +495,17 @@ memory/class-evaluation-summary/第X周/ # **新增**：按周期
| 版本 | 日期 | 更新内容 |
|-----|------|---------|
| **v2.5.0** | **2026-05-01** | **统一字数标准**：将课评字数统一为弹性范围180-350字，与系统规则保持一致 |
| v2.4.0 | 2026-04-16 | **补课/体验学生支持**：新增对补课、体验课学生的处理逻辑——无档案时提醒教师，可选择仅保存到班级周汇总，不强制创建个人档案 |
| v2.3.0 | 2026-04-15 | **双轨存储**：新增班级周汇总功能，确认后同时保存到 `class-evaluation-summary/`（班级视角）和 `student/`（个人视角），便于集中查看当周全班表现 |
| v2.2.0 | 2026-04-04 | **流程优化**：新增"确认后保存"模式，Step 6生成后等待教师确认，确认后再执行Step 7-8保存，避免自动保存错误内容 |
| v2.1.0 | 2026-04-02 | **重大更新**：支持学期周数自动计算（基准3月2日），课程主题自动匹配，课评内容关联当周知识点，Emoji段落末尾插入，删除正文周数显示 |
| v2.0.0 | 2026-03-25 | 高级版本，支持8步完整流程，历史课评回顾，千人千面差异化 |
| v1.0.0 | 2026-03-25 | 基础版本，单维度课评生成 |
| **v4.0.0** | **2026-05-14** | **同步课评规范V1.0**：改用 `.claude/memory/class/` 目录结构（feedback/*.md 单次文件）；统一课程编号（AI编程→AICODE，C++→CSP）；补课双向追踪（`(补课-去班级名).md`）；删除"待确认"步骤，生成即自动保存 |
| v3.1.0 | 2026-05-05 | **生成即双轨保存**：删除"待确认"状态，改为生成后立即自动保存；出勤嵌入班级汇总 |
| v2.5.0 | 2026-05-01 | **统一字数标准**：将课评字数统一为弹性范围180-350字，与系统规则保持一致 |
| v2.4.0 | 2026-04-16 | **补课/体验学生支持**：新增对补课、体验课学生的处理逻辑 |
| v2.3.0 | 2026-04-15 | **双轨存储**：新增班级周汇总功能 |
| v2.2.0 | 2026-04-04 | **流程优化**：新增确认后保存模式 |
| v2.1.0 | 2026-04-02 | **重大更新**：支持学期周数自动计算、课程主题自动匹配 |
| v2.0.0 | 2026-03-25 | 高级版本，支持8步完整流程，千人千面差异化 |
| v1.0.0 | 2026-03-25 | 基础版本 |
---
*维护者：穹狼教学团队*
*最后更新：2026-04-16*
*最后更新：2026-05-14*