补全9月11日至13日课评:为13名学生创建请假文档,为5个班级创建总结文档

This commit is contained in:
chengzi
2026-09-13 19:34:34 +08:00
parent 167d832353
commit 21001eccf5
1322 changed files with 37510 additions and 4136 deletions

View File

@@ -9,9 +9,46 @@ type: skill
## 🌟 功能说明
本技能专为穹狼科创编程课程设计,**使用超简单:你只需要告诉我学生的基本信息和本节课表现,我就能自动生成符合班级风格的个性化课评**。
✅ 支持四大课程:C++/AICODE/Kitten/体验课
✅ 自动匹配班级专属风格:AICODE03温暖鼓励型/K4温和鼓励型/CSP03要求型/体验课转化型
✅ **CSP班级必须查询OJ做题数据**(用户提供token后自动获取A包答题情况)
✅ 支持课程:AIAGENT03班 / CSP04班 / CSP00班 / 体验课(2026秋季新学期)
✅ 自动匹配班级专属风格:CSP要求型 / AIAGENT温暖鼓励型 / 体验课转化型
✅ **CSP00/CSP04班课评已升级为 v2 提交诊断式写法**(见下方强制规则;数据源改用全班逐生逐次提交诊断,不再用旧版 OJ 简表)
## ⚠️ CSP 课评强制规则(v2 · 严格执行)
**适用范围**:所有 CSP 班级(CSP00 / CSP04)。**本规则优先级最高,覆盖本技能中其它关于 CSP 与 OJ 的旧写法。**
生成任何 CSP 课评前,**必须先加载并执行**项目技能 `.claude/skills/class-feedback-report/SKILL.md`
(技能名 `class-feedback-report`),按它的「班级课堂反馈与提交诊断」流程产出课评:
1. **数据来源改用提交诊断**:用该技能的 `scripts/fetch-class-data.mjs` 拉取**全班逐生逐次提交**
(代码 + 编译报错 + 状态 + 客观题),不再使用旧版 `scripts/get_student_oj.py` 的单行 OJ 简表。
2. **报告结构必须按该技能的固定模板**(🌟值得表扬 → 📊完成情况 → 💻编程题逐题诊断(第1次提交错在哪…第N次通过)→ 📝选择题/判断题错题分析 → 📖整体分析 → ✅建议)。
3. **必须产出家长版三件套**:`<姓名>-<班组>-<章节号>-反馈报告.{md,html,pdf}`,
HTML 以 `samples/report-sample.html` 为样式基准,`pdf` 用 `scripts/mkpdf.mjs` 生成(单页 660px)。
4. **审核红线**(必须写进每次交付说明):报告是草稿、须教师审核;只写学习习惯不写人身评价;
代码/报错/错题选项只发对应家长、不进班级群;不做学生横向对比排名。
5. **存档结构改用新技能体系**(见下方「CSP 班(v2 存档结构)」):
`Class-2026-X/<班组>/<学生>/` + `Students/<学生>/profile.md`。
> AIAGENT03 班、体验课 **不**适用本规则,仍按本技能原有流程与存档(`.claude/memory/class/...` + `output/课评汇总/`)执行。
>
> **快速触发**:对 AI 说「整理 XX 班的课堂反馈」或「引导我进行操作」即可调用该技能;其脚本自动读取仓库根 `.env`(已配置 OJ 凭据)。
## 🌐 课评网页模版统一规则(一键导出 PDF · 强制执行)
**适用范围**:所有课评网页模版与由本技能生成的课评网页(AIAGENT 结构模板、C++/CSP 结构模板、CSP v2 家长版 `report-sample.html`、课评汇总网页等)。**强制,无例外。**
每张课评网页**必须**带一个**一键导出 PDF** 按钮,统一采用零依赖的 `window.print()` 方案(浏览器原生「另存为 PDF」,离线可用、不依赖任何外部库),并配 `@media print` 打印样式:
1. **按钮**:`🖨️ 导出 PDF`,点击即调起打印面板(用户选「保存为 PDF」即可)。
2. **打印样式必须**(否则家长收到的 PDF 会缺色/错位):
- 隐藏所有悬浮控件:导出按钮、下载按钮、提示 toast(`display:none!important`);
- `* { -webkit-print-color-adjust:exact!important; print-color-adjust:exact!important; }` 保留渐变与配色;
- 卡片 `break-inside:avoid` 避免内容被分页截断;背景置白、去掉多余留白;
- 若有入场动画(`.animate-in` 等)需在打印时强制 `opacity:1; animation:none`。
3. **标准实现直接复用**:参考 `.claude/skills/class-feedback-report/samples/report-sample.html` 的 `.export-btn` + `@media print` 片段,整段拷过去即可,无需重写。
> 已合规模版:`samples/report-sample.html`(CSP v2)。两份结构模板 `output/课评汇总/模板/AIGENT课评结构模板.html`、`output/课评汇总/模板/C++课评结构模板 .html` 本次已补齐「导出 PDF」按钮。今后新增/改写任何课评网页,都先确认带此按钮再交付。
## 💡 使用方式
@@ -20,33 +57,17 @@ type: skill
输入 `/课评生成`,我会按顺序问你以下信息:
```
📝 问题1:这次是什么类型的班?
- [ ] AICODE(AI创意编程)
- [ ] CSP(C++信息奥赛)
- [ ] K4(编程猫Kitten)
- [ ] 体验课
📝 问题1:这次写哪个班?(列出当前所有班级选项)
AIAGENT03班:周五下午1700、周六晚上1900、周日早上0845、周日下午1400
CSP04班:周六早上0830、周六下午1400
CSP00班:周五晚上1900(2课时)
体验课
📝 问题2:课堂录音文件路径是什么?(.docx格式)
📝 问题2(AIAGENT03班):作品文件夹路径是什么?
📝 问题3:这是第几周的课?课程名称是什么?
📝 问题3(CSP00/CSP04班):OJ题目的token是什么?
📝 问题4:具体是哪个班次?(根据你选的班型显示对应选项)
AICODE班选项:
- [ ] AICODE03橙子周六1900
- [ ] AICODE03橙子周日0845
- [ ] AICODE03橙子周日1400
CSP班选项:
- [ ] CSP03橙子周六0830
- [ ] CSP03橙子周六1400
- [ ] CSP03橙子周日1030
K4班选项:
- [ ] K4橙子周五1900
- [ ] K4橙子周日1900
📝 问题5(AICODE班):作品文件夹路径是什么?
📝 问题5(CSP班):OJ题目的token是什么?
📝 问题6:本节课出勤情况如何?(来了哪些学生,谁请假)
📝 问题4:本节课出勤情况如何?(来了哪些学生,谁请假)
```
你回答完所有问题,我就会自动完成整个课评生成流程!
@@ -60,69 +81,74 @@ type: skill
### 第1阶段:课评准备
1. 使用python-docx读取录音转写文件
2. AI分析录音文本,识别"发言人1,2,3"对应的学生
3. **AICODE班**:查看作品文件夹,分析每个学生作品的创意和亮点
3. **AIAGENT班**:查看作品文件夹,分析每个学生作品的创意和亮点
4. 读取课程计划,获取5个知识点
5. 读取每个学生的画像
6. **CSP班**:使用token查询OJ做题数据
6. **CSP00/CSP04班**:使用token查询OJ做题数据
### 第2阶段:课评生成
1. 读取班级风格指南
2. 为每个学生生成个性化课评(约200字)
- 引用录音中的具体例子
- **AICODE班**:描述作品创意和亮点
- **AIAGENT班**:描述作品创意和亮点
- **CSP班**:包含OJ做题数据
3. 生成班级总结
4. 展示给你确认
### 第3阶段:课评收尾
1. 课评质检(CSP班调用证据审计员)
2. 丰富度评分(告诉你每个学生的分数)
3. 保存归档(个人课评 + 周汇总 + 班级总结)
### 第3阶段:课评质检+修订(自动,无需确认)
1. 自动调用课评质检系统(证据审计员 + 质量评审员 + 5位家长视角)
2. 质检调度器汇总意见,调用终稿编辑产出修订稿
3. 三档放行规则自动处理:
- **≥85分**:保存原稿
- **70-84分**:直接采用修订稿
- **<70分**:直接采用修订稿(质检系统已做最佳修订)
4. 丰富度评分记录在案
### 第4阶段:保存归档(自动,无需确认)
1. 保存个人课评(保存的是质检后的最佳版本)
2. 保存到周汇总
3. 保存班级总结
4. 更新学生画像
5. 输出完成报告
5. 生成课评汇总网页
6. 输出完成报告
---
## 📂 从课堂录音批量生成课评(推荐工作流)
橙子提供课堂录音转写文件(`.docx`格式),文件路径会直接告诉我,我会自动完成以下流程:
录音转写文件放在 `D:\03-下载` 目录,我会自动查找读取,自动完成以下流程:
### 🤖 交互式问答流程
当橙子输入 `/课评生成` 时,使用 **AskUserQuestion** 工具按顺序询问:
**第1轮:基本信息**
- 问题1:班型(单选:AICODE/CSP/K4/体验课)
- 问题2:录音文件路径(文本输入)
- 问题3:第几周 + 课程名称(文本输入)
**第1轮:班级**
- 问题1:写哪个班?(单选,列出当前所有班级选项:AIAGENT03 / CSP04 / CSP00 / 体验课)
- 各班级均有固定教案,直接读取课程知识点,不询问课程内容
**第2轮:确认班次**
- 问题4:具体班次(根据班型显示对应选项)
**第2轮:补充材料**
- 问题2(CSP00/CSP04班):OJ题目的token
- 问题2(AIAGENT03班):作品文件夹路径
- 问题3:出勤情况(文本输入,说明谁来了、谁请假)
**第3轮:补充材料**
- 问题5(AICODE班):作品文件夹路径
- 问题5(CSP班):OJ题目的token
- 问题6:出勤情况(文本输入,说明谁来了、谁请假)
**收集完成后**,自动调用三个阶段的agent完成课评生成。
**收集完成后**,自动调用流水线的agent完成课评生成(全程自动,无需确认)。
### 🔄 智能体流水线模式
课评生成已拆分为3个独立智能体,按流水线方式协作完成:
课评生成已拆分为4个阶段,按流水线方式协作完成(全程自动,无需用户确认):
```
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 课评准备阶段 │ ──→ │ 课评生成阶段 │ ──→ │ 课评收尾阶段 │
│ (Agent 1) │ │ (Agent 2) │ │ (Agent 3) │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │ │
▼ ▼ ▼
收集所有数据 生成课评内容 质检+保存+归档
• 确认班型班次 • 读取风格指南 • 课评质检
• 录音解析(AI分析) • 读取课评模板 • 保存课评
• 课程计划匹配 • 生成个人课评 • 保存班级总结
• 学生画像读取 • 生成班级总结 • 更新学生画像
• OJ数据获取 • 质量自检 • 更新学生画像
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────────┐ ┌─────────────────┐
│ 课评准备阶段 │ ──→ │ 课评生成阶段 │ ──→ │ 课评质检+修订阶段 │ ──→ │ 保存归档阶段 │
│ (Agent 1) │ │ (Agent 2) │ │ (质检调度器) │ │ (收尾阶段) │
└─────────────────┘ └─────────────────┘ └─────────────────────┘ └─────────────────┘
│ │ │ │
▼ ▼ ▼ ▼
收集所有数据 生成课评内容 自动质检+修订 自动保存+归档
• 确认班型班次 • 读取风格指南 • 证据审计 • 保存个人课评
• 录音解析(AI分析) • 读取课评模板 • 质量评分 • 保存周汇总
• 课程计划匹配 • 生成个人课评 • 5位家长视角检查 • 保存班级总结
• 学生画像读取 • 生成班级总结 • 终稿编辑修订 • 更新学生画像
• OJ数据获取 • 三档自动放行 • 生成汇总网页
```
**优势**:
@@ -164,7 +190,7 @@ type: skill
```
### 1. 读取课堂录音转写文件
解析用户提供的课堂录音转写文件(`.docx` 格式):
自动从 `D:\03-下载` 目录读取课堂录音转写文件(`.docx` 格式),查找该目录下最新的 `.docx` 文件:
**⚠️ 关键:docx 中文在终端显示会乱码,必须分两步读取!**
@@ -183,8 +209,9 @@ def extract_docx_to_txt(docx_path):
f.write(text)
return txt_path
# 对每个录音文件执行
for fpath in [r'input/录音1.docx', r'input/录音2.docx']:
# 对 D:\03-下载 目录下的每个录音文件执行
import glob
for fpath in glob.glob(r'D:\03-下载\*.docx'):
txt_path = extract_docx_to_txt(fpath)
print(f'已提取: {txt_path}')
```
@@ -241,9 +268,9 @@ analysis_prompt = f"""
| 班级标题关键词 | 课程计划路径 | 课程编号 |
|---|---|---|
| AICODE03 | `.claude/lesson/AICODE/课程计划.md` | AICODE03 |
| CSP03 | `.claude/lesson/CSP03/课程计划.md` | CSP03 |
| Kitten04 / K4 | `.claude/lesson/Kitten04/课程计划.md` | Kitten04 |
| AIAGENT03 | `.claude/lesson/AIAGENT/AIAGENT-03/2026秋季课程计划.md` | AIAGENT03 |
| CSP00 / CSP04 | `.claude/lesson/CSP/CSP03/课程计划.md` | CSP00 / CSP04 |
| 体验课 | `.claude/lesson/体验课/` | 体验课 |
从课程计划中提取对应课次的:
- **课程名称**(如《进制转换》)
@@ -272,14 +299,10 @@ analysis_prompt = f"""
- 将100-200字的表现摘要扩展为约200字的完整家长信格式课评
- **绝不编造**录音中没有提到的内容
**⚠️ CSP班级专属(必须执行)**:
对每个CSP学生,**在生成课评之前**必须先查询OJ做题数据:
```bash
python scripts/get_student_oj.py \
--homework-id <作业ID> \
--student "<学生姓名>"
```
将返回的OJ数据Markdown拼接到课评内容中。**没有OJ数据的CSP课评是不完整的!**
**⚠️ CSP00/CSP04班级专属(已升级为 v2 提交诊断式,见顶部「CSP 课评强制规则 v2 · 严格执行」)**:
CSP 课评**不再使用** `get_student_oj.py` 简表。生成前必须先加载并执行 `.claude/skills/class-feedback-report/SKILL.md`,
用 `scripts/fetch-class-data.mjs` 拉取全班逐生逐次提交(代码+编译报错+状态+客观题),按该技能的
「班级课堂反馈与提交诊断」流程产出课评与家长版 HTML/PDF。下方原 OJ 数据板块格式仅供历史参考,不再使用。
**输出示例**:
```markdown
@@ -308,29 +331,21 @@ python scripts/get_student_oj.py \
**格式**:使用对应班级自己的模板(`.claude/memory/class/[班级]/summaries/群发文案模板.md`或`班级反馈模板.md`)
### 7. 确认流程(橙子检查)
### 7. 自动课评质检(橙子无需确认,自动执行)
所有课评和班级总结生成后,**先展示给橙子看,不保存**:
- 按班级分组展示:个人课评 + 班级总结
- 等待橙子确认或提出修改意见
- 如有修改,即时调整后再次展示,直到橙子满意
课评生成后,**直接自动**调用课评质检系统进行质量检查:
### 8. 课评质检(橙子确认修改后执行)
**橙子确认课评内容无误后**,自动调用课评质检系统进行最终质检:
**触发条件**:橙子说"可以了"、"没问题"、"确认"等表示确认的语句
**质检流程**:
**质检流程**(自动执行,无需用户触发):
1. 调用「课评质检调度器」Agent
2. 输入:橙子确认后的班级总结 + 所有学生的个人课评
3. 调度器自动协调9个质检Agent(证据审计员、质量评审员、5位家长、终稿编辑)
4. 输出:质检报告 + 修订稿(如有问题)
2. 调度器自动协调9个质检Agent(证据审计员、质量评审员、5位家长、终稿编辑)
3. 输出:质检报告 + 修订稿(如有问题)
**三档放行规则**:
- **直接发送**(≥85分且无硬伤):保持原稿,附质检报告供参考,进入保存流程
- **修订后发送**(70-84分或有改进点):展示质检报告和修订稿给橙子,橙子确认后进入保存流程
- **必须重写**(<70分或触发硬伤):展示质检报告给橙子,橙子决定如何修改
**三档放行规则(自动处理)**:
- **直接发送**(≥85分且无硬伤):保持原稿,进入保存流程
- **修订后发送**(70-84分或有改进点):**直接采用终稿编辑的修订稿**,进入保存流程
- **必须重写**(<70分或触发硬伤):**直接采用终稿编辑的修订稿**,进入保存流程
> ⚡ **三种情况均自动进入保存流程,无需橙子确认。**
**质检报告格式**:
```
@@ -356,12 +371,6 @@ python scripts/get_student_oj.py \
- 改了什么、为什么改
```
**质检报告位置**:质检报告附在课评后面,供橙子参考,但不发给家长。
**质检后流程**:
- 如果质检通过(直接发送):自动执行保存操作
- 如果质检发现问题:展示给橙子,橙子确认后再保存
**⚠️ CSP课评质检优先使用 Agents 系统**:
CSP课评必须使用 `.claude/agents/` 目录下的质检Agent系统进行质检,该系统包含:
@@ -378,7 +387,7 @@ CSP课评必须使用 `.claude/agents/` 目录下的质检Agent系统进行质
| **家长-焦虑保护型** | `.claude/agents/家长-焦虑保护型/agent.md` | 情绪风险检查 |
| **家长-成长陪伴型** | `.claude/agents/家长-成长陪伴型/agent.md` | 成长性反馈 |
**CSP质检执行方式**:
**质检执行方式**:
```
调用 课评质检调度器 → 调度器自动协调9个Agent → 输出质检报告 + 修订稿
```
@@ -388,24 +397,24 @@ CSP课评必须使用 `.claude/agents/` 目录下的质检Agent系统进行质
2. **不做学生横向比较**:揪出"最高/最快/分水岭/紧随XX"等比较词
3. **术语家长能懂**:OLE/CE/WA/SJF/AC这类缩写要解释或换成白话
4. **结合学生性格**:完美主义型先肯定韧性再谈方法;佛系型正向收尾不施压
5. **老师是最终决策者**:给建议和修订稿,老师决定用不用
5. **老师是最终决策者**:给建议和修订稿,老师决定用不用(但默认直接采用修订版)
### 9. 保存归档(保存的是质检后的课评)
### 8. 保存归档(自动保存质检后的最佳版本)
**橙子最终确认后**(此时课评已完成质检,是三档放行后的版本),执行以下保存操作:
**无需橙子确认**,质检完后直接自动保存:
| 质检结论 | 保存的版本 | 说明 |
|---------|-----------|------|
| 直接发送(≥85分) | 原稿(已通过质检) | 原稿本身就是高质量的,直接保存 |
| 修订后发送(70-84分) | **修订稿**(质检后修改版) | 质检发现问题 → 终稿编辑修订 → 橙子确认 → 保存修订版 |
| 必须重写(<70分) | **橙子修改后的最终版** | 质检发现问题 → 橙子决定如何修改 → 保存最终版 |
| 修订后发送(70-84分) | **修订稿**(质检后修改版) | 质检发现问题 → 终稿编辑修订 → **自动保存修订版** |
| 必须重写(<70分) | **修订稿**(质检后修改版) | 质检发现问题 → 终稿编辑修订 → **自动保存修订版** |
1. 保存到学生个人单次课评文件
2. **保存到统一周课评汇总**(`E:/cc/4work_project/ClassFeedback/output/课评汇总/`),**后写的课评放在最前面**
3. 保存班级总结
4. 更新学生画像
### 10. 更新学生画像(自动)
### 9. 更新学生画像(自动)
保存课评的同时,根据本节课表现**适当更新**学生画像 `profile.md`:
**更新原则**:
@@ -494,9 +503,9 @@ CSP课评必须使用 `.claude/agents/` 目录下的质检Agent系统进行质
---
## ⚙️ 核心生成逻辑(自动完成,你不需要操作)
## ⚙️ 核心生成逻辑(全程自动,无需人工确认)
```
1. 确认班型和班次 → 2. 读取参考资料 → 3. AICODE班分析作品/CSP班拉取OJ数据 → 4. 生成个性化课评 → 5. 橙子确认修改 → 6. 自动质检 → 7. 自动保存
1. 确认班型和班次 → 2. 读取参考资料 → 3. AIAGENT班分析作品 / CSP班拉取OJ数据 → 4. 生成个性化课评 → 5. 自动质检+修订 → 6. 自动保存
```
### 1. 自动读取参考资料
@@ -504,25 +513,25 @@ CSP课评必须使用 `.claude/agents/` 目录下的质检Agent系统进行质
- **学生画像**:`.claude/memory/class/[班级]/[姓名]/profile.md`(了解学生性格特点和适用风格)
- **班级风格指南**:根据课程类型读取对应规则(`.claude/rules/[课程].md`)
- **课评格式模板**:根据课程类型选择对应模板(`.claude/templates/[课程].md`),包含标准版和极简版
- **本节课教案**:到 `.claude/lesson/` 目录下查找对应班级、对应课次的教案,确保课评内容与实际教学一致,不编造内容
- **本节课教案**:AIAGENT03班到 `.claude/lesson/AIAGENT/AIAGENT-03/2026秋季课程计划.md` 按课次查找对应教案;**CSP00/CSP04班到 `.claude/lesson/CSP/CSP03/课程计划.md`**
- **过往课评**:读取该学生的历史课评,避免重复用词
- **课堂录音转写**:`.docx`格式,使用python-docx库读取,AI分析提取学生表现
- **AICODE班作品**:查看作品文件夹,分析每个学生作品的创意和亮点
- **AIAGENT班作品**:查看作品文件夹,分析每个学生作品的创意和亮点
> 💡 **模板库路径**:`../../templates/`
> - `AICODE.md`:AICODE创意编程课评模板(标准版 + 极简版)
> - `AIAGENT.md`:AIAGENT创意编程课评模板(标准版 + 极简版)
> - `CSP.md`:C++/CSP课程课评模板
> - `KITTEN.md`:Kitten课程课评模板
> - `课评汇总网页.html`:家长版课评汇总HTML网页模板(翻页浏览、温暖画册风格)
### 2. AICODE班级专属:查看作品文件夹(必须执行)
### 2. AIAGENT班级专属:查看作品文件夹(必须执行)
**⚠️ 这是强制步骤,AICODE课评必须包含作品创意描述!**
**⚠️ 这是强制步骤,AIAGENT课评必须包含作品创意描述!**
**执行时机**:在生成每个AICODE学生的课评**之前**,先查看该学生的作品文件夹。
**执行时机**:在生成每个AIAGENT学生的课评**之前**,先查看该学生的作品文件夹。
**执行流程**:
1. 识别出AICODE班级的学生
1. 识别出AIAGENT班级的学生
2. 查看作品文件夹(橙子提供的本地路径)
3. 分析每个学生作品的:
- 创意点:有什么独特的想法
@@ -530,7 +539,7 @@ CSP课评必须使用 `.claude/agents/` 目录下的质检Agent系统进行质
- 亮点:有什么特别出彩的地方
4. 将作品分析**用中文写进课评**中
**示例**(生成陈嘉博的AICODE课评):
**示例**(生成陈嘉博的AIAGENT课评):
```
嘉博今天表现特别棒~主动问老师关于循环嵌套的问题,说明在认真思考~
@@ -540,7 +549,11 @@ CSP课评必须使用 `.claude/agents/` 目录下的质检Agent系统进行质
老师会继续关注嘉博的表现,期待看到更多精彩!🌟💡
```
### 3. CSP班级专属:自动获取OJ做题数据(必须执行)
### 3. CSP班级专属:自动获取OJ做题数据(必须执行 · 已升级为 v2,见顶部规则)
> ⚠️ **CSP 课评已改用 `.claude/skills/class-feedback-report` 的提交诊断式流程**:不再用
> `get_student_oj.py` 简表,改为 `fetch-class-data.mjs` 拉全班逐生逐次提交后,按该技能模板写诊断报告。
> 本小节的旧命令仅作历史参考。
**⚠️ 这是强制步骤,CSP课评必须包含OJ数据!**
@@ -577,8 +590,8 @@ python scripts/get_student_oj.py \
| 题目 | 状态 | 提交次数 | 错误类型 |
|------|------|----------|----------|
| CSP0309A1 银行叫号模拟 | ✅ 通过 | 1 | — |
| CSP0309A2 模拟发牌 | ✅ 通过 | 2 | WA×1 |
| CSP0409A1 银行叫号模拟 | ✅ 通过 | 1 | — |
| CSP0409A2 模拟发牌 | ✅ 通过 | 2 | WA×1 |
...
**📊 分析**: 完成4题,第5题有尝试但尚未通过...
@@ -629,16 +642,20 @@ python scripts/get_student_oj.py \
- 专业点评:紧扣课程知识点 ✓
---
### 📋 生成后确认流程(必须遵守)
1. 一批课评全部生成后,我会先把所有课评展示给你,不保存
2. 等待你确认没问题后,再执行保存操作
3. 如果你需要修改,我会根据你的要求修改后再次给你确认,直到你满意再保存
### 📋 生成后流程(自动执行,无需确认)
1. 课评全部生成后,**直接自动启动质检流程**
2. 质检后自动选择最佳版本(≥85分用原稿,<85分用终稿编辑的修订稿)
3. 自动保存归档(个人课评 + 周汇总 + 班级总结 + 汇总网页)
4. 自动更新学生画像
5. 输出完成报告
---
## 🎨 各班级风格规范(自动匹配)
### AICODE03班 - 家长信格式·温暖鼓励型
- 固定开头:"【学生名】家长好,本周学习的内容是《...》" + 5个知识点(开头加学生称呼,如"梓宁家长好",与 CSP03 一致)
### AIAGENT03班 - 家长信格式·温暖鼓励型
- 固定开头:"【学生名】家长好,本周学习的内容是《...》" + 5个知识点(开头加学生称呼,如"嘉博家长好",与 CSP04 一致)
- 课程目标后空一行,再写"课评反馈:"正文
- 多用"很棒"、"特别棒"、"超棒"和波浪号"~"
- 描述具体行为:"一字一字打字"、"和AI聊了一节课"
@@ -650,14 +667,14 @@ python scripts/get_student_oj.py \
- 温和建议时:😊💡🌸
- 结尾固定:"老师会继续关注【姓名】的表现,期待看到更多精彩!🌟💡"
**⚠️ AICODE03班强制要求**:
**⚠️ AIAGENT03班强制要求**:
- **必须查看作品文件夹**,了解每个学生作品的创意和亮点
- **必须用中文描述作品**,写进课评中
- 描述技巧:
- ❌ "嘉博的作品做得不错"(笼统)
- ✅ "嘉博的作品是一个猜数字游戏,用了独特的渐变色背景,还添加了音效和暂停功能,创意很棒!"(具体描述)
#### AICODE03班作品描述示例
#### AIAGENT班作品描述示例
```markdown
嘉博今天表现特别棒~对循环嵌套的理解很到位,能快速理解并动手尝试~
@@ -669,17 +686,7 @@ python scripts/get_student_oj.py \
老师会继续关注嘉博的表现,期待看到更多精彩!🌟💡
```
### K4班 - 家长信格式·温和鼓励型
- 固定开头:"【学生名】家长好,本周学习的内容是《...》" + 5个知识点(开头加学生称呼,如"圆振家长好")
- 肯定创意:"能够有自己的创意"
- 温和指出:"不过老师发现...专注力有些下降"
- **表情包使用**:K4班学生年龄小,多用可爱活泼的表情增加亲和力
- 表扬创意时:🎨🌈✨🌟
- 鼓励坚持时:💪🐱🚀
- 提醒专注时:👀💡😊
- 结尾可用:"继续加油哦!🌟"、"相信你会把程序做得更完整!🚀"
### CSP03班 - 家长信格式·要求型
### CSP00/CSP04班 - 家长信格式·要求型
- 固定开头:"【学生名】家长好,本周学习的内容是《...》" + 5个知识点(开头加学生称呼,如"圆振家长好")
- 表扬积极:"状态在线"、"早早到校等候超积极"
- 期望要求:"希望多思考"、"理解为什么这么写,不只是抄完就好~"
@@ -689,12 +696,15 @@ python scripts/get_student_oj.py \
- 提出期望时:💡📝😊
- 结尾固定:"加油呀!💪✨"
**⚠️ CSP03班强制要求**:
**⚠️ CSP00/CSP04班强制要求**:
- **必须查询OJ做题数据**,没有OJ数据的CSP课评是不完整的
- 执行命令:`python scripts/get_student_oj.py --homework-id <作业ID> --student "<姓名>"`
- OJ数据板块放在课评正文后面,格式见下方模板
#### CSP03班 OJ数据板块格式(自动生成)
#### CSP00/CSP04班 OJ数据板块格式(自动生成 · 已弃用,v2 见顶部规则)
> ⚠️ 此简表为旧版写法,**CSP 课评现已改用 `.claude/skills/class-feedback-report` 的提交诊断式报告**
> (🌟表扬→逐次提交诊断→整体分析→建议)。保留仅为历史参考。
**OJ作业包定位说明**:
- A包 = 课堂练习(**包含5道具体题目,必须全部列出**)
- B包 = 必须完成的课后家庭作业(未完成会明确提醒家长督促)
@@ -707,15 +717,15 @@ python scripts/get_student_oj.py \
| 题目 | 类型 | 状态 | 提交次数 | 思考模式 | 错误类型 |
|------|------|------|----------|----------|----------|
| CSP03-XXA1 | 基础题 | ✅ 通过 | 1 | 一气呵成 | — |
| CSP03-XXA2 | 基础题 | ✅ 通过 | 1 | 一气呵成 | — |
| CSP03-XXA3 | 基础题 | ✅ 通过 | 2 | 调试改进 | WA×1 |
| CSP03-XXA4 | 提高题 | ✅ 通过 | 2 | 调试改进 | WA×1 |
| CSP03-XXA5 | 提高题 | ❌ 未通过 | 2 | 遇到困难 | CE×1, WA×1 |
| CSP04-XXA1 | 基础题 | ✅ 通过 | 1 | 一气呵成 | — |
| CSP04-XXA2 | 基础题 | ✅ 通过 | 1 | 一气呵成 | — |
| CSP04-XXA3 | 基础题 | ✅ 通过 | 2 | 调试改进 | WA×1 |
| CSP04-XXA4 | 提高题 | ✅ 通过 | 2 | 调试改进 | WA×1 |
| CSP04-XXA5 | 提高题 | ❌ 未通过 | 2 | 遇到困难 | CE×1, WA×1 |
---
| CSP03-XXB | 课后作业(必做) | ✅ 已完成 | 3 | 反复调试 | WA×2 |
| CSP03-XXC | 拓展训练(选做) | ⬜ 未提交 | 0 | — | — |
| CSP04-XXB | 课后作业(必做) | ✅ 已完成 | 3 | 反复调试 | WA×2 |
| CSP04-XXC | 拓展训练(选做) | ⬜ 未提交 | 0 | — | — |
**📊 分析**: A包5道题完成了4道,基础题全部掌握,提高题第5道考察的是边界条件处理,还需要加强;B包必做课后作业已完成,知识点巩固得不错;C包拓展题未提交,学有余力可以尝试挑战。
**错误分布**: 编译错误1次,答案错误4次,主要是边界条件考虑不周全,建议课后多练类似题目。
@@ -746,14 +756,29 @@ python scripts/get_student_oj.py \
你确认课评没问题后,我会自动保存到多个位置,严格遵守课评规范V1.0要求:
### 📌 命名规范(必须严格遵守)
- **课程编号规则**:C++竞赛班统一用`CSP`,AI编程班统一用`AICODE`,不得使用`AI`、`C++`等缩写
- **文件名规则**:`YYYYMMDD_课程编号-课次.md`(如`20260418_CSP05-07.md`、`20260330_AICODE03-02.md`)
- **课程编号规则**:C++竞赛班统一用`CSP`,AI编程班统一用`AIAGENT`,不得使用`AI`、`C++`等缩写
- **文件名规则**:`YYYYMMDD_课程编号-课次.md`(如`20260418_CSP04-07.md`、`20260330_AIAGENT03-02.md`)
- **日期要求**:根据用户提供的周次信息推算具体日期,或询问用户确认
- **特殊状态文件**:
- 请假:`YYYYMMDD_课程编号-课次(请假).md`
- 未上课:`YYYYMMDD_课程编号-课次(未到).md`
- 补课:正常文件名 `YYYYMMDD_课程编号-课次.md`,放在补课班级下的 `补课/` 目录中
### ⚠️ CSP 班(v2 存档结构 · 覆盖上方通用规则)
CSP00 / CSP04 课评**不**使用 `.claude/memory/class/...` 与 `output/课评汇总/` 路径,统一改用
`.claude/skills/class-feedback-report` 的归档体系(详见该技能 SKILL.md):
- **家长版三件套**(发给家长):`Class-2026-X/<班组>/<学生>/<姓名>-<班组>-<章节号>-反馈报告.{md,html,pdf}`
- 例:`Class-2026-C/克力周日0830CSP02/王凯平/王凯平-克力周日0830CSP02-03-反馈报告.md`
- `Class-2026-X`:A春 / B暑 / C秋 / D寒(2026秋季班用 `Class-2026-C`)
- HTML 以 `samples/report-sample.html` 为样式基准;PDF 用 `scripts/mkpdf.mjs` 单页 660px 生成
- **内部课评正本**(校宝核查用):`Class-2026-X/<班组>/<学生>/feedback/YYYYMMDD_课程编号-课次.md`
- **学生画像**:`Students/<学生>/profile.md`(跨学期连续,按学生名扁平存放)
- **班级汇总**:`Class-2026-X/<班组>/summaries/<班组>-<章节号>-反馈汇总-<日期>.md`
> AIAGENT03 班、体验课仍按下方通用规则(`.claude/memory/class/...` + `output/课评汇总/`)保存。
### 1. 保存到学生个人单次课评文件(必须,用于自动化统计)
为每位学生生成单独的单次课评文件,这是课评完成率统计的依据:
**路径**:`.claude/memory/class/[班级]/[姓名]/feedback/YYYYMMDD_课程编号-课次.md`
@@ -783,7 +808,7 @@ python scripts/get_student_oj.py \
- **保存路径**:`.claude/memory/class/[补课班级]/补课/[学生姓名]/feedback/`
- **文件名**:`YYYYMMDD_课程编号-课次.md`
- 这里的**课程编号**使用补课班级本身的编号(如去CSP03班补课,就用 `CSP03`)
- 这里的**课程编号**使用补课班级本身的编号(如去CSP04班补课,就用 `CSP04`)
- 文件内容正常写课评,无需特殊标记
### 5. 班级总结保存
@@ -814,8 +839,8 @@ python scripts/get_student_oj.py \
1. 计算本节课所属的教学周次(第X周)
2. 构造文件名:`第{X}周{星期时间}{课程编号}课评.html`
- 星期时间从用户提供的班次信息中提取(如"周日下午"、"周六早上")
- 课程编号如 `AICODE03`、`CSP03`、`K4`
- 示例:`第14周周日下午AICODE03课评.html`
- 课程编号如 `AIAGENT03`、`CSP04`、`CSP00`
- 示例:`第14周周日下午AIAGENT03课评.html`
3. 检查 `output/课评汇总/` 目录下是否已存在该文件
4. 如果**已存在**,**跳过不覆盖**(避免误删橙子手动修改过的网页)
5. 如果**不存在**,基于模板生成新的HTML文件
@@ -844,9 +869,11 @@ python scripts/get_student_oj.py \
- 第一张卡片必须有 `active` 类,其余没有
- 课评正文中的换行符 `\n` 替换为 `<br>`
- 评价指标根据班级风格选取2~4个:
- AICODE班:课堂互动、专注度、作品完成、知识点掌握
- AIAGENT班:课堂互动、专注度、作品完成、知识点掌握
- CSP班:课堂互动、专注度、OJ完成情况、知识点掌握
- K4班:课堂互动、创意表达、作品完成、专注度
- 评价指标根据班级风格选取2~4个:
- AIAGENT03班:课堂互动、专注度、作品完成、知识点掌握
- CSP00/CSP04班:课堂互动、逻辑思维、OJ完成情况、代码能力
- 请假/未到课的学生也要生成卡片,课评内容写简短说明,状态标签用 `badge-absent`
**保存路径**:
@@ -886,10 +913,10 @@ output/课评汇总/第{X}周{星期时间}{课程编号}课评.html
后续流程:匹配课程计划 → 读取学生画像 → 生成课评
```
**AICODE课程 - 鼓励型**
**AIAGENT课程 - 鼓励型**
> 李明今天虽然是第一次接触AI绘画,但我看到了你眼里的好奇,这就是最好的开始。你的描述很有画面感,"想要一个会眨眼的可爱猫咪",这就是好的Prompt。虽然操作还有点生疏,但老师注意到你一直在尝试,这份坚持比做对题目更珍贵。下次可以把想法先写在便签纸上,分点列出,跟AI沟通会更顺畅。记住,编程最大的门槛不是英文或数学,是敢于尝试的勇气,你已经有了。继续和你的"AI搭档"对话吧,它会越来越懂你的。
**CSP03班 - 家长信格式·要求型(含OJ数据)**
**CSP04班 - 家长信格式·要求型(含OJ数据)**
> 子煜家长好,本周学习的内容是《字符串处理》:
> 1. string 类型的声明与使用
> 2. 字符串的输入输出(cin / getline)
@@ -905,15 +932,15 @@ output/课评汇总/第{X}周{星期时间}{课程编号}课评.html
>
> | 题目 | 类型 | 状态 | 提交次数 | 思考模式 | 错误类型 |
> |------|------|------|----------|----------|----------|
> | CSP03-07A1 | 基础题 | ✅ 通过 | 1 | 一气呵成 | — |
> | CSP03-07A2 | 基础题 | ✅ 通过 | 1 | 一气呵成 | — |
> | CSP03-07A3 | 基础题 | ✅ 通过 | 2 | 调试改进 | WA×1 |
> | CSP03-07A4 | 提高题 | ✅ 通过 | 2 | 调试改进 | WA×1 |
> | CSP03-07A5 | 提高题 | ❌ 未通过 | 2 | 遇到困难 | CE×1, WA×1 |
> | CSP04-07A1 | 基础题 | ✅ 通过 | 1 | 一气呵成 | — |
> | CSP04-07A2 | 基础题 | ✅ 通过 | 1 | 一气呵成 | — |
> | CSP04-07A3 | 基础题 | ✅ 通过 | 2 | 调试改进 | WA×1 |
> | CSP04-07A4 | 提高题 | ✅ 通过 | 2 | 调试改进 | WA×1 |
> | CSP04-07A5 | 提高题 | ❌ 未通过 | 2 | 遇到困难 | CE×1, WA×1 |
>
> ---
> | CSP03-07B | 课后作业(必做) | ✅ 已完成 | 3 | 反复调试 | WA×2 |
> | CSP03-07C | 拓展训练(选做) | ⬜ 未提交 | 0 | — | — |
> | CSP04-07B | 课后作业(必做) | ✅ 已完成 | 3 | 反复调试 | WA×2 |
> | CSP04-07C | 拓展训练(选做) | ⬜ 未提交 | 0 | — | — |
>
> **📊 分析**: A包5道题完成了4道,基础题全部掌握,提高题第5道考察的是字符串边界处理,还需要加强;B包必做课后作业已完成,知识点巩固得不错;C包拓展题未提交,学有余力可以尝试挑战。
> **错误分布**: 编译错误1次,答案错误4次,主要是边界条件考虑不周全,建议课后多练类似题目。