# ClassFeedback 课评仓库 · AI 协作须知

> 任何 AI agent（Claude Code / ZCode / 其他）进入本仓库，**先读完本文件再动手**。

## 本仓库是什么

老师的课评与学员档案仓库：AI 按班组从 OJ 拉取提交数据，逐生生成课堂反馈报告
（MD + HTML + PDF），并维护学生画像。

## 目录结构

```
.claude/memory/class/<班组>/summaries/          班级汇总 / 群发文案
.claude/memory/class/<班组>/补课/<学生名>/feedback/   外班来补课学生
.claude/memory/class/<班组>/<学生名>/           学生课评（家长版报告 + feedback/ 内部正本 + profile.md 画像）
skills/class-feedback-report/           课评技能（AI 按 SKILL.md 执行）
docs/                                   机构规范文档
```

> 全部课评统一存 `.claude/memory/class/`，按「班组 → 学生 → feedback」组织；
> 学生画像 `profile.md` 随班级学生目录存放，不设独立 Students/ 根目录。

## 老师说这些话时该做什么

- 「引导我进行操作」「帮我处理本项目」→ 按
  `skills/class-feedback-report/SKILL.md` 的**操作引导模式**九步清单执行
  （仓库准备 → 环境 → 站点/账号 → 班级/花名册 → 生成 → git 同步 → 交付）。
- 「整理 XX 班的课堂反馈」「给某某出反馈报告」→ 同上，跳过已确认的步骤。

## 铁律

1. 家长版报告是**草稿**，教师审核措辞后才能发学生/家长；只写学习习惯，不写人身评价。
2. **先 OJ 拉班组花名册给老师确认，再逐生分析。**
3. 每个学生每次课五件事缺一不可：家长版报告 md/html、PDF（本地）、内部课评正本
   `feedback/YYYYMMDD_课程编号-课次.md`（校宝核查口径）、画像更新 `<学生名>/profile.md`、
   班级汇总 `summaries/`。
4. `*.pdf` 不入库（.gitignore 已排除）；生成后 `git add` + commit + push。
5. 客观题不写提交历史，直接给错题 + 选项 + 考点分析；学生答案轨迹只与本人生成的单子呈现。
6. 仓库名统一 ClassFeedback；远端在 git.qonnwolf.com。