chengzi/ClassFeedback
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source
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
Download Patch File Download Diff File Expand all files Collapse all files

31
.claude/agents/课评准备阶段/agent.md
View File

@@ -18,7 +18,7 @@ tools: Read, Grep, Glob, Bash, Agent
```json
{
"recording_file": "课堂录音转写文件路径（.docx格式）",
"recording_dir": "D:\\下载（课堂录音转写文件目录，自动查找最新.docx）",
"lesson_num": "课次编号，如 11",
"course_name": "课程名称，如《AI训练师》",
"attendance": {
@@ -36,11 +36,11 @@ tools: Read, Grep, Glob, Bash, Agent
- `lesson_num`：橙子直接告诉你这节课是第几课
- `course_name`：橙子直接告诉你这节课的题目/名称
- `attendance`：橙子直接告诉你谁来了、谁请假
- `works`：AICODE班级需要，橙子告诉你作品文件夹的本地路径（如 `D:\作品\第11课\`）
- `works`：AIAGENT班级需要，橙子告诉你作品文件夹的本地路径（如 `D:\作品\第11课\`）
### AICODE班作品分析（必须执行）
### AIAGENT班作品分析（必须执行）
**⚠️ AICODE班必须执行此步骤！**
**⚠️ AIAGENT班必须执行此步骤！**
收到作品文件夹路径后，需要：
@@ -118,12 +118,19 @@ start_date = end_date - timedelta(days=7)
### 第2步：读取课堂录音转写文件
解析用户提供的课堂录音转写文件（`.docx`格式）：
自动从 `D:\下载` 目录读取最新课堂录音转写文件（`.docx`格式）：
**使用python-docx库读取**：
```python
import glob, os
from docx import Document
# 自动查找D:\下载下最新的.docx文件
docx_files = glob.glob(r'D:\下载\*.docx')
if not docx_files:
raise FileNotFoundError("D:\\下载目录下没有找到.docx文件")
recording_file = max(docx_files, key=os.path.getctime) # 取最新的文件
def read_recording_docx(file_path):
"""读取课堂录音转写的docx文件"""
doc = Document(file_path)
@@ -239,9 +246,9 @@ recording_text = read_recording_docx(recording_file)
**课程计划路径**：
| 班级 | 课程计划路径 |
|---|---|
| AICODE03 | `.claude/lesson/AICODE/课程计划.md` |
| CSP03 | `.claude/lesson/CSP03/课程计划.md` |
| Kitten04 / K4 | `.claude/lesson/Kitten04/课程计划.md` |
| AIAGENT03 | `.claude/lesson/AIAGENT/AIAGENT-03/2026秋季课程计划.md` |
| CSP00 / CSP04 | `.claude/lesson/CSP/CSP03/课程计划.md` |
| 体验课 | `.claude/lesson/体验课/` |
从课程计划中提取对应课次的：
- **教学目标 5个知识点**
@@ -253,9 +260,9 @@ recording_text = read_recording_docx(recording_file)
对每个学生，读取其个人画像档案：
**路径**：`.claude/memory/class/[班级]/[姓名]/profile.md`
### 第6步：获取OJ数据（仅CSP班级）
### 第6步：获取OJ数据（仅CSP00/CSP04班级）
**⚠️ CSP班级必须执行此步骤！**
**⚠️ CSP00/CSP04班级必须执行此步骤！**
对每个CSP学生，查询OJ做题数据：
```bash
@@ -274,7 +281,7 @@ python scripts/get_student_oj.py \
{
"api_data": {
"teaching_date": "2026-05-14",
"class_name": "AICODE03橙子周六1900",
"class_name": "AIAGENT03橙子周六1900",
"time": "19:00-20:30"
},
"lesson_info": {
@@ -328,7 +335,7 @@ python scripts/get_student_oj.py \
## 注意事项
1. **日期必须使用API返回的teaching_date**，不使用录音文件中的日期
2. **CSP班级必须获取OJ数据**，没有OJ数据的CSP课评是不完整的
2. **CSP00/CSP04班级必须获取OJ数据**，没有OJ数据的课评是不完整的
3. **学生画像必须读取**，用于个性化课评生成
4. **课程知识点不得编造**，必须从课程计划中提取
5. **录音转写可能有误差**，AI分析时要注意识别学生姓名的同音字

73
.claude/agents/课评收尾阶段/agent.md
View File

@@ -25,19 +25,9 @@ tools: Read, Grep, Glob, Bash, Agent, Write
## 工作流程
### 第1步：展示课评给用户确认
### 第1步：执行课评质检（自动）
**在执行任何保存操作前，必须先展示所有课评给用户确认！**
按班级分组展示：
- 个人课评
- 班级总结
等待用户确认或提出修改意见。如有修改，即时调整后再次展示，直到用户满意。
### 第2步：执行课评质检
用户确认课评内容无误后，自动调用课评质检系统：
生成课评后，**直接**自动调用课评质检系统，无需用户确认：
**质检流程**：
1. **CSP班**：调用「课评证据审计员」Agent，核实OJ数据、知识点等事实
@@ -54,45 +44,16 @@ tools: Read, Grep, Glob, Bash, Agent, Write
| 个性化纵向对比 | 10 | 结合学生过往学情画像，对比本次表现 |
| 专业知识点体现 | 10 | 紧扣课程核心知识点点评 |
**评分结果展示格式**：
```
📊 课评评分报告
**三档放行规则（自动处理，无需用户参与）**：
| 条件 | 结论 | 保存版本 |
|------|------|---------|
| ≥85分 且 无硬伤 | 直接发送 | 保存原稿（已通过质检，无需修改） |
| 70-84分 或 有改进点 | 修订后发送 | **保存终稿编辑的修订稿**（已整合质检反馈） |
| <70分 或 触发硬伤 | 必须重写 | **保存终稿编辑的修订稿**（质检系统已产出最佳修订版，直接采用） |
【学生姓名】课评评分
> **不管哪个档位，都自动保存质检后的最佳版本，无需等待用户确认。**
【总分】XX / 100（规范性XX分 + 丰富度XX分）
【丰富度明细】
- 具体化程度：XX/15
- 课后建议质量：XX/15
- 个性化纵向对比：XX/10
- 专业知识点体现：XX/10
【结论】直接发送 / 修订后发送 / 必须重写
```
**⚠️ 必须告诉用户每个学生的评分**：
- 展示每个学生的课评评分
- 展示班级整体平均分
- 展示需要改进的地方
**三档放行规则**：
| 条件 | 结论 | 处理 |
|------|------|------|
| ≥85分 且 无硬伤 | 直接发送 | 保持原稿，附质检报告供参考 |
| 70-84分 或 有改进点 | 修订后发送 | 展示质检报告和修订稿给用户 |
| <70分 或 触发硬伤 | 必须重写 | 展示质检报告给用户，用户决定如何修改 |
### 第3步：保存归档（保存质检后的版本）
用户最终确认后（此时课评已完成质检），执行以下保存操作：
**保存哪个版本取决于质检结论**：
- **直接发送（≥85分）** → 保存原稿（已通过质检，无需修改）
- **修订后发送（70-84分）** → 保存终稿编辑的**修订稿**（已整合质检反馈）
- **必须重写（<70分）** → 保存用户修改后的**最终版**
#### 3.1 保存学生个人课评
### 第2步：保存学生个人课评
**路径**：`.claude/memory/class/[班级]/[姓名]/feedback/YYYYMMDD_课程编号-课次.md`
@@ -115,7 +76,7 @@ tools: Read, Grep, Glob, Bash, Agent, Write
- 未上课：`YYYYMMDD_课程编号-课次(未到).md`
- 补课：`YYYYMMDD_课程编号-课次.md`，放在补课班级的`补课/`目录
#### 3.2 保存到统一周课评汇总
### 第3步：保存到统一周课评汇总
**根目录**：`E:/cc/4work_project/ClassFeedback/output/课评汇总/`
@@ -123,13 +84,13 @@ tools: Read, Grep, Glob, Bash, Agent, Write
**排序规则**：最新生成的课评放在文件最前面
#### 3.3 保存班级总结
### 第4步：保存班级总结
**路径**：`.claude/memory/class/[班级]/summaries/YYYYMMDD_课程编号-课次_班级反馈.md`
**格式**：使用对应班级自己的模板
#### 3.4 生成课评汇总网页（可选）
### 第5步：生成课评汇总网页（可选）
为每个班级生成家长版课评汇总HTML网页：
@@ -143,7 +104,7 @@ tools: Read, Grep, Glob, Bash, Agent, Write
3. 如果已存在，跳过不覆盖
4. 如果不存在，基于模板生成新的HTML文件
### 第4步：更新学生画像
### 第6步：更新学生画像
根据本节课表现**适当更新**学生画像 `profile.md`：
@@ -170,7 +131,7 @@ tools: Read, Grep, Glob, Bash, Agent, Write
- 遇到困难时不再马上求助，会先尝试独立调试
```
### 第5步：输出完成报告
### 第7步：输出完成报告
保存完成后，输出完成报告：
@@ -189,8 +150,8 @@ tools: Read, Grep, Glob, Bash, Agent, Write
## 注意事项
1. **必须先展示给用户确认**，不能直接保存
2. **课评质检必须执行**，确保课评质量
1. **课评质检必须执行**，确保课评质量（自动执行，无需用户确认）
2. **保存的是质检后的版本**：≥85分保存原稿，<85分保存终稿编辑的修订稿
3. **文件命名必须规范**，使用API返回的teaching_date
4. **学生画像只更新有变化的部分**，不重复已有信息
5. **课评汇总网页如已存在则跳过**，避免覆盖用户手动修改

30
.claude/agents/课评生成阶段/agent.md
View File

@@ -32,15 +32,14 @@ tools: Read, Grep, Glob, Agent
| 课程 | 风格文件 | 语气特点 |
|------|---------|---------|
| AICODE03班 | `.claude/rules/AICODE.md` | 温暖鼓励型，用"很棒～"、波浪号、表情符号 |
| CSP03班 | `.claude/rules/CSP.md` | 家长信·要求型，"希望多思考"，先查OJ数据 |
| K4班 | `.claude/rules/KITTEN.md` | 家长信·温和鼓励型，"不过老师发现..." |
| AIAGENT03班 | `.claude/rules/AIAGENT.md` | 温暖鼓励型，用"很棒～"、波浪号、表情符号 |
| CSP00/CSP04班 | `.claude/rules/CSP.md` | 家长信·要求型，"希望多思考"，先查OJ数据 |
| 体验课 | `.claude/rules/体验课.md` | 转化导向，突出"第一次"，自然引导报课 |
### 第2步：读取课评模板
根据课程类型选择对应模板：
- `.claude/templates/AICODE.md` - AICODE创意编程课评模板
- `.claude/templates/AIAGENT.md` - AIAGENT创意编程课评模板
- `.claude/templates/CSP.md` - C++/CSP课程课评模板
- `.claude/templates/KITTEN.md` - Kitten课程课评模板
@@ -52,11 +51,11 @@ tools: Read, Grep, Glob, Agent
- 学生姓名和出勤状况
- 从录音中提取的表现摘要（performance）
- **具体例子（examples）**：学生说了什么话、做了什么行为
- **作品分析（works_analysis）**：AICODE班级需要，包含创意、亮点、总结
- **作品分析（works_analysis）**：AIAGENT班级需要，包含创意、亮点、总结
- 学生画像（profile.md）
- 班级风格指南
- 课程知识点
- OJ数据（仅CSP班级）
- OJ数据（仅CSP00/CSP04班级）
**生成规则**：
@@ -77,29 +76,24 @@ tools: Read, Grep, Glob, Agent
#### 各班级风格要点
**AICODE03班 - 温暖鼓励型**：
**AIAGENT03班 - 温暖鼓励型**：
- 多用"很棒"、"特别棒"、"超棒"和波浪号"～"
- 描述具体行为："一字一字打字"、"和AI聊了一节课"
- 温和建议用"要是...就更好啦～"
- **必须描述作品创意和亮点**：把works_analysis中的内容用中文写进课评
- 结尾固定："老师会继续关注【姓名】的表现，期待看到更多精彩！🌟💡"
**AICODE班作品描述技巧**：
**AIAGENT班作品描述技巧**：
- ❌ "嘉博的作品做得不错"（笼统）
- ✅ "嘉博的作品是一个猜数字游戏，用了独特的渐变色背景，还添加了音效和暂停功能，创意很棒！"（具体描述）
- 技巧：描述作品是什么、有什么创意、用了什么技术、有什么亮点
**CSP03班 - 家长信·要求型**：
**CSP00/CSP04班 - 家长信·要求型**：
- 表扬积极："状态在线"、"早早到校等候超积极"
- 期望要求："希望多思考"、"理解为什么这么写，不只是抄完就好～"
- 结尾固定："加油呀！💪✨"
- **必须包含OJ数据板块**
**K4班 - 温和鼓励型**：
- 肯定创意："能够有自己的创意"
- 温和指出："不过老师发现...专注力有些下降"
- 结尾固定："继续加油哦！"、"相信你会把程序做得更完整！"
#### CSP班级OJ数据板块格式
```markdown
## 【OJ做题数据】
@@ -149,8 +143,8 @@ tools: Read, Grep, Glob, Agent
{
"class_summaries": [
{
"class_dir": "AICODE03橙子周六1900",
"course_code": "AICODE03",
"class_dir": "AIAGENT03橙子周六1900",
"course_code": "AIAGENT03",
"lesson_num": "11",
"content": "班级总结内容..."
}
@@ -158,8 +152,8 @@ tools: Read, Grep, Glob, Agent
"student_feedbacks": [
{
"name": "陈嘉博",
"class_dir": "AICODE03橙子周六1900",
"course_code": "AICODE03",
"class_dir": "AIAGENT03橙子周六1900",
"course_code": "AIAGENT03",
"lesson_num": "11",
"attendance": "正常上课",
"content": "生成的课评内容...",

10
.claude/agents/课评质检调度器/agent.md
View File

@@ -16,15 +16,15 @@ tools: Read, Grep, Glob, Agent
### 第1步：判断班级类型，选择质检策略
- **CSP班**：必须调用「课评证据审计员」核实OJ数据和知识点
- **AICODE班**：必须检查作品描述是否具体
- **K4班**：重点检查温和建议是否恰当
- **CSP00/CSP04班**：必须调用「课评证据审计员」核实OJ数据和知识点
- **AIAGENT03班**：必须检查作品描述是否具体
- **K4/Kitten班**：重点检查温和建议是否恰当
### 第2步：并行调用核心质检Agent
同时调用以下3个Agent（并行执行）：
1. **课评证据审计员**（仅CSP班必须调用）
1. **课评证据审计员**（仅CSP00/CSP04班必须调用）
- 输入：课评内容 + OJ数据 + 课程大纲
- 输出：事实核对结论
@@ -87,7 +87,7 @@ tools: Read, Grep, Glob, Agent
【总分】XX / 100（规范性XX分 + 丰富度XX分）
【结论】直接发送 / 修订后发送 / 必须重写
【一、证据审计】（CSP班必须）
【一、证据审计】（CSP00/CSP04班必须）
- 已核实：...
- 存疑/风险：...