Agent skill

Xiaozhi Teach Homework Tracker

by qizhitang in qizhitang/xiaozhi-skills

帮独立教师跟进课上练习与学员带来的学校作业、考试错题:登记、追状态、归错因、导出下节课讲什么. An agent skill from qizhitang/xiaozhi-skills.

MITAuto-check passedEducation

Install Xiaozhi Teach Homework Tracker

skills CLI
$ npx skills add qizhitang/xiaozhi-skills --skill xiaozhi-teach-homework-tracker -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install qizhitang/xiaozhi-skills xiaozhi-teach-homework-tracker --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/qizhitang/xiaozhi-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/teacher/independent/xiaozhi-teach-homework-tracker .claude/skills/xiaozhi-teach-homework-tracker && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
xiaozhi-teach-homework-tracker
GitHub stars
105
Token cost
~4.1k tokens
SKILL.md length
459 words
Files
15 (incl. references)
Skills in repo
84
Repo updated
First seen
Licence
MIT

At a glance

帮独立教师跟进课上练习与学员带来的学校作业、考试错题:登记、追状态、归错因、导出下节课讲什么. An agent skill from qizhitang/xiaozhi-skills.

  • Education work in your project
  • SKILL.md covers 技术边界, 一、核心使命, 二、触发时机 and 三、核心流程, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Xiaozhi Teach Homework Tracker is an agent skill from qizhitang/xiaozhi-skills. 帮独立教师跟进课上练习与学员带来的学校作业、考试错题:登记、追状态、归错因、导出下节课讲什么。 适用于老师说"登记今天课上的练习""[化名] 课上那份练习做完了吗""[化名] 带来了学校作业,帮我归一下错因""考试错题帮我归类""错题回流""下节课该讲什么""这道题他错第三次了""看下 [化名] 的作业画像"。 流程:老师口述课上练习或学校作业 → 追七档状态 → 按 shared/vocab.md §1/§3 归错因 → 阈值命中先存证据待老师确认。 校外培训不给学员留作业:老师要登记回家做的作业时,说一句依据、改登记为课上练习或学校作业;不追未交、不催交;也不出题、不判分、不写家长消息、不写课后记录——课上练习的题转 exam-designer,家长消息转 parent-communication,课后记录转 lesson-log。

Its SKILL.md is about 4.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 16 other files, including reference files (for example `references/completion-tracking-views.md`, `references/error-reflow-checklist-template.md` and `references/persistent-weakness-file-template.md`). Compatibility notes: WorkBuddy / SkillHub / OpenClaw / ClawHub

It sits in Education. The licence is MIT.

When your agent uses it

  • Education work in your project

Example prompts

  • “登记今天课上的练习”
  • “[化名] 课上那份练习做完了吗”
  • “[化名] 带来了学校作业,帮我归一下错因”
  • “/xiaozhi-teach-homework-tracker”

Requirements

  • Compatibility (from SKILL.md): WorkBuddy / SkillHub / OpenClaw / ClawHub

What it can do on your machine

Read from SKILL.md and the folder at commit c65f2d4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    WorkBuddy / SkillHub / OpenClaw / ClawHub

    From compatibility in the SKILL.md frontmatter.

Context cost

Xiaozhi Teach Homework Tracker loads about 4.1k tokens when it runs, and up to ~7.9k if it reads all its reference files. Until then it costs about 101 tokens; SKILL.md has 459 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~101
When it runs · the whole SKILL.md, loaded when a task matches
~4.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from qizhitang/xiaozhi-skills at commit c65f2d4, republished under its MIT licence (© qizhitang). 459 words, ~4,115 tokens.

Download SKILL.mdSave it as .claude/skills/xiaozhi-teach-homework-tracker/SKILL.md (or your agent's skills folder). This skill also uses 14 other files; get the full folder from GitHub.
name
xiaozhi-teach-homework-tracker
description
帮独立教师跟进课上练习与学员带来的学校作业、考试错题:登记、追状态、归错因、导出下节课讲什么。 适用于老师说"登记今天课上的练习""[化名] 课上那份练习做完了吗""[化名] 带来了学校作业,帮我归一下错因""考试错题帮我归类""错题回流""下节课该讲什么""这道题他错第三次了""看下 [化名] 的作业画像"。 流程:老师口述课上练习或学校作业 → 追七档状态 → 按 shared/vocab.md §1/§3 归错因 → 阈值命中先存证据待老师确认。 校外培训不给学员留作业:老师要登记回家做的作业时,说一句依据、改登记为课上练习或学校作业;不追未交、不催交;也不出题、不判分、不写家长消息、不写课后记录——课上练习的题转 exam-designer,家长消息转 parent-communication,课后记录转 lesson-log。
compatibility
WorkBuddy / SkillHub / OpenClaw / ClawHub
license
MIT
metadata.display_name
作业跟进管家
metadata.version
2.11.1
metadata.author
小智伴学
metadata.category
独立教师
metadata.grade_bands
小学中段, 小学高段, 初中, 高中
metadata.tags
作业跟进, 错题回流, 状态追踪, 预诊断, 独立教师
metadata.depends_on
xiaozhi-teach-lesson-log
id
openclaw:xiaozhi-teach-homework-tracker
min_platform_version
2.0

作业跟进管家 SKILL

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


技术边界

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

教学主体边界:本 SKILL 只给老师出草稿、做分析,不替老师上课,不代老师回答学生的问题,也不代老师评价学生;面向学生或家长的内容,一律由老师审定后再用(教育部《中小学生成式人工智能使用指南(2025 年版)》)。

适用范围:用于校外培训(一对一、小班)时,只在合法范围内用,口径见 shared/off-campus-training.md——学科类须经审批,各地已不再审批新的学科类培训机构;不占学校上课时间,线下 20:30、线上 21:00 前结束,不给学员留作业,一次收费不超过 3 个月或 60 课时,高中学员同样适用;面向义务教育阶段学生的另外不占用休息日、节假日与寒暑假,线上每课时不超过 30 分钟,面向高中学生的这两条参照执行。本技能不预设违规的排课、作业与收费。本技能只跟进课上练习与学员带来的学校作业、考试错题,不登记回家做的作业。

⚠️ 危机例外(最高优先级):若对话中出现自伤/自残、轻生念头、遭受霸凌或伤害、持续严重绝望、家庭安全问题等超出学习范畴的信号,立即停止本 SKILL 的一切流程(含熔断、温情转化、数据展示、出题、家长摘要),按 shared/crisis-exception.md 处置:稳住不评判 → 说明 AI 边界 → 如实提示联系信任的成年人 → 按所在地区给出求助渠道(不确定地区时先问;中国大陆即时危险为 110/120,其他地区用当地紧急电话)。宁可误报,不可漏报;档案只记"已转介"的处置事实。

只追踪低敏信息(完成度、错因维度、知识点、提交时间);不收集作业原文、答案、家庭辅导情况。不替老师判分,不追未交、不起草催交话术,也不向家长或学员发任何消息——要跟家长说课上的情况时,由老师带到家长沟通助手(xiaozhi-teach-parent-communication)起草、自己发出。无 X 时不给"累计错 N 次"的精确统计,改为把已知的几次列出来请老师自己数。


一、核心使命

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

text
误区① 做了就忘:课上练习做完没有记录,学员带来的学校作业、
        考试错题看一眼就还回去,错因、顽固弱项全凭印象。

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

误区③ 一刀切加量:课上练习没做完,不分是"真的不会"还是
        "时间不够",一律加题,或者改成回家补。

本 SKILL 要解决的是:

  • 让每份课上练习、每份带来的学校作业都有记录:登记 → 课上做完 → 批改 → 错因 → 下节课(学校作业、考试错题从批改那一步记起)
  • 让错因落到可跟进的维度上:按 shared/vocab.md §1/§3 归维,不写"不认真"
  • 让跟进分情况:课上没做完,是真不会还是时间不够,两种处理不一样;都在课上解决,不改成回家作业
  • 让判定留在老师手里:阈值命中先给证据,老师确认才改学员卡

二、触发时机

触发场景示例语句
课上练习"登记今天课上的练习" / "[化名] 课上那份练习做完了吗"
学校作业、考试错题"[化名] 带来了学校的数学作业,帮我归一下错因" / "期中考试的错题帮我归类"
完成度"课上练习的完成情况" / "哪些学员课上练习没做完"
错题回流"错题回流" / "错题怎么进入下节课"
下节课预诊断"下节课讲什么" / "作业反映什么问题"
课上没做完"[化名] 课上练习总是做不完怎么办"
顽固弱项"[化名] 这道题错 3 次了"
作业画像"看一下 [化名] 的作业画像"

老师要登记"回家做的作业"时,不拒绝、不说教,按 §三 第 ① 步改登记为课上练习或学员带来的学校作业。


三、核心流程

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

第 ① 步由老师在本 SKILL 内完成:登记两类东西——课上练习(老师在课上布置、学员在课上做的练习)与学员带来的学校作业、考试错题(学员自愿带来、请老师帮着分析的;老师不布置、不追交、不催交)。内容由老师口述、本 SKILL 记录,不依赖任何出题类 SKILL 事先登记;老师若用教师通用包的 xiaozhi-teach-exam-designer(课堂练习)或教案设计准备过课上练习,把最终用的内容复述一遍即可,本 SKILL 不从它那里取数。task 开头写明类别与日期("课上练习([月-日]):""学校作业([月-日] 带来):""考试错题([月-日] 带来):"),shared/vocab.md §5 的 28 天计数一律按这个日期算(课上练习是做这份练习的那节课,不按 dueDate);完成度只算课上练习。

text
登记话术(一轮内完成;按 shared/platform-conventions.md 先生成待确认条目,老师确认后写入):
  课上练习:
  「这节课给谁做的、做了什么、课上做完了没有?」
  → 老师:"小A,函数图像练习册 P32 第 1-8 题,课上做了 6 题,剩下 2 题下节课补"
  → 写入:studentId=小A,task="课上练习([月-日]):函数图像练习册 P32 第1-8题",
          dueDate=下节课日期,status=部分提交,nextAction="第7、8题下节课课上补"
  dueDate 填约定做完的那节课:课上做完的填当天;没做完、留到下节课课上补的,
  填下节课那天(问老师一句)。过了那节课仍没做完,才记 status=未交。

  学员带来的学校作业、考试错题:
  「是哪份学校作业或哪次考试、错了哪几道?」
  → 老师:"小B 带来学校的数学作业,第 3、5、7 题错了"
  → 写入:studentId=小B,task="学校作业([月-日] 带来):数学 第3、5、7题",
          status=已批改,不填 dueDate;错因按 §6.3 逐题写 mainErrors
  task 里写上带来的日期,28 天计数按这一天算;考试错题只记知识点与维度,不记总分、名次;
  这份作业交没交给学校,不登记、不过问。

老师要登记"回家做的作业"时(如"登记今天给小A布置的家庭作业,周四交"):先说一句依据——校外培训不给学员留作业(国办发〔2018〕80 号),课前预习、课后巩固、微信群打卡也算布置作业(教基厅函〔2021〕11 号);再给两种登记方式:把这份练习改到下节课课上做、登记为课上练习,或者学员有学校作业、考试错题想请老师看的,登记为学校作业。老师选一种就照常登记,不拒绝整件事、不说教、不重复解释,也不起草催交话术。


四、作业状态(对齐工作空间 schema)

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

text
┌──────────┬────────────────────────────────┬──────────────────┬──────────┐
│ 状态      │ 定义                            │ 触发动作          │ 时长限制  │
├──────────┼────────────────────────────────┼──────────────────┼──────────┤
│ 已布置    │ 课上布置、学员正在课上做        │ 课上做完收上来    │ —         │
│ 已提交    │ 课上做完、收上来                │ 等待批改          │ 0-3 天    │
│ 部分提交  │ 课上没做完                      │ 下节课课上补齐    │ 到下节课  │
│ 未交      │ 课上没做完,下节课也没补上      │ 查原因、调整练习  │ 当天      │
│ 已批改    │ 老师批改完;学校作业、考试错题  │ 错题回流          │ 1-7 天    │
│           │ 从这一档或已订正起记            │                   │           │
│ 已订正    │ 学员完成订正                    │ 错题归档到错题本  │ —         │
│ 已减免    │ 这份课上练习老师决定不做了      │ 记录说明          │ —         │
└──────────┴────────────────────────────────┴──────────────────┴──────────┘

说明:

  • 七档用于两类记录:课上练习按课上的实际情况记(还在做、或约定下节课课上做还没开始的记 已布置,做完记 已提交,没做完记 部分提交);学员带来的学校作业、考试错题从 已批改 或 已订正 起记,不填 dueDate,不算完成度、不算逾期。
  • 未交 只用于课上练习没做完、约定的下节课也没补上的情形,用来调整课上练习的量与难度,不作为催交的依据;本 SKILL 不登记回家做的作业,也就没有"回家作业没交"。
  • "错题归档到错题本"是 已订正 后的下游动作,不是独立状态。
  • 枚举里没有 overdue、补交、逾期 这些值。逾期与否看 overdueDays:从 dueDate 算到做完那天,做完(已提交、已批改、已订正)后不再增加;还没做完的(已布置、部分提交、未交)算到当前日期;已减免 的记 0;课上练习过了约定的那节课才做完的,状态就是 已提交,逾期事实由 overdueDays 保留。
  • 七档以外的说法("课上只做了一半""下节课补完了两题")写进 nextAction,不新造状态。

五、完成度追踪

5.1 单学员作业完成度视图

📎 完整模板见 references/completion-tracking-views.md(单学员完成度视图填写模板:本周课上练习状态、带来的学校作业与考试错题、课上练习完成情况、与上周对比、错题统计)

5.2 学员列表视图(跨学员横看)

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

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

5.3 课上练习没做完、学校作业不方便带来时

本 SKILL 不起草催交话术,也不替老师给学员或家长发消息;下面是老师在课上怎么处理。

text
■ 课上练习没做完(status=部分提交)
  · 先看原因:题量超出了这节课的时间,还是卡在某个知识点
  · 剩下的题留到下节课课上补,dueDate 填下节课那天;不改成回家做
  · 卡在知识点的:下节课先讲再补,补的题换成纯净版
  · 下节课仍没补上(status=未交):不追、不催,原因写进 nextAction;
    自查这份练习的量、难度和这节课的讲解,调整下次课上练习

■ 学校作业、考试错题不方便带来
  · 带不带来由学员自己决定;老师不追要、不催,也不通过家长要
  · 学员口头说清错在哪一步,老师据此记 knowledgePoint 与 dimension 也可以
  · 这份作业交没交给学校,不是本 SKILL 跟进的事,不登记、不过问

■ 教学诊断(自我反思)
  自我问:
    1. 是不是课上练习太难了?
    2. 是不是课上练习的量超出了这节课的时间?
    3. 是不是讲解没讲透?
    4. 是不是课上的节奏需要调整?

■ 要跟家长说课上的情况时(不是催交)
  · 由老师带到家长沟通助手(xiaozhi-teach-parent-communication)起草、自己发
  · 发之前查 consent.parentCommunicationAllowed;为 false 时只与学员本人说

六、批改完成与错题回流

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 计数(学生端由错题本计数;学校班级工作区的顽固计数由学情分析师累加,见 shared/vocab.md §5;各算各的,不互相覆盖)。
  • 高危:同口径 28 天内累计 5 次 → 建议与学员本人谈策略;是否告知家长依 shared/vocab.md §8 授权。
  • 攻克标准:连续 2 次独立验证做对、间隔 ≥ 3 天、至少 1 次为换题型/纯净版验证。

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

Show full SKILL.md (177 more words)Show less
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 周(按 dueDate)有 2 条 overdueDays ≥ 1
  · 高度:近 4 周(按 dueDate)有 3 条 overdueDays ≥ 1,或近 4 周内单条 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
      → 老师登记的内容(task 开头写类别与日期,28 天计数按这个日期算);课上练习的 dueDate 是约定做完的那节课,学校作业、考试错题不填
  workspace.homeworkFollowups[].status
      → 七档枚举之一(已布置/已提交/部分提交/未交/已批改/已订正/已减免)
  workspace.homeworkFollowups[].overdueDays
      → 逾期天数:从 dueDate 算到做完那天(已提交、已批改、已订正),做完后不再增加;还没做完的算到当前日期;已减免的记 0(无 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 与 task / status / overdueDays(按 task 开头的类别只算课上练习)做阶段报告,xiaozhi-teach-parent-communication 读 task、status 与 nextAction 起草家长反馈(两类按 task 开头的类别分开说;只说课上情况与错因,不催交;发送前查 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 / exam-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 光片, 你会发现: 同一道题几个人都错,是教学没讲到; 一个学员总错一个点,是认知有漏洞; 一个学员课上突然做不完,是状态有了变化。 作业是教学最敏感的传感器。"

© qizhitang, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 14 other files (references) in teacher/independent/xiaozhi-teach-homework-tracker of qizhitang/xiaozhi-skills.

  • SKILL.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/ai-item-check.md
  • shared/crisis-exception.md
  • shared/crisis-referral-protocol.md
  • shared/grade-bands.md
  • shared/hint-ladder.md
  • shared/off-campus-training.md
  • shared/platform-conventions.md
  • shared/solo-teacher-workspace.schema.json
  • shared/vocab.md

Open the folder on GitHubat commit c65f2d4

Compare with similar skills

Xiaozhi Teach Homework Tracker next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Xiaozhi Teach Homework Tracker compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Xiaozhi Teach Homework Tracker this skillqizhitang/xiaozhi-skills105—~4.1kAutomated safety check: PassMIT
DeepTutor CLIHKUDS/DeepTutor41k—~2.8kAutomated safety check: PassApache-2.0
AI Engineering Placement Quizrohitg00/ai-engineering-from-scratch67k—~2kAutomated safety check: PassMIT
Deep Reading Analystginobefun/deep-reading-analyst-skill3544 repos~3.6kAutomated safety check: PassMIT
OpenMAIC Setup and ExtensionTHU-MAIC/OpenMAIC40k—~1.7kAutomated safety check: NotesMIT
Codebase to Coursezarazhangrui/codebase-to-course5.7k—~4.4kAutomated safety check: PassNone

Similar skills

  • DeepTutor CLI

    HKUDS/DeepTutor

    Teaches the agent to set up and run DeepTutor from the command line: chat and capabilities, knowledge bases, partners, memory, sessions, notebooks and the server or Web app.

    41k GitHub stars~2.8k tokensUpdated 3 days ago
    EducationAuto-check passed
  • AI Engineering Placement Quiz

    rohitg00/ai-engineering-from-scratch

    Runs a 10-question quiz across five areas to place a learner in the AI Engineering from Scratch curriculum, so they skip what they already know.

    67k GitHub stars~2k tokensUpdated today
    EducationAuto-check passed
  • Deep Reading Analyst

    ginobefun/deep-reading-analyst-skill

    Comprehensive framework for deep analysis of articles, papers, and long-form content using 10+ thinking models (SCQA, 5W2H, critical thinking, inversion, mental models, first principles, systems…

    354 GitHub starsUsed in 4 repos~3.6k tokens
    EducationAuto-check passed
  • Guides setup, classroom generation and secondary development for OpenMAIC, the multi-agent interactive classroom, one confirmed phase at a time.

    40k GitHub stars~1.7k tokensUpdated today
    EducationAuto-check: notes
  • Codebase to Course

    zarazhangrui/codebase-to-course

    Turns a codebase into an interactive single-page HTML course for non-technical learners, with scroll modules, animated diagrams, quizzes and plain-English code translations.

    5.7k GitHub stars~4.4k tokensUpdated 6 mo ago
    EducationAuto-check passed
  • AI Engineering Project Tutor

    rohitg00/ai-engineering-from-scratch

    Tutors a learner through one stage of a hands-on AI engineering project per session: lesson, prediction, code, grader run and reflection, with hints but never full solutions.

    67k GitHub stars~1.6k tokensUpdated today
    EducationAuto-check passed

More from qizhitang/xiaozhi-skills

All 84 skills in this repo
  • Xiaozhi Biology Chart Reader

    qizhitang/xiaozhi-skills

    生物图表与材料题教练:陪学生读懂当前这道题里的曲线、示意图、系谱图、数据表和材料——先看轴、看点、看线,再联系教材原理作答;覆盖初中学业水平考试(会考)的识图题与高中必修、选择性必修的图表(选择性必修只对选考生物的学生讲)。

    105 GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed
  • Xiaozhi Biology Concept Network

    qizhitang/xiaozhi-skills

    生物概念网络构建器:帮学生把零散的生物概念连成网——按"大概念 → 重要概念 → 次位概念"分层,用结构与功能、物质与能量等生命观念串起来,理清基因与染色体、光合作用与呼吸作用这类最易混的概念关系;高中覆盖必修与选择性必修的概念层级(选择性必修只对选考生物的学生)。

    105 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed
  • Xiaozhi Biology Error Dna

    qizhitang/xiaozhi-skills

    初中到高中的生物错题根因分析与档案:按生物六维(概念网络、结构与功能、图表识读、变量与实验设计、表述与术语、遗传与数据计算)定位子类型,给出弱项报告;高中覆盖必修与选择性必修(维度表第八、十一、十二节)。

    105 GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed
  • Xiaozhi Biology Genetics Coach

    qizhitang/xiaozhi-skills

    遗传推理教练:陪学生做当前这道遗传题——定性状、定基因组成、画遗传图解、算概率;初中讲显性与隐性、基因组成和性别决定,高中必修讲分离定律、自由组合定律、伴性遗传与系谱图判断,以及 DNA 复制与基因表达的计算、可遗传变异、基因频率。

    105 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed
  • Xiaozhi Biology Inquiry Coach

    qizhitang/xiaozhi-skills

    生物实验探究教练:讲清探究的步骤、对照实验怎么设计、每一步为什么这样做、结论怎么写,覆盖初中常见实验与实验操作考试备考,以及高中必修与选择性必修的学生活动与实验设计题。

    105 GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • Xiaozhi Bridge Planner

    qizhitang/xiaozhi-skills

    初高衔接规划:中考结束到高一上学期,诊断语文、数学、物理、化学、英语、生物、地理、历史各自的衔接缺口,排出暑假与高一开学头几周的衔接计划,再把具体内容交给对应的学科技能。

    105 GitHub stars~1.4k tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Xiaozhi Teach Homework Tracker

What does Xiaozhi Teach Homework Tracker do?

帮独立教师跟进课上练习与学员带来的学校作业、考试错题:登记、追状态、归错因、导出下节课讲什么. An agent skill from qizhitang/xiaozhi-skills. Xiaozhi Teach Homework Tracker is an agent skill from qizhitang/xiaozhi-skills.

When should I use Xiaozhi Teach Homework Tracker?

Xiaozhi Teach Homework Tracker fits situations like: education work in your project.

How do I install Xiaozhi Teach Homework Tracker in Claude Code?

Run `npx skills add qizhitang/xiaozhi-skills --skill xiaozhi-teach-homework-tracker -a claude-code`. Or copy the skill folder (teacher/independent/xiaozhi-teach-homework-tracker in qizhitang/xiaozhi-skills) into .claude/skills/xiaozhi-teach-homework-tracker in your project. Claude Code loads it when a task matches its description.

How do I install Xiaozhi Teach Homework Tracker in Codex?

Run `npx skills add qizhitang/xiaozhi-skills --skill xiaozhi-teach-homework-tracker -a codex`. Or copy the skill folder (teacher/independent/xiaozhi-teach-homework-tracker in qizhitang/xiaozhi-skills) into .agents/skills/xiaozhi-teach-homework-tracker in your project. Codex loads it when a task matches its description.

Can I use Xiaozhi Teach Homework Tracker in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add qizhitang/xiaozhi-skills --skill xiaozhi-teach-homework-tracker -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/xiaozhi-teach-homework-tracker, .gemini/skills/xiaozhi-teach-homework-tracker, .github/skills/xiaozhi-teach-homework-tracker and .opencode/skills/xiaozhi-teach-homework-tracker in your project.

What does Xiaozhi Teach Homework Tracker need to run?

SKILL.md names no scripts, command-line tools or credentials: Xiaozhi Teach Homework Tracker is instructions for the agent only. Compatibility (from SKILL.md): WorkBuddy / SkillHub / OpenClaw / ClawHub.

Does Xiaozhi Teach Homework Tracker access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Xiaozhi Teach Homework Tracker safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Xiaozhi Teach Homework Tracker use?

Xiaozhi Teach Homework Tracker is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Xiaozhi Teach Homework Tracker use?

About 4.1k tokens (SKILL.md is roughly 16k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.8k tokens, read only when the agent opens those files.

What are the alternatives to Xiaozhi Teach Homework Tracker?

Skills that share tags, products or a category with Xiaozhi Teach Homework Tracker: DeepTutor CLI (HKUDS/DeepTutor, 41k stars), AI Engineering Placement Quiz (rohitg00/ai-engineering-from-scratch, 67k stars), Deep Reading Analyst (ginobefun/deep-reading-analyst-skill, 354 stars) and OpenMAIC Setup and Extension (THU-MAIC/OpenMAIC, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Xiaozhi Teach Homework Tracker?

qizhitang (a GitHub user) maintains it in qizhitang/xiaozhi-skills, which has 105 GitHub stars. The repository holds 84 skills in this directory. The repository was last updated on October 9, 2026.

Source: qizhitang/xiaozhi-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.