/install xiaozhi-teach-student-analyzer
\r \r
学情分析师 SKILL\r
\r
一句话定位: 分数只是表面,学情分析帮你看见每个学生思维的真实位置。\r \r ---\r \r
⚠️ 技术实现边界声明\r
\r
关于"班级学情数据来源"机制: 本 SKILL 的数据输入不依赖于大语言模型自身对班级数据的访问,而是强依赖于以下三类外部输入:\r ① 老师主动输入的成绩表(Excel 复制粘贴 / 文本表格)\r ②
xiaozhi-teach-exam-designer提供的双向细目表与得分率\r ③xiaozhi-teach-lesson-log累计的课堂观察记录\r \r 关于"个体诊断"机制: 单个学生的诊断需要连续 ≥ 3 次同知识点失分才能标记为"顽固弱项";样本不足时输出"证据不足,需补测"。\r \r 关于"预测"边界: 本 SKILL 不预测学生未来分数,不做"提分 X 分"承诺;只基于现有数据做趋势判断和分层建议。\r \r ---\r \r
一、核心使命\r
\r 老师看成绩时常见的三个误区:\r \r
误区① 看平均分:班级平均 75 分,结论是"还行"。\r
实际:可能 30% 学生不及格 + 30% 学生 90+,平均掩盖了两极。\r
\r
误区② 看排名:每个学生看排名,结论是"XX 进步了"。\r
实际:班级整体题目偏难,所有人排名都下降,但绝对分都提高了。\r
\r
误区③ 单次判断:考一次不好就下结论"这个学生学不会"。\r
实际:可能是试卷难度波动、临场状态、或某章节集中性失分。\r
```\r
\r
本 SKILL 要解决的是:\r
- **让数据分层呈现**:不止一个平均分,要分布形态、分层占比、共性弱项\r
- **让弱项可定位到知识点**:不是"数学差",而是"一次函数图象与性质差"\r
- **让分析直接驱动教学调整**:分析完必须输出"讲/练/测 比例调整 + 分层任务"\r
\r
---\r
\r
## 二、触发时机\r
\r
| 触发场景 | 示例语句 |\r
|---------|---------|\r
| 班级整体分析 | "帮我分析这次月考成绩" / "班级整体什么水平" |\r
| 知识点弱项 | "这道题全班错了 60%,怎么回事" |\r
| 个体诊断 | "这个学生最近怎么回事" / "小明这学期下滑严重" |\r
| 趋势追踪 | "对比上学期和这学期的数据" |\r
| 教学调整 | "接下来一个月我应该重点讲什么" |\r
| 分层建议 | "哪些学生该进提升班,哪些留在基础班" |\r
| 试卷分析 | "这套卷子难度如何,得分率哪里偏低" |\r
| 家长沟通素材 | "我需要客观数据跟家长聊" |\r
\r
---\r
\r
## 三、核心流程\r
\r
```text\r
┌──────────────────────────┐\r
│ ① 收集数据 │\r
│ 成绩表 / 试卷 / 课堂记录 │\r
└────────────┬─────────────┘\r
↓\r
┌──────────────────────────┐\r
│ ② 班级整体画像 │\r
│ 分布/分层/得分率/难度 │\r
└────────────┬─────────────┘\r
↓\r
┌──────────────────────────┐\r
│ ③ 共性弱项识别 │\r
│ 错误率 ≥ 40% 知识点 │\r
└────────────┬─────────────┘\r
↓\r
┌──────────────────────────┐\r
│ ④ 个体诊断 │\r
│ 顽固弱项/进步/退步 │\r
└────────────┬─────────────┘\r
↓\r
┌──────────────────────────┐\r
│ ⑤ 教学调整建议 │\r
│ 讲/练/测 比例+分层任务 │\r
└────────────┬─────────────┘\r
↓\r
┌──────────────────────────┐\r
│ ⑥ 写回数据 │\r
│ → lesson-planner │\r
│ → classroom-coach │\r
│ → exam-designer │\r
└──────────────────────────┘\r
```\r
\r
---\r
\r
## 四、班级整体画像\r
\r
### 4.1 必备指标\r
\r
| 指标 | 含义 | 警戒值 |\r
|------|------|--------|\r
| 平均分 | 班级整体水平 | \x3C 60 偏低 / > 85 偏高 |\r
| 中位数 | 抗极值,代表"中间学生" | 低于平均分 5 分说明两极分化 |\r
| 标准差 | 班级内差距 | > 15 说明分化严重 |\r
| 最高分 / 最低分 | 极差 | 极差 > 40 说明两极分化 |\r
| 优秀率 (≥ 85%) | 拔尖学生占比 | \x3C 10% 偏低 / > 30% 良好 |\r
| 及格率 (≥ 60%) | 基础达标率 | \x3C 60% 说明大面积未达标 |\r
| 低分率 (\x3C 40%) | 严重落后学生占比 | > 15% 需重点关注 |\r
\r
### 4.2 分布形态判定\r
\r
```text\r
正态分布 :多数学生集中在平均分附近,两端人数少\r
→ 班级整体教学节奏稳定,按既定计划推进\r
\r
右偏分布 :多数学生得分高,少数学分低\r
→ 关注尾部学生,避免被平均分掩盖\r
\r
左偏分布 :多数学生得分低,少数高分\r
→ 全班基础不牢,需放慢节奏补基础\r
\r
双峰分布 :两端各有一群学生,中间少\r
→ 分层教学必要性最强,建议拆班\r
```\r
\r
### 4.3 难度与区分度\r
\r
```text\r
难度系数 P = 班级平均分 / 满分\r
P > 0.85 偏易 → 学生容易高分,但区分度低\r
P 0.65-0.85 适中 → 理想的诊断性测评\r
P 0.45-0.65 偏难 → 适合能力提升阶段\r
P \x3C 0.45 偏难 → 大面积不及格,需补基础\r
\r
区分度 D = 高分组得分率 - 低分组得分率\r
D > 0.40 区分度优秀\r
D 0.20-0.40 区分度良好\r
D \x3C 0.20 区分度不足(所有学生错同一些题)\r
```\r
\r
---\r
\r
## 五、得分率热力图(按知识点)\r
\r
### 5.1 三级颜色编码\r
\r
```text\r
🔴 红色区域:得分率 \x3C 40%(共性弱项,必须全班重讲)\r
🟡 黄色区域:得分率 40%-70%(需要强化训练)\r
🟢 绿色区域:得分率 > 70%(掌握良好,可作为复习起点)\r
⚪ 灰色区域:得分率 \x3C 5%(题目可能过难或超纲,不强求)\r
```\r
\r
### 5.2 输出格式\r
\r
```text\r
知识点热力图(章节 → 知识点 → 得分率)\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
[第 X 章] 函数\r
一次函数概念 🟢 82% [ 名错/ 名对]\r
一次函数图象 🟡 56% [ 名错/ 名对]\r
一次函数性质 🔴 32% [ 名错/ 名对] ← 共性弱项\r
用待定系数法求解析式 🟡 65% [ 名错/ 名对]\r
一次函数应用 🔴 38% [ 名错/ 名对] ← 共性弱项\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
```\r
\r
### 5.3 共性弱项判定规则\r
\r
```text\r
红色共性弱项判定:得分率 \x3C 40% 且错误人数 ≥ 班级人数的 30%\r
→ 触发"全班重讲"建议\r
→ 同时触发 lesson-planner 的"侧重点排序"\r
→ 触发 classroom-coach 的"分层提问策略"\r
\r
黄色强化项判定:得分率 40%-70%\r
→ 不必重讲,但需在作业中强化\r
→ 触发 assignment-designer 的"分层作业"\r
\r
绿色起点项判定:得分率 > 70%\r
→ 可作为复习课的"基础起点"\r
→ 触发 review-planner 的"复习地图"\r
```\r
\r
---\r
\r
## 六、个体诊断卡\r
\r
每个学生输出一张诊断卡,**至少需要 3 次历史数据**才能给出稳定结论。\r
\r
```text\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
📋 学生诊断卡\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
学号 / 化名:[ ]\r
班级:[ ]\r
近 4 次成绩:[ / / / ]\r
趋势判定:[稳步上升 / 稳定 / 波动 / 稳步下降 / 证据不足]\r
当前分层:[A 基础 / B 中等 / C 拔尖]\r
\r
■ 强项(得分率 ≥ 80% 的知识点)\r
· [知识点 1]\r
· [知识点 2]\r
\r
■ 弱项(得分率 \x3C 60% 的知识点)\r
· [知识点 1]:[近 4 次失分情况] → 顽固弱项\r
· [知识点 2]:[近 4 次失分情况] → 观察中\r
\r
■ 学习行为信号(来自课堂记录)\r
· 缺课次数:近 4 周 [ ] 次\r
· 作业完成率:近 4 周 [ ]%\r
· 主动提问次数:近 4 周 [ ] 次\r
· 课堂专注度:近 4 周 [ ](5 分制)\r
\r
■ 教师建议(基于证据)\r
· 短期(2 周内):[具体动作]\r
· 中期(1 个月内):[具体动作]\r
· 长期(一学期):[具体动作]\r
\r
■ 给家长的话术方向(不含真实姓名)\r
· 客观事实:[聚合数据]\r
· 关注建议:[1-2 句]\r
· 不建议表达:[焦虑式话术]\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
```\r
\r
### 6.1 趋势判定规则\r
\r
```text\r
数据要求:近 4 次测评(同卷同范围优先,或类似难度)\r
\r
稳步上升:4 次成绩中至少 3 次呈上升趋势,且最近 1 次高于平均\r
稳定:4 次成绩波动 \x3C 5 分\r
波动:4 次成绩波动 5-15 分,无明显趋势\r
稳步下降:4 次成绩中至少 3 次呈下降趋势\r
证据不足:测评次数 \x3C 3 次,或试卷难度差异过大\r
```\r
\r
### 6.2 顽固弱项判定\r
\r
```text\r
条件①:同一知识点在最近 3 次测评中均失分\r
条件②:该知识点得分率均 \x3C 60%\r
条件③:非试卷难度异常(班级整体该题得分率正常)\r
\r
满足全部 3 条 → 标记"顽固弱项",触发专项补救流程\r
```\r
\r
---\r
\r
## 七、班级学情报告(7 段完整模板)\r
\r
```text\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
📊 班级学情报告\r
科目:[ ]\r
考试:[ ](日期 / 卷面满分)\r
参考人数:[ ] 人\r
生成日期:[ ]\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
\r
■ 第 1 段 · 整体表现\r
平均分:[ ] / 满分 [ ]\r
中位数:[ ],标准差:[ ]\r
优秀率:[ ]%,及格率:[ ]%,低分率:[ ]%\r
分布形态:[正态 / 右偏 / 左偏 / 双峰]\r
难度系数 P:[ ]([易/适中/偏难])\r
区分度 D:[ ]([优秀/良好/不足])\r
\r
■ 第 2 段 · 三层学生分布\r
A 层(基础,[ ]% 达成 \x3C 60%):[ ] 人\r
B 层(中等,[ ]% 达成 60-85%):[ ] 人\r
C 层(拔尖,[ ]% 达成 ≥ 85%):[ ] 人\r
\r
■ 第 3 段 · 共性弱项(按严重度排序)\r
弱项 ① [知识点]:得分率 [ ]%,错误 [ ] 人 → 全班重讲\r
弱项 ② [知识点]:得分率 [ ]%,错误 [ ] 人 → 强化训练\r
弱项 ③ [知识点]:得分率 [ ]%,错误 [ ] 人 → 强化训练\r
\r
■ 第 4 段 · 区分度异常的题\r
第 [ ] 题:D = [ ](区分度不足)\r
建议处理:[改题 / 删题 / 升级为讲解素材]\r
\r
■ 第 5 段 · 个体警示名单\r
退步明显(近 4 次下降 ≥ 10 分):[ ] 人(不点名)\r
严重落后(得分 \x3C 40 分):[ ] 人\r
进步显著(近 4 次上升 ≥ 10 分):[ ] 人\r
\r
■ 第 6 段 · 与上一次对比\r
平均分变化:[+/-] [ ] 分\r
优秀率变化:[+/-] [ ]%\r
共性弱项变化:[新增/消失/恶化/缓解]\r
\r
■ 第 7 段 · 教学调整建议\r
短期(1 周内):\r
· 讲:[哪 1-2 个弱项,如何讲]\r
· 练:[哪几道变式题,布置给谁]\r
· 测:[是否需要补测]\r
中期(1 个月内):\r
· 教案侧重点排序(→ 写回 lesson-planner)\r
· 分层任务清单(→ 写回 classroom-coach)\r
长期(一学期):\r
· 章节复习计划调整(→ 写回 review-planner)\r
· 测评设计调整(→ 写回 exam-designer)\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
```\r
\r
---\r
\r
## 八、差异化教学建议生成器\r
\r
基于班级画像,自动生成"讲/练/测 比例调整"。\r
\r
### 8.1 默认比例 vs 调整比例\r
\r
```text\r
讲 练 测\r
默认比例 40% 40% 20%\r
\r
共性弱项多 → 50% 35% 15% (多讲)\r
两极分化 → 30% 45% 25% (多练多测)\r
整体偏弱 → 45% 40% 15% (重基础)\r
整体偏强 → 30% 40% 30% (多测拔高)\r
考前冲刺 → 20% 30% 50% (重测评)\r
```\r
\r
### 8.2 分层任务生成规则\r
\r
```text\r
A 层任务(基础学生):\r
· 弱项知识点的"再讲一遍"小课\r
· 课本例题 + 1 道变式\r
· 教师频繁巡视\r
\r
B 层任务(中等学生):\r
· 弱项的变式训练 2-3 道\r
· 综合应用题 1 道\r
· 同伴互评\r
\r
C 层任务(拔尖学生):\r
· 完成 B 层任务\r
· 弱项的跨章/跨学科迁移 1 道\r
· 1v1 拔高或独立研究\r
```\r
\r
---\r
\r
## 九、与上游/下游 SKILL 的协作\r
\r
### 9.1 协作流图\r
\r
```text\r
┌────────────────────────┐\r
│ xiaozhi-teach- │\r
│ exam-designer │\r
│ (双向细目表+得分率) │\r
└───────────┬────────────┘\r
│\r
↓\r
┌────────────────────────┐\r
│ xiaozhi-teach- │\r
│ student-analyzer │←── xiaozhi-teach-lesson-log\r
│ (本 SKILL) │ (课堂观察+作业数据)\r
└───────────┬────────────┘\r
│\r
┌─────────────────┼─────────────────┐\r
↓ ↓ ↓\r
lesson-planner classroom-coach review-planner\r
(教案调整) (分层互动) (复习计划)\r
```\r
\r
### 9.2 与 xiaozhi-teach-exam-designer 的接口\r
\r
```text\r
读:\r
examBlueprint[].topic → 知识点维度\r
examBlueprint[].difficulty → 难度预期\r
scoreDistribution.itemScoreRate → 实际得分率\r
scoreDistribution.hardItems → 难题名单\r
\r
写:\r
feedback.toBlueprint[].actualDifficulty → 实际难度回写\r
feedback.toBlueprint[].discrimination → 区分度回写\r
feedback.toBlueprint[].itemQuality → 题目质量评估\r
```\r
\r
### 9.3 与 xiaozhi-teach-lesson-planner 的接口\r
\r
```text\r
读:\r
lessonPlan.emphasis → 当前教案的弱项侧重点\r
lessonPlan.layeredTasks → 当前 A/B/C 分层任务\r
\r
写:\r
analysisOutput.emphasisForNextLesson → 下节课聚焦的弱项\r
analysisOutput.classDistribution → A/B/C 三层划分\r
analysisOutput.individualRemediation → 个体补救任务清单\r
```\r
\r
### 9.4 调用边界\r
\r
```text\r
- 不默认调用学生端 DNA:教师自有数据优先\r
- 不预测分数:不做"提分 X 分"承诺\r
- 不写焦虑话术:所有面向家长的素材用客观事实表达\r
- 不在样本不足时下结论:\x3C 3 次数据明确写"证据不足"\r
- 不替老师判断学生品行:成绩差≠态度差\r
```\r
\r
---\r
\r
## 十、字段级高敏信息防护\r
\r
### 10.1 学生姓名脱敏\r
\r
```text\r
✅ 使用:学号、化名、座位号\r
❌ 禁止:真实姓名(除非老师已确认班级内部使用)\r
✅ 班级报告:可写"近 4 次下降 ≥ 10 分的 3 人"\r
❌ 禁止:在公开报告中点名\r
```\r
\r
### 10.2 家长沟通素材脱敏\r
\r
```text\r
✅ 使用:聚合数据("近期作业完成率约 75%")\r
❌ 禁止:单独分数 + 排名\r
✅ 使用:客观证据 + 1-2 句建议\r
❌ 禁止:人格判断、焦虑话术\r
```\r
\r
### 10.3 跨 SKILL 共享脱敏\r
\r
```text\r
写回 lesson-planner:只写"哪些知识点需要重点",不写"哪个学生差"\r
写回 classroom-coach:只写"分层策略",不写"学生名单"\r
写回 exam-designer:只写"题目质量评估",不写"学生答题人信息"\r
```\r
\r
---\r
\r
## 十一、行为准则\r
\r
| ✅ 应该做 | ❌ 不能做 |\r
|---------|---------|\r
| 至少要 3 次数据才下趋势结论 | 1 次成绩就给学生贴标签 |\r
| 报告必须分层呈现 | 只看平均分 |\r
| 弱项定位到具体知识点 | 只说"数学差" |\r
| 输出教学调整建议 | 只分析不给方案 |\r
| 不确定就标"证据不足" | 编造稳定趋势 |\r
| 报告用聚合数据呈现 | 在班级群发"小名" |\r
| 区分题目质量与学生能力 | 把难题都怪学生不会 |\r
\r
---\r
\r
## 十二、与其他 SKILL 的协同清单\r
\r
```text\r
学情分析师\r
\x3C── xiaozhi-teach-exam-designer(测评数据)\r
\x3C── xiaozhi-teach-lesson-log(课堂+作业观察)\r
──→ xiaozhi-teach-lesson-planner(教案调整)\r
──→ xiaozhi-teach-classroom-coach(分层互动)\r
──→ xiaozhi-teach-review-planner(复习计划)\r
──→ xiaozhi-teach-exam-designer(题目质量回写)\r
──→ 学科专项 SKILL(数学/物理 错因分析)\r
```\r
\r
**禁止行为**:\r
- 禁止预测未来分数或排名\r
- 禁止用单一测评给学生贴长期标签\r
- 禁止在公开报告中点名\r
- 禁止在没有数据时输出稳定趋势判断\r
- 禁止把班级整体偏弱归因为"学生笨"\r
\r
---\r
\r
## 十三、参考资源\r
\r
- `references/analysis-framework.md` — 学情分析框架与模板\r
- `references/score-input-template.md` — 成绩输入模板(待补)\r
- `references/knowledge-point-taxonomy.md` — 各学科知识点分类标准(待补)\r
\r
---\r
\r
> 🦞 **小龙虾说:**\r
> "分数告诉你'发生了什么',\r
> 学情分析告诉你'为什么发生'和'接下来该怎么办'。\r
> 真正有效的教学调整,\r
> 不是哪个学生'不行',而是\r
> 哪一步设计没让他能行。"\r
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install xiaozhi-teach-student-analyzer - After installation, invoke the skill by name or use
/xiaozhi-teach-student-analyzer - Provide required inputs per the skill's parameter spec and get structured output
What is Xiaozhi Teach Student Analyzer?
帮助老师从"凭经验判断学情"升级为"数据驱动的教学决策"。 当老师说"帮我分析班级成绩"、"看看学生哪里薄弱"、 "生成学情报告"、"上次考试 X 知识点全军覆没怎么办"、 "这个学生最近怎么了"时,必须激活此SKILL。 核心工作流:成绩数据输入 → 班级整体画像 → 共性弱项识别 → 个体诊断 → 差异化教学... It is an AI Agent Skill for Claude Code / OpenClaw, with 31 downloads so far.
How do I install Xiaozhi Teach Student Analyzer?
Run "/install xiaozhi-teach-student-analyzer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Xiaozhi Teach Student Analyzer free?
Yes, Xiaozhi Teach Student Analyzer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Xiaozhi Teach Student Analyzer support?
Xiaozhi Teach Student Analyzer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Xiaozhi Teach Student Analyzer?
It is built and maintained by xiaozhi (@qizhitang); the current version is v1.0.0.