ClassFeedback/.pi/skills/class-feedback-report/repo-template/AGENTS.md

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。