xiaozhi-teach-homework-tracker

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 光片， 你会发现： 哪道题全班都错，是教学没讲到； 哪个学生总错一个点，是认知有漏洞； 哪个学生突然不交，是状态有了变化。 作业是教学最敏感的传感器。"