--- name: keping-simplified description: 超级简化版课评生成器！只需输入 "/课评" 即可启动，表单直连提交，AI自动检测并生成。为穹狼乐高编程设计。 version: 5.1.0 author: 穹狼教学团队 --- # keping-simplified — 超级简化版课评生成器 ## 🚀 核心特点 **超级简单！一键启动！** - 只需输入 `/课评` 即可启动，无需记住一堆命令 - 启动即显示当前周数+班级选择 - 自动匹配课程主题（基于学期周数映射表） - 本地网页表单：学生状态快捷选择 + 速记输入 + 进度条 - **直连提交**：表单直接 POST 到本地服务器，无需复制粘贴 - AI 自动检测信号文件 → 生成课评 → 双轨保存 - 完成后自动清理临时数据 --- ## 📋 完整工作流程 ### 第一步：启动（只需一个命令！） ``` 用户输入：/课评 ``` 立即执行以下操作： 1. ✅ 计算当前周数（基于3月2日开学） 2. ✅ 显示当天对应周几的班级列表 3. ✅ 自动匹配每个班级的当周课程主题 --- ### 第二步：班级选择 ``` ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🎯 选择班级 | 第X周 YYYY-MM-DD ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 可选班级： [1] 发现世界-周四19点（DISC-011 鳄鱼） [2] Wed创造世界-周六1030（CREATE-011 推磨机器人） [3] AICODE03小Q周六1400（AICODE03-011 AI文档写作） [4] SPIKE02-周日1030（SPIKE-011 摩天轮） [5] 手动输入班级名称 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ``` 用户选择班级后，系统自动： 1. 启动本地表单服务器（`python src/form_server.py`） 2. 读取该班级目录，加载学生名单和画像 3. 匹配当周课程主题（从学期周数映射表） --- ### 第三步：打开网页表单 + 直连提交 ``` ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🖥️ 表单服务器已启动！ 👉 http://localhost:8088/form?class=发现世界-周四19点&week=11&course=DISC-011&theme=鳄鱼&date=2026-05-16 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ``` **表单已自动填入：班级、周数、日期、课程主题、学生名单（含画像摘要）** 用户在浏览器中： 1. 为每位学生选择状态（出勤/请假/补课/体验） 2. 填写课堂表现（支持速记符号） 3. 点击「🚀 提交并保存」 4. 看到「✅ 提交成功」→ 可关闭页面 **数据自动 POST 到本地服务器 → 保存为 JSON → 写入信号文件** **表单预览**： ``` ┌──────────────────────────────────────────┐ │ 📝 课评填写表单 - 发现世界-周四19点 │ │ 第11周 · DISC-011 鳄鱼 · 2026-05-16 │ ├──────────────────────────────────────────┤ │ 📊 填写进度：3/6 · █████░░ 50% │ ├──────────────────────────────────────────┤ │ ┌─梁昕乔───────────────────────┐ │ │ │ 📋 性格内向，需鼓励... │ │ │ │ [出勤] [请假] [补课] [体验] │ │ │ │ 表现：____________________ │ │ │ │ (速记提示：gj=观望、zd=主动) │ │ │ └──────────────────────────────┘ │ │ ┌─钟昀昊───────────────────────┐ │ │ │ [出勤] [请假] [补课] [体验] │ │ │ │ 表现：____________________ │ │ │ └──────────────────────────────┘ │ │ ┌─+ 添加临时学生──────────────┐ │ │ │ 姓名：____ 状态：[补课/体验] │ │ │ └──────────────────────────────┘ │ ├──────────────────────────────────────────┤ │ [🚀 提交并保存] │ └──────────────────────────────────────────┘ ``` --- ### 第四步：AI 自动检测 → 生成并保存 ``` ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🔔 检测到表单提交 | 发现世界-周四19点 | DISC-011 鳄鱼 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ [1/3] 生成梁昕乔课评... ✅ 已保存 [2/3] 生成钟昀昊课评... ✅ 已保存 [3/3] 生成林瀚丞课评... ✅ 已保存 📝 其他学生请假，不生成课评 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✅ 全部完成！已保存 3 人 | 请假 2 人 🗑️ 已清理临时数据文件 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ``` 点击「提交」后： 1. ✅ 数据自动 POST 到本地服务器 2. ✅ 服务器保存为 `.claude/.tmp/evaluation_input_{班级}.json` 3. ✅ 写入信号文件 `EVALUATION_READY.txt` 4. ✅ AI 检测到信号，读取 JSON 数据 5. ✅ 批量生成所有学生课评（180-350字三段式） 6. ✅ 自动保存到标准路径（双轨） 7. ✅ 清理临时数据文件 --- ## 📋 课评生成规则 ### 学生状态处理 - **出勤** → 正常生成课评，保存到 `feedback/` - **请假** → 仅生成请假记录 `(请假).md` - **补课** → 保存到 `补课/feedback/` - **体验** → 保存到 `补课/feedback/` ### 三段式结构（固定不变） ``` 第1段（30-55字）：课程知识点，末尾1个emoji 第2段（100-220字，弹性）：掌握+环节+亮点，1-3个emoji分散插入 第3段（30-55字）：课后建议，末尾1个emoji ``` ### 称呼规则 - 优先用小名/昵称 - 其次用去姓称名 - 单字名叠字化 ### Emoji规则 - 第1段：🔍 💡 ⚙️（根据课程类型） - 第2段：💪 ✨ 📈 🎯（根据亮点） - 第3段：🏠 🔧（根据建议） --- ## 💾 自动保存规则 ### 文件路径（课评规范V1.0标准） ``` .claude/memory/class/{班级}/ ├── summaries/YYYYMMDD_{课程编号}_{班级反馈}.md ├── {学生}/ │ └── feedback/YYYYMMDD_{课程编号}_{课次}.md └──补课/{学生}/ └── feedback/YYYYMMDD_{课程编号}.md ``` ### 无需确认，自动保存！ 课评生成后立即保存，无需教师点击确认。 --- ## 📊 速记符号对照表 | 速记 | 含义 | |------|------| | gj# | 观望#分钟 | | zd# | 主动搭#层 | | zt | 自己调整 | | wb | 完成 | | ↑ | 开心 | | → | 稳定 | | ++ | 比上周进步 | | -- | 需关注 | --- ## 📝 触发方式 **主触发词：** - `/课评` → 启动超级简化流程 - `/keping-simple` → 别名 **不触发其他技能：** - 不要触发 `keping-advanced` 或 `keping-optimizer` --- ## ⚙️ 关键配置 ### 学期周数计算基准 - 开学日期：2026年3月2日 - 周数公式：Floor((当天-3月2日)/7) +1 ### 班级目录路径 ``` .claude/memory/class/{班级名称}/ ``` --- ## ✅ 质量检查清单 - [ ] 字数：180-350（根据输入丰富度） - [ ] 三段式结构完整 - [ ] Emoji位置正确（段末/分散插入） - [ ] 称呼正确（不用全名） - [ ] 无周数显示（正文） - [ ] 路径符合课评规范V1.0 --- *版本：v5.1.0（表单直连提交）* *维护者：穹狼教学团队* *最后更新：2026-05-20*