40 lines
2.1 KiB
Markdown
40 lines
2.1 KiB
Markdown
# 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。
|