v1.0.1: 课程成绩异常诊断与报告生成 - 初版骨架

基于匠厂 skill-template 主仓 v1.0.108 派生的业务技能。

核心业务:
- 教师在教务系统录完成绩后自动触发
- 统计指标计算 + 三种异常模式识别(高分低能 / 两极分化 / 挂科异常)
- 生成三段式 AI 评语(总体 / 问题 / 建议)

输出形态:
- HTML 报告(含统计表 + 正态分布图 + AI 评语)
- 高风险课程自动标记 + 异常预警通知

预期提效:教师撰写成绩分析报告的时间从半天 → 10 分钟。

业务行生命周期:无(一次性报告存档,不重复处理)

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
2026-09-14 12:19:12 +08:00
commit 1d20cfa708
21 changed files with 1482 additions and 0 deletions

26
.env.example Normal file
View File

@@ -0,0 +1,26 @@
# 课程成绩异常诊断与报告生成 - 配置示例
# 行头说明「是什么」;行尾说明「怎么填」;进程环境变量 > 用户 .env > 本文件
# 教务系统 API 入口,例如 https://aa.example.edu/api/v1
AA_API_BASE_URL=
# 教务系统 API 调用凭证
AA_API_TOKEN=
# 挂科异常阈值(不及格率超过此值触发预警),默认 0.30
HIGH_FAIL_RATE_THRESHOLD=0.30
# 高分低能阈值(平时分 - 期末分 差值超过此值触发预警),默认 20
SCORE_GAP_THRESHOLD=20
# 两极分化阈值(标准差 / 历史均值 超过此值触发预警),默认 1.5
STD_DEV_RATIO_THRESHOLD=1.5
# 单门课程分析超时(秒),默认 30
ANALYZE_TIMEOUT_SEC=30
# 历史成绩对比窗口(学期数),默认 6 个学期(约 3 年)
HISTORY_WINDOW_SEMESTERS=6
# 错误码前缀,统一为 ERROR: 起头
LOG_LEVEL=INFO