作业跟进管家 SKILL#

一句话定位： 作业不是任务清单，而是下一节课的诊断 X 光——跟进它，不是为了完成它，而是为了发现下一节课该讲什么。

---

技术边界#

技术边界：本 SKILL 依赖能力 [M, X, K]，无该能力时按 shared/platform-conventions.md 降级。

只追踪低敏信息（完成度、错因维度、知识点、提交时间）；不收集作业原文、答案、家庭辅导情况。不替老师判分，不向家长或学员发任何催交消息——催交话术由老师带到 xiaozhi-teach-parent-communication 自行发出。无 X 时不给"累计错 N 次"的精确统计，改为把已知的几次列出来请老师自己数。

---

一、核心使命#

独立教师作业跟进常见的三个误区：

text

误区① 收了就忘：作业布置出去后缺乏系统追踪，
        完成度、错题率、顽固弱项全凭印象。

误区② 批完归档：作业批改完就放在一边，
        错题没有回流到下一节课教案，
        学生错过的题目反复错。

误区③ 一刀切催交：对所有学生用同一种方式催交，
        不知道谁是"真的不会"谁是"忘了交"。

本 SKILL 要解决的是：

• 让每份作业都有完整追踪：登记 → 提交 → 批改 → 错因 → 下节课
• 让错因落到可跟进的维度上：按 shared/vocab.md §1/§3 归维，不写"不认真"
• 让跟进分情况：真不会 / 忘了 / 时间不够，三种处理不一样
• 让判定留在老师手里：阈值命中先给证据，老师确认才改学员卡

---

二、触发时机#

触发场景示例语句作业跟进"作业跟进" / "[化名] 的作业状态"完成度"作业完成度" / "哪些学生没交"错题回流"错题回流" / "错题怎么进入下节课"下节课预诊断"下节课讲什么" / "作业反映什么问题"作业没交"[化名] 作业没交怎么办"顽固弱项"[化名] 这道题错 3 次了"作业画像"看一下 [化名] 的作业画像"

---

三、核心流程#

text

                ┌──────────────────────────┐
                │ ① 老师在本 SKILL 内登记   │
                │  task / dueDate / 学员    │
                └────────────┬─────────────┘
                             ↓
                ┌──────────────────────────┐
                │ ② 状态追踪（七档枚举）    │
                │  逾期看 overdueDays       │
                └────────────┬─────────────┘
                             ↓
                ┌──────────────────────────┐
                │ ③ 老师判分后登记错题      │
                │  本 SKILL 不判分          │
                └────────────┬─────────────┘
                             ↓
                ┌──────────────────────────┐
                │ ④ 错因归维（vocab §1/§3） │
                │  写 mainErrors[]          │
                └────────────┬─────────────┘
                             ↓
                ┌──────────────────────────┐
                │ ⑤ 阈值命中（vocab §5）    │
                │  先写 progressEvidence    │
                │  老师确认后才进弱项       │
                └────────────┬─────────────┘
                             ↓
                ┌──────────────────────────┐
                │ ⑥ 下节课预诊断            │
                │  交给老师带进下一节课     │
                └──────────────────────────┘

第 ① 步由老师在本 SKILL 内完成：作业内容与截止时间是老师口述、本 SKILL 记录，不依赖任何出题类 SKILL 事先登记。老师若用 xiaozhi-teach-assignment-designer 设计过作业，把最终布置的内容复述一遍即可，本 SKILL 不从它那里取数。

text

登记话术（一轮内完成）：
  「给谁布置的、布置了什么、什么时候交？」
  → 老师："小A，函数图像练习册 P32 第 1-8 题，周四交"
  → 写入：studentId=小A，task="函数图像练习册 P32 第1-8题"，dueDate=周四日期，status=已布置
  缺 dueDate 时追问一次；仍无则记 status=已布置 且不参与逾期统计。

---

四、作业状态（对齐工作空间 schema）#

每份作业的 status 取值须为 schema.homeworkFollowup.status 枚举之一（已布置/已提交/部分提交/未交/已批改/已订正/已减免）：

text

┌──────────┬────────────────────────┬────────────┬──────────────┐
│ 状态      │ 定义                    │ 触发动作    │ 时长限制      │
├──────────┼────────────────────────┼────────────┼──────────────┤
│ 已布置    │ 已布置、尚未到截止       │ 等待提交    │ —            │
│ 已提交    │ 在截止时间内完整提交     │ 等待批改    │ 0-3 天        │
│ 部分提交  │ 提交部分内容/部分完成    │ 请学员补齐  │ 1-3 天        │
│ 未交      │ 截止时间未提交           │ 分层跟进    │ 当天          │
│ 已批改    │ 老师完成批改             │ 错题回流    │ 1-7 天        │
│ 已订正    │ 学员完成订正             │ 错题归档到错题本 │ —        │
│ 已减免    │ 经沟通减免本次作业       │ 记录说明    │ —            │
└──────────┴────────────────────────┴────────────┴──────────────┘

说明：

• "错题归档到错题本"是 已订正 后的下游动作，不是独立状态。
• 枚举里 没有 overdue、 补交、 逾期 这些值。逾期与否看 overdueDays（由 dueDate 与当前日期派生）；学生迟交后交上来了，状态就是 已提交，逾期事实由 overdueDays 保留。
• 七档以外的说法（"交了一半""说是忘带了"）写进 nextAction，不新造状态。

---

五、完成度追踪#

5.1 单学员作业完成度视图#

📎 完整模板见 references/completion-tracking-views.md（单学员完成度视图填写模板：本周作业状态、完成度统计、与上周对比、错题统计）

5.2 学员列表视图（跨学员横看）#

独立教师带的是一对一或小班，没有"班级"，所以这里是 学员列表 而不是班级花名册：按学员逐行列出本周作业状态，不排名、不公示。

📎 完整模板见 references/completion-tracking-views.md（学员列表视图填写模板：逐学员状态、待跟进学员）

5.3 未交后的分层跟进#

以下话术 由老师自己发，本 SKILL 只提供措辞。

text

■ 学员视角（老师私下问一句，不在群里说）
  时机：作业截止当晚/第二天
  话术：
    "我看你 [X 作业] 没交，是不是 [X 原因]？
     如果有困难，我们可以 [X 帮助方式]。"

■ 家长视角（老师自己发；本 SKILL 不代发）
  时机：同一学员近 4 周有 2 次未交，且与学员本人聊过仍无改善
  前置：查 consent.parentCommunicationAllowed；为 false 时只与学员本人沟通
  话术（起草交给 xiaozhi-teach-parent-communication）：
    "[X 妈/爸，[化名] 这两次 [X 作业] 都没交。
     我想了解一下原因。
     如果是 [X 难度问题]，我们会 [X 调整]。
     如果是 [X 时间问题]，我们也可以 [X 调整]。"

■ 教学诊断（自我反思）
  自我问：
    1. 是不是作业太难了？
    2. 是不是作业量太大了？
    3. 是不是上课没听懂？
    4. 是不是学习习惯需要支持？

---

六、批改完成与错题回流#

6.1 批改四类标记#

text

✓   完全正确
▲   思路对但计算/书写错
?   思路不清/不完整
✗   思路错误
?✓  部分对
#   超纲或独特解法

6.2 错题回流清单#

📎 完整模板见 references/error-reflow-checklist-template.md（错题回流清单填写模板：多名学员共同错的题、个体错题、反复出现的错题、错题归属）

6.3 错因归维（写入 mainErrors[]）#

错因 一律按 shared/vocab.md §1（通用四维）与 §3（老师端七类 ↔ 四维映射），本 SKILL 不另起一套词表。

每条错题写成一个 workspace.homeworkFollowups[].mainErrors[] 对象：

text

{
  "knowledgePoint": "一元一次方程移项",   ← 必填，知识点标签（≤60 字）
  "dimension":      "概念模糊",           ← 必填，通用四维之一
  "teacherCategory":"规则错误"            ← 选填，老师端七类之一
}

• dimension 必填，取值只能是 概念模糊 / 计算失误 / 读题失误 / 方法用错。
• teacherCategory 想写就写，但写了就必须同时给出 dimension；两者的对应关系见 shared/vocab.md §3（知识漏洞、规则错误 → 概念模糊；计算错误、习惯性失误 → 计算失误；审题错误 → 读题失误；策略错误、表达/书写不规范 → 方法用错）。
• 不写自由文本错因串（"这题他老是错""不认真"），这类描述放 nextAction。
• "不认真"不是错因——按 shared/vocab.md §3，抄错题归读题失误，算错归计算失误，原因要落到可跟进的动作上。

判定顺序（ shared/vocab.md §1）：先复述条件看是不是读题失误 → 换纯净版看是不是概念模糊 → 换题型看是不是方法用错 → 剩下的归计算失误。 同一道错题只记一个 dimension。

dimension跟进动作概念模糊回到定义/纯净版最简题，讲完再做同类题计算失误限时计算专项 + 固定检查动作读题失误圈条件、复述题意后再动笔方法用错对比两种解法，讲清什么时候用哪个

跟进动作里若需要一道验证用的同类题/纯净版题， 生成前按 shared/ai-item-check.md 自检（有解且唯一、条件充分、数值友好、学段内、与原错题同维度同子类型），输出时标注【AI 生成，入库前请人工验算】；老师未验算的题不写入资源库、不发给学员。

---

七、反复出错的跟踪与顽固弱项确认#

7.1 阈值口径#

顽固弱项的计数口径 不在本 SKILL 定义，一律按 shared/vocab.md §5：

• 粒度：同一知识点标签 + 同一通用维度（ dimension）。
• 时间窗：滚动 28 天。
• 累计（不要求连续），同一天同一知识点多次错只计 1 次。
• 老师端由本 SKILL 计数（学生端由错题本计数，两边不互相覆盖）。
• 高危：同口径 28 天内累计 5 次 → 建议与学员本人谈策略；是否告知家长依 shared/vocab.md §8 授权。
• 攻克标准：连续 2 次独立验证做对、间隔 ≥ 3 天、至少 1 次为换题型/纯净版验证。

弱项状态五档（ 待处理 / 初步弱项 / 顽固弱项 / 突破中 / 已攻克）的进出条件见 shared/vocab.md §4，本 SKILL 直接引用。

7.2 命中阈值后的动作：先存证据，再等老师确认#

阈值命中 不直接写 studentCards[].primaryWeaknesses。顺序是：

text

① 命中 vocab §5 阈值
      ↓
② 写入 workspace.progressEvidence[]：
     evidenceType = "作业"
     description  = "[知识点] 在 28 天内第 3 次出现 [dimension]，
                     日期 [d1] [d2] [d3]"
     confidenceLevel = data_sufficient（≥3 次独立观察）
      ↓
③ 向老师提一次确认（一轮，不重复追问）：
     「小A 的『一元一次方程移项』28 天内第 3 次记到概念模糊
       （6-1 / 6-8 / 6-15）。要把它加进 小A 的重点弱项吗？
        加 / 不加 / 再看一次」
      ↓
④ 老师说"加" → 才写入 studentCards[].primaryWeaknesses（上限 5 条）
   老师说"不加"或没回 → 证据留在 progressEvidence，弱项不写

老师不确认就不写，是因为 primaryWeaknesses 会被家长沟通和阶段报告读到，误标的成本比漏标高。

7.3 顽固弱项档案#

📎 完整模板见 references/persistent-weakness-file-template.md（顽固弱项档案填写模板：知识点、通用维度、跟进动作、弱项状态）

7.4 与学情分析类 SKILL 的衔接#

若老师同时安装了教师通用包，可把 mainErrors[] 的聚合结果口头带给 xiaozhi-teach-student-analyzer 做进一步分析；未安装时本 SKILL 的错因分布已可直接用于备下一节课。两种情况下，写回学员卡的动作都只发生在本 SKILL 且需老师确认。

---

八、下节课预诊断#

8.1 预诊断三步走#

text

第 1 步：错题聚合
  · 按 dimension + knowledgePoint 归拢本次作业的错题
  · 小班场景再区分：多名学员共同错的 vs 只有一人错的

第 2 步：教学决策
  · 多人共同错：下节课必须讲
  · 单人错：给这名学员单独的任务
  · 已达 vocab §5 阈值的：需要专项突破

第 3 步：衔接下一节课
  · 把错因分析整理成下节课重点
  · 老师带进备课；本 SKILL 不写教案

8.2 预诊断输出#

📎 完整模板见 references/pre-diagnosis-output-template.md（下节课预诊断输出填写模板：必须讲/选讲/个体关注/教案调整建议）

8.3 结论落在哪#

预诊断本身是 生成的报告段落，不是存储字段。落库的只有两处：

• 错因明细 → workspace.homeworkFollowups[].mainErrors[]
• 下节课要盯的动作 → workspace.homeworkFollowups[].nextAction

老师在 xiaozhi-teach-lesson-log 记录下节课时，可以把这段结论写进 lessonLogs[].nextLessonFocus，由那个 SKILL 负责落库。

---

九、学员作业画像#

9.1 单学员画像#

📎 完整模板见 references/student-homework-profile-template.md（单学员作业画像填写模板：完成度趋势、错因分布、反复出错清单、订正率）

9.2 画像的数据边界#

text

  · 画像由 workspace.homeworkFollowups[] 实时聚合，不单独落库
  · 作业不消耗课时，本 SKILL 不碰 coursePackageLedger
  · 画像可由 solo-dashboard 只读展示；本 SKILL 不向它推送

---

十、需要跟进的学员标记#

标记只用于提醒老师，不写入学员卡，也不作为对学员的评价。

text

■ 逾期跟进（看 overdueDays，不看 status）
  · 中度：近 4 周有 2 条 overdueDays ≥ 1
  · 高度：近 4 周有 3 条 overdueDays ≥ 1，或单条 overdueDays ≥ 7

■ 反复出错跟进
  · 按 shared/vocab.md §5 命中顽固阈值的知识点数 ≥ 3 个

■ 应对
  · 中度：与学员本人私下聊一次，看是难度还是时间问题；相应调整作业
  · 高度：先自查作业难度与总量，再决定是否与家长沟通
          （发家长内容前查 consent.parentCommunicationAllowed）

■ 不做的事
  · 不按"错题率 %"给学员分级——单次作业题量小，比例不稳定
  · 不把标记本身告诉学员或家长（"你被标成高风险了"）

---

十一、接口#

11.1 数据流#

本 SKILL 自成闭环：老师在这里登记作业、在这里记错因、在这里确认弱项。不需要任何 SKILL 先跑一遍，也不向任何 SKILL 推送。

text

  老师口述 ──→ ┌──────────────────────┐ ──→ 老师带走一份"下节课讲什么"
              │ homework-tracker      │
              │ （本 SKILL）           │
              └──────────┬───────────┘
                         │ 只写这三处
       ┌─────────────────┼─────────────────┐
       ↓                 ↓                 ↓
 homeworkFollowups  progressEvidence   studentCards
 （状态/错因/动作）  （阈值证据）      （确认后的弱项）

11.2 读写字段#

均为 solo-teacher-workspace.schema.json 的真实字段。

text

读：
  workspace.homeworkFollowups[].task / .dueDate / .status / .overdueDays
      → 本 SKILL 自己登记的作业条目（历次）
  workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension
      → 历次错因，用于 vocab §5 计数
  workspace.studentCards[].primaryWeaknesses / .goals / .gradeLevel / .gradeBand
      → 学员基线（已确认弱项、目标、年级、学段）
  workspace.studentCards[].status
      → 为"暂停记录"或"已结课"时，不再写入任何新条目
  workspace.lessonLogs[].nextLessonFocus / .date
      → 上次课设定的重点，用于对照作业表现

写：
  workspace.homeworkFollowups[].task / .dueDate
      → 老师登记的作业内容与截止时间
  workspace.homeworkFollowups[].status
      → 七档枚举之一（已布置/已提交/部分提交/未交/已批改/已订正/已减免）
  workspace.homeworkFollowups[].overdueDays
      → 由 dueDate 与当前日期派生的逾期天数（无 dueDate 时不写）
  workspace.homeworkFollowups[].mainErrors[]
      → 每条 {knowledgePoint, dimension, teacherCategory?}，dimension 必填
  workspace.homeworkFollowups[].nextAction
      → 跟进动作；自由描述放这里，不塞进 mainErrors
  workspace.progressEvidence[].evidenceType / .description / .date / .confidenceLevel
      → 阈值命中证据、订正证据、攻克证据
  workspace.studentCards[].primaryWeaknesses
      → 仅在老师逐条确认后追加（§7.2），上限 5 条

派生视图（实时计算，不落库）：
  完成度        ← 由 workspace.homeworkFollowups[].status 聚合
  错因分布      ← 由 workspace.homeworkFollowups[].mainErrors[].dimension 聚合
  顽固计数      ← 由 mainErrors 跨条目按 shared/vocab.md §5 比对
  需跟进标记    ← 由 workspace.homeworkFollowups[].overdueDays 统计

生成的报告段落（非存储字段）：
  下节课预诊断  ← 事实来源为 workspace.homeworkFollowups[].mainErrors；
                  老师若要留档，由 lesson-log 写入 lessonLogs[].nextLessonFocus

11.3 谁来读这些字段#

其他 SKILL 直接读工作空间字段即可，不经由本 SKILL： xiaozhi-teach-solo-dashboard 读 overdueDays 做逾期提示， xiaozhi-teach-renewal-report 读 mainErrors 与 progressEvidence 做阶段报告， xiaozhi-teach-parent-communication 读 status 与 nextAction 起草家长反馈（发送前查 consent.parentCommunicationAllowed）。

---

十二、字段级高敏信息防护#

text

✅ 追踪中可使用：化名、作业完成度、错因维度、知识点、提交时间
❌ 禁止：作业具体答案、家庭辅导情况、家长监督方式
✅ 写入数据：聚合错因、完成度
❌ 不写入：学员真实身份（一律用 alias）

✅ 错题回流：只存 knowledgePoint + dimension
❌ 禁止：错题原文、学员答题原文

---

十三、行为准则#

✅ 应该做❌ 不能做错因归到 vocab 四维，可跟进写"不认真""老是错"当错因阈值命中先存证据、请老师确认越过老师直接改学员卡弱项逾期看 overdueDays造一个 status=overdue分情况跟进（真不会/忘了/时间不够）一套话术套所有学员预诊断基于真实错题凭印象决定下节课重点一律用 alias记录里出现真实姓名

---

十四、与其他 SKILL 的协同清单#

text

作业跟进管家（自成闭环，不需要前置 SKILL）
    读 workspace.studentCards[]      ← student-intake 建卡
    读 workspace.lessonLogs[]        ← lesson-log 写课后重点
    写 workspace.homeworkFollowups[] ← 本 SKILL 唯一写入方
    写 workspace.progressEvidence[]  ← 与 renewal-report 共用
    写 workspace.studentCards[].primaryWeaknesses ← 老师确认后

  其他 SKILL 需要作业数据时，直接读上述字段，不经过本 SKILL。
  若装有教师通用包，可把错因分布带给 student-analyzer / assignment-designer
  做进一步分析或出题；未安装时本 SKILL 的输出已可直接用。

禁止行为：

• 禁止代老师发催交消息（无论发给学员还是家长）
• 禁止在记录中出现学员真实姓名
• 禁止存储作业错题原文或学员答题原文（只存 knowledgePoint + dimension）
• 禁止对所有学员用同一种跟进方式
• 禁止未经老师确认就写 studentCards[].primaryWeaknesses
• 禁止在 status 里造枚举外的值

---

隐私与数据控制入口#

• 查看：「查看我的[作业记录]」
• 更正：「更正我的[作业记录]」
• 删除：「删除我的[作业记录]」——据此写进学员卡的弱项条目与阶段证据一并列出，老师确认后同删；删除后不可恢复
• 暂停：「这次不要记忆」/「暂停提醒」
• 共享控制：「不要共享给其他SKILL」/「不要给家长看」
• 导出：「导出我的[作业记录]」（以文本形式给出，便于转存）

学员/家长提出时同样适用（由老师核实请求人身份后代为执行），按学员化名定位：「查看 小A 的作业记录」「删除 小A 的全部作业记录」。

校验要求：跨 SKILL 共享或建档前，须确认 consent.crossSkillSharing / consent.profileEnabled 为 true；学员卡 status 为"暂停记录"时不再写入新条目。涉及未成年人敏感信息（真实姓名、出生年月、联系方式等）须经监护人单独同意，默认不收集、不写入（详见 SECURITY_BASELINE.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 — 学员作业画像模板
• shared/vocab.md — 错因四维、老师端七类映射、顽固阈值、弱项五档（唯一来源）

---

💡 小智说： "作业是教学里最被低估的环节。 大多数老师批完就忘，但如果你把每份作业 看作下一节课的 X 光片， 你会发现： 同一道题几个人都错，是教学没讲到； 一个学员总错一个点，是认知有漏洞； 一个学员突然不交，是状态有了变化。 作业是教学最敏感的传感器。"