398 lines
15 KiB
Markdown
398 lines
15 KiB
Markdown
---
|
||
name: keping-dir-standardize
|
||
description: 将课评目录迁移到标准结构。当用户说"规范目录"、"整理目录"、"目录规范化"、"初始化目录"、"初始化项目"时触发。自动识别当前目录范式，创建标准 .claude/memory/class/ 结构，迁移现有数据（不删除原文件），补建缺失目录，配置课程大纲同步。如果是全新仓库，参考标准仓库创建项目。
|
||
---
|
||
|
||
# 课评目录规范化 Skill
|
||
|
||
## 功能概述
|
||
|
||
将老师仓库中的课评数据迁移到统一标准目录结构。
|
||
- 自动识别 4 种现有目录范式
|
||
- 创建标准 `.claude/memory/class/` 结构
|
||
- 迁移现有课评和画像文件（移动，不删除）
|
||
- 补建缺失的 `feedback/`、`profile.md`、`summary/`、`补课/` 目录
|
||
- 配置课程大纲同步（从独立仓库同步，不提交到本仓库）
|
||
- 支持"全新项目"场景（参考标准仓库创建）
|
||
- 生成迁移报告
|
||
|
||
## 触发条件
|
||
|
||
用户说出以下任意表达时触发：
|
||
- "规范目录"
|
||
- "整理目录"
|
||
- "目录规范化"
|
||
- "初始化目录"
|
||
- "初始化项目"
|
||
- "标准化目录"
|
||
- "迁移目录"
|
||
|
||
## 安全原则
|
||
|
||
1. **绝不删除文件** — 只移动（mv）到新位置，原位置的文件迁移后不再保留副本
|
||
2. **绝不修改文件内容** — 只改变文件路径和文件名
|
||
3. **先报告再执行** — 必须先向用户展示迁移计划，确认后再执行
|
||
4. **遇到不确定的情况就停下问** — 不要猜测
|
||
|
||
## 参考仓库（标准范例）
|
||
|
||
**克力老师的仓库**是最完整的标准范例：
|
||
`https://git.qonnwolf.com/keli/ClassFeedback`
|
||
|
||
新老师或需要补充项目的老师，克隆这个仓库来参考目录结构和配置，但**不是照抄**——只参照结构，数据用自己的。
|
||
|
||
## 目标结构
|
||
|
||
```
|
||
.claude/
|
||
├── memory/
|
||
│ ├── class/ # 【核心 - 所有班级课评数据】
|
||
│ │ ├── CSP05克力周六1600/ # 班级名 = 课程编号+老师+星期+时间
|
||
│ │ │ ├── summaries/ # 班级总结/群发文案
|
||
│ │ │ │ ├── YYYYMMDD_CSP05-07_班级反馈.md
|
||
│ │ │ │ └── YYYYMMDD_CSP05-07_微信群.txt
|
||
│ │ │ ├── 张三/ # 本班学生
|
||
│ │ │ │ ├── feedback/ # 个人课评目录
|
||
│ │ │ │ │ ├── YYYYMMDD_CSP05-07.md # 正常课评
|
||
│ │ │ │ │ ├── YYYYMMDD_CSP05-07(请假).md # 请假记录
|
||
│ │ │ │ │ ├── YYYYMMDD_CSP05-07(补课-去AI03茄子周六1900).md # 补课追踪
|
||
│ │ │ │ │ └── ...
|
||
│ │ │ │ ├── profile.md # 学生画像
|
||
│ │ │ │ └── summary/ # 阶段性总结
|
||
│ │ │ │ └── 2026-05_月度总结.md
|
||
│ │ │ ├── 李四/
|
||
│ │ │ │ └── ...
|
||
│ │ │ └── 补课/ # 补课学生专用目录
|
||
│ │ │ └── 王五/ # 来自其他班级的补课学生
|
||
│ │ │ └── feedback/
|
||
│ │ │ └── YYYYMMDD_CSP05-07.md
|
||
│ │ ├── AICODE03菠萝周六1600/
|
||
│ │ │ └── ...（结构同上）
|
||
│ │ ├── SPIKE02小Q周六1400/
|
||
│ │ │ └── ...（结构同上）
|
||
│ │ └── KITTEN04洋芋周六1600/
|
||
│ │ └── ...（结构同上）
|
||
│ ├── lesson/ # 课程大纲（从独立仓库同步，不提交）
|
||
│ │ ├── README.md
|
||
│ │ ├── CSP/ ← 信息学奥赛课
|
||
│ │ │ ├── CSP01/
|
||
│ │ │ └── ...
|
||
│ │ ├── AICODE/ ← AI人工智能课
|
||
│ │ │ ├── AICODE01/
|
||
│ │ │ └── ...
|
||
│ │ ├── SPIKE/ ← 乐高搭建课
|
||
│ │ ├── KITTEN/ ← 图形化编程课
|
||
│ │ ├── VEXIQ/ ← VEX机器人课
|
||
│ │ └── GESP/ ← 竞赛项目课
|
||
│ └── oj/ # OJ数据分析（仅 CSP 班级，可选）
|
||
│ └── analysis/
|
||
└── skills/ # 技能脚本（可选）
|
||
```
|
||
|
||
### 班级命名规则
|
||
|
||
格式：`课程编号+老师+星期+时间`
|
||
|
||
| 类目 | 前缀 | 示例班级名 |
|
||
|------|------|-----------|
|
||
| 信息学奥赛课 | CSP | `CSP05克力周六1600`、`CSP01六六周六1045` |
|
||
| AI人工智能课 | AICODE、AIMAKE | `AICODE03菠萝周六1600`、`AIMAKE02东东周五1630` |
|
||
| 乐高搭建课 | SPIKE、WEDO、FAXIAN 等 | `SPIKE02菠萝周六1400`、`WEDO01小Q周六1030` |
|
||
| 图形化编程课 | KITTEN、SCRATCH | `KITTEN04洋芋周六1600`、`SCRATCH03橙子周五1900` |
|
||
| VEX机器人课 | VEXIQ、VEXGO 等 | `VEXIQ01菠萝周六1400` |
|
||
| 竞赛项目课 | GESP、ENJOYAI 等 | `GESP03克力周日0900`、`ENJOYAI01东东周六1400` |
|
||
|
||
### 课程类目与编号前缀
|
||
|
||
用于从课程编号前缀识别课程类目，规范班级命名和分类：
|
||
|
||
| 类目 | 课程前缀（不含数字） |
|
||
|------|---------------------|
|
||
| 乐高搭建课 | YISHI、HUOCHE、MATATA、FAXIAN、FAMING、WEDO、ROCKET、SPIKE |
|
||
| 图形化编程课 | KITTEN、SCRATCH |
|
||
| VEX机器人课 | VEXGO、VEXPRE、VEXIQ、V5RC |
|
||
| AI人工智能课 | AICODE、AIMAKE |
|
||
| 信息学奥赛课 | CSP |
|
||
| 竞赛项目课 | ENJOYAI、BOTBALL、ROBORAVE、GOC、GESP、CSP-J、NCT、CSP-S、INFOR、LABOR、FSHH |
|
||
| 杂项类目课 | XITI、CUSTOM、FESTIVAL |
|
||
|
||
### 考勤状态说明
|
||
|
||
每次课后，每位学生必须有且仅有一条 feedback 文件：
|
||
|
||
| 状态 | 文件名 | 说明 |
|
||
|------|--------|------|
|
||
| 正常 | `YYYYMMDD_课程编号.md` | 完整课评 |
|
||
| 请假 | `YYYYMMDD_课程编号(请假).md` | 简要记录 |
|
||
| 补课 | `YYYYMMDD_课程编号(补课).md` | 记录补课 |
|
||
|
||
### 补课双向追踪
|
||
|
||
**1) 接收补课（外班学生来本班）**：
|
||
- 存放在 `补课/学生名/feedback/YYYYMMDD_课程编号.md`
|
||
- 不建 `profile.md` 和 `summary/`
|
||
- 课评开头注明来源：`（补课，来自 CSP05克力周六1600）`
|
||
|
||
**2) 外出补课（本班学生去别班）**：
|
||
- 存放在学生自己的 `feedback/YYYYMMDD_课程编号(补课).md`
|
||
- AI 读取后知道该学生当天的课评在补课班级
|
||
|
||
### 课程大纲同步
|
||
|
||
`.claude/memory/lesson/` 从独立仓库同步，**不提交到老师自己的仓库**：
|
||
|
||
| 目录 | 类目 | 来源 |
|
||
|------|------|------|
|
||
| `lesson/CSP/` | 信息学奥赛课 | `https://git.qonnwolf.com/keli/CSP2026` |
|
||
| `lesson/AICODE/` | AI人工智能课 | `https://git.qonnwolf.com/keli/AICODE2026` |
|
||
| `lesson/GESP/` | 竞赛项目课 | 按实际仓库配置 |
|
||
| 其他前缀目录 | 对应类目 | 按实际仓库配置 |
|
||
|
||
需在 `.gitignore` 中添加：`.claude/memory/lesson/`
|
||
|
||
## 执行流程
|
||
|
||
### 场景判断
|
||
|
||
先判断属于哪种场景：
|
||
|
||
| 场景 | 判断条件 | 处理方式 |
|
||
|------|---------|---------|
|
||
| **全新项目** | 没有 `.claude/memory/class/` 或任何课评数据 | 参考标准仓库创建 |
|
||
| **已有项目** | 有课评数据但结构不标准 | 识别范式后迁移 |
|
||
|
||
### ===== 场景一：全新项目 =====
|
||
|
||
适用于：刚加入协作的老师，或者还没有建立 ClassFeedback 仓库的老师。
|
||
|
||
#### 第 1 步：确认老师信息
|
||
|
||
向用户询问：
|
||
1. 老师昵称/真名
|
||
2. 手机号（用于远端仓库地址）
|
||
3. 负责的班级列表（课程编号+上课时间）
|
||
4. 每个班级的学生名单
|
||
|
||
#### 第 2 步：参考标准仓库创建结构
|
||
|
||
克隆标准仓库作为参考：
|
||
```bash
|
||
git clone https://git.qonnwolf.com/keli/ClassFeedback /tmp/standard-ref
|
||
```
|
||
|
||
**从标准仓库中参考的部分**（只参考结构，不复制数据）：
|
||
- `.claude/memory/class/` 的目录组织方式
|
||
- `.claude/memory/class/班级/学生/feedback/` + `profile.md` + `summary/`
|
||
- `.claude/memory/class/班级/summaries/` 班级总结目录
|
||
- `.claude/memory/class/班级/补课/` 补课目录
|
||
- `.claude/memory/lesson/README.md` 大纲来源说明
|
||
- `.gitignore` 中的忽略规则
|
||
|
||
**不需要参考的部分**（每个老师自己维护）：
|
||
- `.claude/memory/class/` 下的实际学生数据
|
||
- `.claude/memory/oj/` OJ 数据（仅 CSP 老师需要）
|
||
- `.claude/rules/` 规则文件（各老师可能有不同风格）
|
||
- `.claude/skills/` 技能文件
|
||
|
||
#### 第 3 步：创建目录结构
|
||
|
||
```bash
|
||
# 为每个班级创建结构（示例覆盖不同课程类目）
|
||
for class in "CSP05克力周六1600" "AICODE03菠萝周六1600" "SPIKE02小Q周六1400" "KITTEN04洋芋周六1600"; do
|
||
mkdir -p ".claude/memory/class/${class}/summaries"
|
||
mkdir -p ".claude/memory/class/${class}/补课"
|
||
|
||
# 为每个学生创建结构
|
||
for student in 张三 李四 王五; do
|
||
mkdir -p ".claude/memory/class/${class}/${student}/feedback"
|
||
mkdir -p ".claude/memory/class/${class}/${student}/summary"
|
||
# 创建画像模板
|
||
cp profile_template.md ".claude/memory/class/${class}/${student}/profile.md"
|
||
done
|
||
done
|
||
|
||
# 创建课程大纲目录（按实际需要的课程前缀创建）
|
||
mkdir -p ".claude/memory/lesson/CSP"
|
||
mkdir -p ".claude/memory/lesson/AICODE"
|
||
mkdir -p ".claude/memory/lesson/GESP"
|
||
# 其他课程前缀按需创建：SPIKE、KITTEN、VEXIQ 等
|
||
```
|
||
|
||
#### 第 4 步：创建基础文件
|
||
|
||
1. **创建 `.gitignore`**：
|
||
```gitignore
|
||
.claude/
|
||
!.claude/memory/
|
||
!.claude/memory/class/
|
||
!.claude/memory/lesson/README.md
|
||
.claude/memory/lesson/*/
|
||
```
|
||
|
||
2. **创建 lesson/README.md**（记录大纲来源）
|
||
|
||
3. **同步课程大纲**（如果网络可用）
|
||
|
||
4. **创建 CLAUDE.md**（可选，记录本仓库的基本信息）
|
||
|
||
### ===== 场景二：已有项目迁移 =====
|
||
|
||
#### 第 1 步：识别当前目录范式
|
||
|
||
扫描当前仓库，判断属于哪种范式：
|
||
|
||
| 范式 | 特征 |
|
||
|------|------|
|
||
| **A: 标准型** | `.claude/memory/class/` 下有班级目录 |
|
||
| **B: 三件套型** | `memory/student/` 或 `memory/学生/`，每学生"画像+素材+历史课评" |
|
||
| **C: 分离式** | 课评在 `.claude/课评/`，画像在 `.claude/memory/用户画像/` |
|
||
| **D: 散落型** | `课堂记录/`、`ClassFeedback/` 或根目录级 |
|
||
|
||
**识别方法**（按优先级检测）：
|
||
1. 存在 `.claude/memory/class/` → 范式 A
|
||
2. 存在 `memory/student/` 或 `memory/学生/` → 范式 B
|
||
3. 存在 `.claude/课评/` → 范式 C
|
||
4. 存在 `课堂记录/` 或 `ClassFeedback/` → 范式 D
|
||
5. 以上都不存在 → 按场景一（全新项目）处理
|
||
|
||
#### 第 2 步：收集班级和学生信息
|
||
|
||
**从目录结构中提取**：
|
||
- 扫描现有目录，列出所有班级名和学生名
|
||
|
||
**从 CLAUDE.md 或 README.md 补充**：
|
||
- 读取本仓库的 CLAUDE.md，查找班级/课程信息
|
||
|
||
**与用户确认**：
|
||
- 如果班级名缺少"星期+时间"（如只有 `AICODE03班`），询问用户补全
|
||
- 格式参考：`CSP05克力周六1600`
|
||
|
||
#### 第 3 步：生成迁移计划
|
||
|
||
向用户展示迁移计划，包含：
|
||
1. 范式识别结果
|
||
2. 将创建的目录结构预览
|
||
3. 文件迁移清单（原路径 → 新路径）
|
||
4. 不迁移的文件（保留原位）
|
||
|
||
**必须等用户确认后再执行。**
|
||
|
||
#### 第 4 步：执行迁移
|
||
|
||
用户确认后，按计划执行：
|
||
|
||
**范式 A**（已接近标准，微调即可）：
|
||
- 重命名班级目录（如果名称不规范）
|
||
- 确保每个学生有 feedback/、profile.md、summary/
|
||
- 创建 summaries/ 和 补课/ 目录
|
||
|
||
**范式 B**（三件套型）：
|
||
- 创建标准 `.claude/memory/class/` 结构
|
||
- `用户画像.md` → `profile.md`
|
||
- `历史课评记录.md` → `summary/历史课评记录.md`
|
||
- `成长素材.md` → `summary/成长素材.md`
|
||
- 单次课程记录 → `feedback/YYYYMMDD_课程编号.md`
|
||
|
||
**范式 C**（分离式）：
|
||
- 创建标准结构
|
||
- 从集中画像目录迁移到各班级下
|
||
- 课评文件迁移到 feedback/
|
||
|
||
**范式 D**（散落型）：
|
||
- 创建标准结构
|
||
- 全班课评汇总 → `summaries/`
|
||
- 从校宝 API 或人员名单获取学生列表，创建个人目录
|
||
|
||
#### 第 5 步：补建缺失内容
|
||
|
||
1. **profile.md 模板** — 对没有画像的学生创建空模板
|
||
2. **补课目录** — 每个班级下创建 `补课/`
|
||
3. **summaries 目录** — 每个班级下确保有 `summaries/`
|
||
|
||
#### 第 6 步：配置课程大纲同步
|
||
|
||
1. 创建 `lesson/` 目录和子目录
|
||
2. 创建 `lesson/README.md`（记录来源仓库）
|
||
3. 更新 `.gitignore`，添加 `.claude/memory/lesson/*/`（忽略所有课程大纲子目录）
|
||
4. 如果网络可用，克隆并同步大纲
|
||
|
||
#### 第 7 步：更新 CLAUDE.md
|
||
|
||
更新仓库的 CLAUDE.md（如果存在）：
|
||
- 更新目录结构说明
|
||
- 添加课程大纲同步说明
|
||
- 添加考勤状态记录说明（请假/补课）
|
||
|
||
#### 第 8 步：生成迁移报告
|
||
|
||
输出迁移报告，包含：
|
||
- 仓库信息（老师、范式变化）
|
||
- 迁移统计（班级数、学生数、文件数）
|
||
- 班级结构表
|
||
- 后续建议
|
||
|
||
## profile.md 空模板
|
||
|
||
```markdown
|
||
# {学生姓名} - 画像
|
||
|
||
## 基本信息
|
||
- 班级：{班级名}
|
||
- 入班时间：
|
||
- 年龄/年级：
|
||
|
||
## 性格特点
|
||
（待观察填写）
|
||
|
||
## 学习风格
|
||
（待观察填写）
|
||
|
||
## 课堂表现
|
||
（待观察填写）
|
||
|
||
## 编程能力
|
||
- 理解力：
|
||
- 动手能力：
|
||
- 创造力：
|
||
- 调试能力：
|
||
|
||
## 家长沟通
|
||
（待记录）
|
||
```
|
||
|
||
## 请假记录模板
|
||
|
||
```markdown
|
||
# 请假记录
|
||
|
||
**日期**: {YYYY-MM-DD}
|
||
**课程**: {课程编号}
|
||
**学生**: {学生姓名}
|
||
**状态**: 请假
|
||
**原因**: （如有）
|
||
```
|
||
|
||
## 补课追踪模板（原班级侧）
|
||
|
||
```markdown
|
||
# 补课记录
|
||
|
||
**日期**: {YYYY-MM-DD}
|
||
**原课程**: {原课程编号}
|
||
**学生**: {学生姓名}
|
||
**状态**: 补课
|
||
**补课班级**: {目标班级名}
|
||
**补课老师**: {目标老师}
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
1. **处理所有课程类型** — 按课程类目表覆盖全部前缀（乐高搭建、图形化编程、VEX机器人、AI人工智能、信息学奥赛、竞赛项目、杂项），全部统一规范
|
||
2. **CSP 特殊处理** — CSP 班级可能有 `oj/` 数据目录，保持不动
|
||
3. **文件名中的课程编号** — 统一用 `课程编号-课次` 格式（如 `CSP05-07`、`AICODE03-02`、`SPIKE02-05`、`KITTEN04-03`）
|
||
4. **补课学生** — 在补课班级只有 feedback/，不建 profile.md 和 summary/
|
||
5. **全班课评** — 范式 D 的全班课评放到 summaries/ 下，不强行拆分为个人课评
|
||
6. **不确定就问** — 如果班级时间信息缺失、学生归属不明，停下来问用户
|
||
7. **不碰 .claude/rules/ 和 .claude/skills/** — 这些是配置文件，不在迁移范围内
|
||
8. **lesson 不提交** — 课程大纲目录加入 .gitignore，大纲从独立仓库同步
|