| name | xiaozhi-teach-homework-tracker |
| display_name | 作业跟进管家 |
| version | 1.0.0 |
| author | 小智伴学 |
| category | 独立教师 |
| tags | ["作业跟进","错题回流","状态追踪","预诊断","独立教师"] |
| description | 帮助独立教师把"作业收上来"升级为"作业全生命周期管理"。 当老师说"作业跟进"、"作业完成度"、 "错题回流"、"下节课预诊断"、 "作业没交怎么办"、"作业状态怎么追"时，建议激活此SKILL。 核心工作流：作业布置登记 → 完成度追踪 → 错题回流（→ student-analyzer）→ 顽固弱项标记 → 下节课预诊断 → 学员作业画像 → 与 xiaozhi-teach-assignment-designer / student-analyzer / lesson-log / solo-dashboard 建立数据接口。 该版本基于"作业是诊断工具而非任务"的理念， 让每份作业都为下一节课服务。
|
| compatibility | OpenClaw / ClawHub |
| depends_on | xiaozhi-teach-solo-dashboard, xiaozhi-teach-assignment-designer, xiaozhi-teach-student-analyzer, xiaozhi-teach-lesson-log |
| id | openclaw:xiaozhi-teach-homework-tracker |
| min_platform_version | 2.0 |
| max_round_limit | 12 |
作业跟进管家 SKILL
一句话定位： 作业不是任务清单，而是下一节课的诊断 X 光——跟进它，不是为了完成它，而是为了发现下一节课该讲什么。
⚠️ 技术实现边界声明
关于"作业数据"边界： 本 SKILL 仅追踪学习相关低敏信息（作业完成度/错题类型/提交时间）；不收集作业内容、答案、家庭辅导情况等高敏信息。
关于"催交作业"边界： 本 SKILL 不自动向家长或学员发催交消息；所有催交流由老师通过 parent-communication 发出。
关于"批改"边界： 本 SKILL 输出错题回流清单与下节课预诊断，不替老师判分；判分仍由老师完成。
一、核心使命
独立教师作业跟进常见的三个误区：
误区① 收了就忘：作业布置出去后缺乏系统追踪，
完成度、错题率、顽固弱项全凭印象。
误区② 批完归档：作业批改完就放在一边，
错题没有回流到下一节课教案，
学生错过的题目反复错。
误区③ 一刀切催交：对所有学生用同一种方式催交，
不知道谁是"真的不会"谁是"忘了交"。
本 SKILL 要解决的是：
- 让每份作业都有完整追踪：布置 → 提交 → 批改 → 错题 → 回流
- 让错题回流到下一节课：基于作业错题做预诊断
- 让跟进有节奏：分情况催交（真不会 / 忘了 / 拖延）
- 让作业数据反哺教学：作业数据 → student-analyzer → lesson-log
二、触发时机
| 触发场景 | 示例语句 |
|---|
| 作业跟进 | "作业跟进" / "[化名] 的作业状态" |
| 完成度 | "作业完成度" / "哪些学生没交" |
| 错题回流 | "错题回流" / "错题怎么进入下节课" |
| 下节课预诊断 | "下节课讲什么" / "作业反映什么问题" |
| 作业没交 | "[化名] 作业没交怎么办" |
| 顽固弱项 | "[化名] 这道题错 3 次了" |
| 作业画像 | "看一下 [化名] 的作业画像" |
三、核心流程
┌──────────────────────────┐
│ ① 作业布置登记 │
│ 来源：assignment-designer │
└────────────┬─────────────┘
↓
┌──────────────────────────┐
│ ② 完成度追踪 │
│ 提交/部分/未交/补交 │
└────────────┬─────────────┘
↓
┌──────────────────────────┐
│ ③ 批改完成 │
│ 老师/AI 辅助 │
└────────────┬─────────────┘
↓
┌──────────────────────────┐
│ ④ 错题回流 │
│ → student-analyzer │
└────────────┬─────────────┘
↓
┌──────────────────────────┐
│ ⑤ 顽固弱项标记 │
│ 同知识点 3 次错 │
└────────────┬─────────────┘
↓
┌──────────────────────────┐
│ ⑥ 下节课预诊断 │
│ → lesson-log │
└────────────┬─────────────┘
↓
┌──────────────────────────┐
│ ⑦ 写回 solo-dashboard │
│ 作业画像 │
└──────────────────────────┘
四、作业状态（对齐工作空间 schema）
每份作业的 status 取值须为 schema.homeworkFollowup.status 枚举之一（已布置/已提交/部分提交/未交/已批改/已订正/已减免）：
┌──────────┬────────────────────────┬────────────┬──────────────┐
│ 状态 │ 定义 │ 触发动作 │ 时长限制 │
├──────────┼────────────────────────┼────────────┼──────────────┤
│ 已布置 │ 已布置、尚未到截止 │ 等待提交 │ — │
│ 已提交 │ 在截止时间内完整提交 │ 等待批改 │ 0-3 天 │
│ 部分提交 │ 提交部分内容/部分完成 │ 提醒补交 │ 1-3 天 │
│ 未交 │ 截止时间未提交 │ 催交流 │ 当天 │
│ 已批改 │ 老师完成批改 │ 错题回流 │ 1-7 天 │
│ 已订正 │ 学员完成订正 │ 错题归档到错题本 │ — │
│ 已减免 │ 经沟通减免本次作业 │ 记录说明 │ — │
└──────────┴────────────────────────┴────────────┴──────────────┘
说明："错题归档到错题本"是 已订正 后的下游动作，不是独立状态。
五、完成度追踪
5.1 学员作业完成度视图
📎 完整模板见 references/completion-tracking-views.md（学员作业完成度视图填写模板：本周作业状态、完成度统计、与上周对比、错题统计）
5.2 班级作业完成度视图
📎 完整模板见 references/completion-tracking-views.md（班级作业完成度视图填写模板：整体完成度、未交/部分提交学员名单）
5.3 催交流分层
■ 学员视角（私下沟通）
时机：作业截止当晚/第二天
话术：
"我看你 [X 作业] 没交，是不是 [X 原因]？
如果有困难，我们可以 [X 帮助方式]。"
■ 家长视角（家长沟通）
时机：连续 2 次未交
话术（parent-communication）：
"[X 妈/爸，[化名] 这两次 [X 作业] 都没交。
我想了解一下原因。
如果是 [X 难度问题]，我们会 [X 调整]。
如果是 [X 时间问题]，我们也可以 [X 调整]。"
■ 教学诊断（自我反思）
自我问：
1. 是不是作业太难了？
2. 是不是作业量太大了？
3. 是不是上课没听懂？
4. 是不是学习习惯需要支持？
六、批改完成与错题回流
6.1 批改四类标记
✓ 完全正确
▲ 思路对但计算/书写错
? 思路不清/不完整
✗ 思路错误
?✓ 部分对
# 超纲或独特解法
6.2 错题回流清单
📎 完整模板见 references/error-reflow-checklist-template.md（错题回流清单填写模板：班级共性错题、个体错题、顽固错题、错题归属）
6.3 错因分类
┌──────────┬────────────┬──────────────┐
│ 错因 │ 描述 │ 跟进动作 │
├──────────┼────────────┼──────────────┤
│ 概念模糊 │ 知识点没掌握│ 重读课本+讲解 │
│ 规则错误 │ 规则记错 │ 规则梳理+变式 │
│ 审题错误 │ 没看清题目 │ 审题习惯训练 │
│ 策略错误 │ 方法不当 │ 方法优化+同类 │
│ 计算错误 │ 思路对算错 │ 计算训练+检查 │
│ 粗心大意 │ 跳步/笔误 │ 习惯养成 │
│ 知识漏洞 │ 缺前置知识 │ 补前置+再练 │
└──────────┴────────────┴──────────────┘
七、顽固弱项标记
7.1 触发条件
■ 触发顽固标记
· 同一知识点错 3 次（无论是否同一题型）
· 同一道题错 3 次
· 同类错因连续 2 次
■ 升级为高危
· 同一知识点错 5 次
· 连续 3 次作业同知识点错
7.2 顽固弱项档案
📎 完整模板见 references/persistent-weakness-file-template.md（顽固弱项档案填写模板：知识点、错因、跟进动作、状态）
7.3 写回 student-analyzer
· 错题回流数据（每次作业）
· 顽固弱项标记（3 次触发）
· 错因分布（聚合）
· 完成度趋势
→ student-analyzer 接收
→ 班级画像 + 个体诊断卡更新
八、下节课预诊断
8.1 预诊断三步走
第 1 步：错题聚合
· 把本次作业的错题分类
· 区分共性 vs 个体
第 2 步：教学决策
· 共性错题：下节课必须讲
· 个体错题：分层任务卡覆盖
· 顽固错题：需要专项突破
第 3 步：教案衔接
· 把错题分析写入教案
· 调整下节课重点
8.2 预诊断输出
📎 完整模板见 references/pre-diagnosis-output-template.md（下节课预诊断输出填写模板：必须讲/选讲/个体关注/教案调整建议）
8.3 写回 lesson-log
· 错题清单（带错因）
· 教案调整建议
· 重点关注学员
→ lesson-log 在下次课后记录中跟踪
九、学员作业画像
9.1 单学员画像
📎 完整模板见 references/student-homework-profile-template.md（单学员作业画像填写模板：完成度趋势、错因分布、顽固错题清单、错题订正率）
9.2 写回 solo-dashboard
· 学员作业画像
· 风险标记（连续 3 次未交等）
· 课时消耗（作业不扣课时）
→ solo-dashboard 显示
→ 学员档案持续累积
十、风险学员标记
■ 触发条件
· 连续 3 次未交作业
· 连续 5 次部分提交
· 错题率 > 50% 持续 2 周
· 顽固错题超过 5 个
■ 风险等级
· 中度：连续 2 次未交
· 高度：连续 3 次未交 或 错题率 > 60%
· 立即：连续 4+ 次未交 或 错题率 > 80%
■ 应对
· 中度：私下沟通 + 调整作业
· 高度：与家长沟通 + 教学调整
· 立即：升级处理（家长会议/暂停/转介）
十一、与上游/下游 SKILL 的协作
11.1 协作流图
┌────────────────────────┐
│ xiaozhi-teach- │
│ assignment-designer │
│ （作业布置） │
└───────────┬────────────┘
│
↓
┌────────────────────────┐
│ xiaozhi-teach- │
│ homework-tracker │
│ （本 SKILL） │
└───────────┬────────────┘
│
┌─────────────────┼─────────────────┐
↓ ↓ ↓
student-analyzer lesson-log solo-dashboard
（错题回流） （预诊断） （作业画像）
│
↓
┌────────────────────────┐
│ xiaozhi-teach- │
│ parent-communication │
│ （催交/反馈） │
└────────────────────────┘
11.2 接口
读（均来自共享工作空间 solo-teacher-workspace.schema.json）：
workspace.homeworkFollowups[].task / .dueDate
→ 作业布置内容与截止时间（由 assignment-designer 登记）
workspace.studentCards[].primaryWeaknesses / .goals / .gradeLevel
→ 学员基线（弱项、目标、年级）
workspace.lessonLogs[].nextLessonFocus
→ 上次课设定的下节课重点
写（落地到真实存储字段的项）：
workspace.homeworkFollowups[].status
→ 作业状态（已布置/已提交/部分提交/未交/已批改/已订正/已减免）
workspace.homeworkFollowups[].mainErrors / .nextAction
→ 错题回流原始数据（错因、知识点）与跟进动作
workspace.studentCards[].primaryWeaknesses
→ 顽固弱项写回学员卡（追加/更新弱项标签）
workspace.progressEvidence[]（evidenceType/description/date）
→ 订正、攻克顽固错题等过程证据
派生视图（非存储字段，由上述真实字段实时计算，不落库）：
完成度 completionRate
→（派生视图，非存储字段：由 workspace.homeworkFollowups[].status 聚合计算）
错因分布 errorTendency
→（派生视图，非存储字段：由 workspace.homeworkFollowups[].mainErrors 聚合统计）
顽固弱项触发标记 persistentMistakes
→（派生视图，非存储字段：由 workspace.homeworkFollowups[].mainErrors 跨次比对，
同知识点/同错因达阈值时触发；触发后将弱项写回 studentCards[].primaryWeaknesses）
风险标记 riskFlag
→（派生视图，非存储字段：由 workspace.homeworkFollowups[].status 连续统计得出）
生成的报告段落（非工作空间存储字段；事实来源见括注）：
下节课预诊断 preDiagnosis
→（生成的报告段落，非存储字段；事实来源为 workspace.homeworkFollowups[].mainErrors，
其结论以 workspace.lessonLogs[].nextLessonFocus 形式回写并被 lesson-log 跟踪）
下游交接（口头/报告交接，非字段写入）：
→ student-analyzer 接收错题回流与顽固弱项
→ lesson-log 接收下节课预诊断
→ solo-dashboard 呈现作业画像与风险标记
→ parent-communication 接收催交/反馈事实
十二、字段级高敏信息防护
✅ 追踪中可使用：化名、作业完成度、错题类型、提交时间
❌ 禁止：作业具体答案、家庭辅导情况、家长监督方式
✅ 写回数据：聚合错因、完整体成度
❌ 不写回：在公开数据中暴露学员真实身份
✅ 错题回流：含错因、知识点
❌ 禁止：错题原文（只存错因和知识点）
十三、行为准则
| ✅ 应该做 | ❌ 不能做 |
|---|
| 错题回流到下一节课 | 错题只批不改 |
| 顽固弱项标记 + 跟进 | 同一错题错 3 次仍未专项 |
| 完成度分层催交 | 一刀切催交所有学生 |
| 预诊断基于真实错题 | 凭印象决定下节课重点 |
| 学员作业画像累积 | 学员作业表现全无记录 |
| 写回数据脱敏 | 公开作业记录暴露真实姓名 |
十四、与其他 SKILL 的协同清单
作业跟进管家
<── xiaozhi-teach-assignment-designer（作业布置）
<── xiaozhi-teach-solo-dashboard（学员基线）
<── xiaozhi-teach-lesson-log（上节课重点）
──→ xiaozhi-teach-student-analyzer（错题回流）
──→ xiaozhi-teach-lesson-log（预诊断）
──→ xiaozhi-teach-solo-dashboard（作业画像）
──→ xiaozhi-teach-parent-communication（催交/反馈）
禁止行为：
- 禁止 AI 替老师自动催交作业
- 禁止在公开数据中暴露学员真实姓名
- 禁止把作业错题原文存入数据库（只存错因和知识点）
- 禁止对所有学生用同一种催交方式
- 禁止忽略顽固错题（3 次未跟进）
隐私与数据控制入口
本 SKILL 读写的学员数据存于共享工作空间（solo-teacher-workspace.schema.json），涉及未成年人信息，须提供可执行的控制入口。老师本人、或应学员/家长要求，可随时说：
- 查看："查看 [学员化名] 的工作空间记录 / 课表 / 作业 / 报告"
- 更正："更正 [学员化名] 的 [某字段]"（覆盖旧值，避免新旧冲突并存）
- 删除："删除 [学员化名] 的某条记录 / 全部数据"（流失学员应按约定周期删除）
- 暂停记录："这次不要记录 / 暂停记录 [学员化名]"
- 取消跨 SKILL 共享："不要把 [学员化名] 的数据共享给其他 SKILL"
校验要求：跨 SKILL 共享或建档前，须确认 consent.crossSkillSharing / consent.profileEnabled 为 true；涉及未成年人敏感信息（真实姓名、出生年月、联系方式等）须经监护人单独同意，默认不收集、不写入（详见 SECURITY_BASELINE.md）。
十五、参考资源
references/homework-status-template.md — 作业状态追踪模板references/completion-tracking-views.md — 学员/班级作业完成度视图模板references/error-reflow-checklist-template.md — 错题回流清单模板references/persistent-weakness-file-template.md — 顽固弱项档案模板references/pre-diagnosis-output-template.md — 下节课预诊断输出模板references/student-homework-profile-template.md — 学员作业画像模板
💡 小智说：
"作业是教学里最被低估的环节。
大多数老师批完就忘，但如果你把每份作业
看作下一节课的 X 光片，
你会发现：
哪道题全班都错，是教学没讲到；
哪个学生总错一个点，是认知有漏洞；
哪个学生突然不交，是状态有了变化。
作业是教学最敏感的传感器。"
