适用场景
这套流程适合需要给一批学习者配 AI 辅导、同时又要看到进度的场景：学校老师带一个班做课后辅导、家长带孩子做单元复习、企业内训负责人带新人补基础。Khanmigo 是 Khan Academy 提供的 AI 辅导与教学辅助工具，学生端偏向「用提问引导思考」，教师端偏向「备课、出题、看学情」。把两者串成一条固定流程，就能从课程设定一路走到可复盘的学习报告。
环境与前置条件
账号与权限
- 一个 Khan Academy 账号，角色选择教师、家长或学习者。教师角色才能建班级、看全班数据。
- Khanmigo 的开放地区、可用功能、是否需要订阅，以官方页面当前说明为准，不同地区和账号类型差异较大。
- 学生账号建议一人一个，不要多人共用，否则进度数据会混在一起。
浏览器与网络
- Chrome、Edge、Firefox、Safari 的近两年内版本，开启 JavaScript 和 Cookie。
- 需要能稳定访问 Khan Academy 的域名。若在受限网络内，先让网络管理员放行，不要用来源不明的代理。
设备与资源
- 学生端建议笔记本或平板，屏幕不小于 10 英寸，方便看图文混排的题目。
- 本地没有特殊内存或磁盘要求。唯一需要占空间的是导出的 CSV 报告，一个班一学期通常不超过几十 MB。
- 如果用表格做汇总，准备一个能打开 CSV 的表格软件即可。
开始前先定三件事
1. 课程范围：学科 + 年级 + 单元，例如「七年级数学·一元一次方程」。
2. 评估口径：完成率、正确率、自主求助次数、错题复现率，选 2 到 3 个就够。
3. 周期：建议 2 到 4 周一轮，太短看不出趋势，太长不易调整。
分步骤部署
第 1 步：建班级并拿到班级码
登录后进入教师端，创建班级，填好班级名称（建议带学期和单元，如「七数-2024春-方程」）。系统会生成一个班级码或邀请链接。
这一步在做什么：把「一批学生」变成「一个可统计的集合」。学生用班级码加入后，他们的练习数据才会汇总到同一个看板。
成功标志：班级列表里出现这个班，能看到班级码，并且可以在成员列表里看到已加入的学生。
第 2 步：把课程结构定下来
在 Khan Academy 的课程库里找到对应单元，按 Course（课程）→ Unit（单元）→ Lesson（课时）三级对齐到自己的教学计划。不要跳过这一步直接发练习，否则后面报告里的数据没法按课时归因。
建议先只挂 1 个单元，跑通整条链路再加第二个。
成功标志：学生登录后能在自己的任务列表里看到被指派的单元和课时。
第 3 步：用 Khanmigo 教师工具生成单元计划
打开 Khanmigo 的教师工具，用下面这个提示词模板。方括号处替换成自己的内容，其余照抄。
```
你是我的教学助理。请为以下单元生成一份教学计划。
学情： [年级] 学生，[人数] 人，其中约 [N] 人 [具体薄弱点，例如：分数运算不熟]。
单元： [单元名称]
课时： [总课时数]，每课时 [分钟数] 分钟
产出要求：
1. 每个课时的学习目标，用「学生能够……」句式，一条不超过 20 字；
2. 每个课时的核心例题 2 道，标注难度（基础/进阶）；
3. 每个课时结束时用于检查理解的 1 个口头提问；
4. 用表格输出，列依次为：课时、学习目标、例题、检查提问。
约束：不要出现超纲内容；不要直接给答案，例题只给题干。
```
这一步在做什么：把「我要教什么」翻译成「每节课具体到什么程度」，这是后面所有练习和评估的锚点。
成功标志：返回一张表，课时数与你的进度表一致，每条学习目标都能对应到具体知识点。
第 4 步：生成分层练习与出口卡
同一个单元，按基础、进阶两档各生成一组练习，再加一张课时结束时的出口卡（exit ticket，3 到 5 题）。
```
基于上一条的单元计划，为「[课时名称]」生成练习。
产出：
A. 基础组 5 题：直接套用概念，数字简单；
B. 进阶组 5 题：需要两步以上推理或实际情境；
C. 出口卡 3 题：覆盖本课时学习目标，限时 5 分钟完成。
每题给出：题干、答案、一句话解析、对应学习目标编号。
禁止出现：与本课时目标无关的知识点。
```
拿到内容后人工过一遍，删掉表述含糊的题，再手动录入到练习或作业中。AI 生成的题必须有人复核，这是流程里不能省的一步。
成功标志：出口卡 3 题做完，能判断学生是「会、半会、不会」三档，而不是全体分数挤在一起。
第 5 步：给学生立使用规则
学生第一次用 Khanmigo 之前，把下面这条规则写进群公告，并当面演示一次：
```
在使用 AI 辅导时，先说三句话再提问：
1. 这道题在问什么；
2. 我已经想到哪一步；
3. 我卡在哪一步。
如果直接索要答案，AI 会拒绝，请改成描述你的思路。
```
这一步在做什么：把 AI 从「抄答案工具」掰回「陪练」。引导式辅导的价值就在于逼学生先表达思路。
成功标志：抽三个学生看他们的对话记录，开头都是「题目在问……我卡在……」，而不是「答案是什么」。
第 6 步：日常辅导循环
给每个学生固定 15 分钟：5 分钟看课时内容，7 分钟做题并在卡住时用辅导对话，3 分钟写一句总结（今天学会了什么、还不会什么）。
学生端有个习惯值得强调：让 AI 出同类型的变式题，而不是重复原题。可以让学生这样输入：
```
我刚刚在 [知识点] 上做错了一道题。请再出 2 道同类型但数字不同的题，
先不要给答案，我做完再对。
```
第 7 步：每周导出数据
进入教师端的进度或活动看板，选择时间范围（本周一到周日），导出 CSV。把文件按固定规则命名，便于归档：
```bash
建议命名：班级-单元-周次-导出日期.csv
mv ~/Downloads/report.csv ~/辅导数据/七数-方程-第3周-20240517.csv
检查文件是否完整可读，看行数和前几行
wc -l ~/辅导数据/七数-方程-第3周-20240517.csv
head -n 3 ~/辅导数据/七数-方程-第3周-20240517.csv
```
成功标志：wc -l 的行数与学生数大致匹配（含表头），head 能看到列名正常。
第 8 步：生成学习报告
先用表格做一次透视：按学生汇总完成率、正确率、出口卡得分。再把汇总结果喂给 AI 生成报告草稿。
```
以下是一个班级本周的学习数据摘要（表格）。请生成一份学习报告草稿。
要求：
1. 分三部分：整体概览、需要关注的学生（列出具体表现，不贴姓名，用学号）、下周建议；
2. 每个判断后面附上对应的数据依据；
3. 不下「聪明/笨」这类评价，只描述行为和结果；
4. 全文不超过 600 字。
```
拿到草稿后人工改名、加具体沟通话术，再发给家长或学员本人。
验证部署是否成功
按顺序跑一遍，全部通过说明流程可用：
1. 成员校验：教师端班级成员数 == 实际学生数。
2. 链路校验：让一个学生完成一次练习并提交，5 分钟内看板能刷出这条记录。
3. 生成校验：用第 3 步的提示词跑一次，返回值包含表格且列数与要求一致。
4. 导出校验：导出 CSV，用表格软件打开，行数与看板一致，学号列无空行。
5. 报告校验：跑一次第 8 步，报告里每条结论都能在数据里找到出处，没有凭空出现的评价。
常见报错与解决
1. 学生端找不到 Khanmigo 入口，按钮是灰的
- 原因：账号类型不对（学生误用家长账号），或所在地区/账号未开通该功能，或未成年人账号缺少必要的家长同意设置。
- 解决：确认学生用自己的账号登录；到账号设置里检查角色与家长关联状态；功能可用范围以官方页面为准，若确实未开放，先用教师端生成的练习替代。
2. 看板里进度全为空，导出的 CSV 只有表头
- 原因：学生没有通过班级码加入，或用另一个账号在做题，数据没归到同一个班。
- 解决：让学生退出后重新用班级码加入；教师端核对成员列表；导出前确认时间范围覆盖了实际做题日期。
3. CSV 在表格软件里中文乱码
- 原因：文件是 UTF-8 编码，部分表格软件默认按本地编码解析。
- 解决：用带 BOM 的方式打开或转换后另存。
```bash
加 BOM 便于部分表格软件识别
printf '\xEF\xBB\xBF' > /tmp/bom.csv && cat report.csv >> /tmp/bom.csv && mv /tmp/bom.csv report_utf8bom.csv
```
4. AI 回复「我无法回答这个问题」或直接拒答
- 原因：提问里带了个人的敏感信息，或直接索要答案，或表述过于模糊。
- 解决：去掉姓名、电话、住址；把「给我答案」改成「我已经做到这一步，卡在这里」；补充年级和知识点。
5. 生成的练习超纲或太笼统
- 原因：提示词里没写学情和约束。
- 解决：补上「学情」「禁止出现与本课时无关的知识点」「例题只给题干」这几条，再重跑一次；仍然不行就缩小到单个知识点重试。
后续维护
备份
每周导出后立刻归档，不要留在下载目录。目录结构建议按「学期/班级/单元」分层，文件名带周次和日期。每四周把整季 CSV 打包一次：
```bash
cd ~/辅导数据 && tar -czf 七数-方程-第1-4周.tar.gz 七数-方程-第*周-*.csv
```
升级
Khanmigo 和 Khan Academy 的界面、功能会持续调整，以官方页面当前说明为准。每次官方更新后，先在一个小班或一个学生身上试跑一遍第 3、6、7 步，确认提示词输出格式没变，再推给全班。
日志与监控
- 每周固定时间看板一次，重点看两类人：完成率骤降的、出口卡连续两次低分的。
- 把提示词当代码管理：每个单元一套提示词，改动时记下日期和改动原因，方便回溯「哪次改动之后出题质量变差了」。
- 报告只发结论和建议，不发原始数据明细，避免把学生之间做横向排名。
- 每轮结束时做一次小结：这套提示词还适用吗？评估口径要不要换？下一个单元从哪一步开始复用自己的模板？把答案写下来，下一轮直接照抄，流程才算真正沉淀下来。