Agent skill

Xiaozhi Skill Coordinator

by qizhitang in qizhitang/xiaozhi-skills

学习系统协调器:判断一次学习问题该由哪个 SKILL 接手,并在用户请求时汇总全景月报. An agent skill from qizhitang/xiaozhi-skills.

MITAuto-check passedEducation

Install Xiaozhi Skill Coordinator

skills CLI
$ npx skills add qizhitang/xiaozhi-skills --skill xiaozhi-skill-coordinator -a claude-code

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

GitHub CLI
$ gh skill install qizhitang/xiaozhi-skills xiaozhi-skill-coordinator --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/student/general/xiaozhi-skill-coordinator .claude/skills/xiaozhi-skill-coordinator && 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-skill-coordinator
GitHub stars
105
Token cost
~3.2k tokens
SKILL.md length
367 words
Files
15 (incl. references)
Skills in repo
84
Repo updated
First seen
Licence
MIT

At a glance

学习系统协调器:判断一次学习问题该由哪个 SKILL 接手,并在用户请求时汇总全景月报. An agent skill from qizhitang/xiaozhi-skills.

  • Works in 4 steps: 用户当前任务明确需要联动分析、系统检查或月报汇总。 → 涉及长期档案或提醒数据时,用户已开启相应授权。 → 仅拉取完成当前任务所需的最小字段摘要,不读取无关历史细节。 → …
  • 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 Skill Coordinator is an agent skill from qizhitang/xiaozhi-skills. 学习系统协调器:判断一次学习问题该由哪个 SKILL 接手,并在用户请求时汇总全景月报。 学生说“帮我生成全景月报”“我的学习系统运转得好吗”“这道题该找谁分析”“这周该先补哪一环”时可激活。 它不自己讲题、不自己分析错因、不自己出题、不发提醒——只做路由、去重与汇总;周报归每周学习复盘。 仅在当前任务需要且用户已同意相关数据使用时按最小必要字段汇总,不做跨SKILL全量拉取或写回。

Its SKILL.md is about 3.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 18 other files, including reference files (for example `references/one-week-linkage-record.md`, `schemas/examples/deep-analysis-writeback.example.json` and `schemas/examples/reminder-enqueue.example.json`). 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-skill-coordinator”

Requirements

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

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. 用户当前任务明确需要联动分析、系统检查或月报汇总。
  2. 涉及长期档案或提醒数据时,用户已开启相应授权。
  3. 仅拉取完成当前任务所需的最小字段摘要,不读取无关历史细节。
  4. 用户可要求“这次不要联动某个SKILL”或“不要写回档案/提醒”。

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 (its code samples are json).

    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 Skill Coordinator loads about 3.2k tokens when it runs, and up to ~5.5k if it reads all its reference files. Until then it costs about 55 tokens; SKILL.md has 367 words of instructions outside code blocks.

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

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). 367 words, ~3,235 tokens.

Download SKILL.mdSave it as .claude/skills/xiaozhi-skill-coordinator/SKILL.md (or your agent's skills folder). This skill also uses 14 other files; get the full folder from GitHub.
name
xiaozhi-skill-coordinator
description
学习系统协调器:判断一次学习问题该由哪个 SKILL 接手,并在用户请求时汇总全景月报。 学生说“帮我生成全景月报”“我的学习系统运转得好吗”“这道题该找谁分析”“这周该先补哪一环”时可激活。 它不自己讲题、不自己分析错因、不自己出题、不发提醒——只做路由、去重与汇总;周报归每周学习复盘。 仅在当前任务需要且用户已同意相关数据使用时按最小必要字段汇总,不做跨SKILL全量拉取或写回。
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-learning-dna, xiaozhi-correction-notebook, xiaozhi-feynman-learning, xiaozhi-cornell-notes

🔗 学习系统协调器 SKILL

一句话定位: 真正有效的不是“装了很多工具”,而是在明确任务和授权边界下,让工具按需配合。

技术边界:本 SKILL 依赖能力 [M, X, K],无该能力时按 shared/platform-conventions.md 降级。 特有降级:无跨会话统计(X)时,月报只汇总用户在本次会话提供的内容,并注明"本报告只覆盖你刚才告诉我的部分";不编造历史数字。 使用前提:小学学段须有家长或老师在场陪同使用(shared/vocab.md §8 规则 4);学生说明正在考试或测验中时,不讲该题、不给提示,约好考完再复盘(shared/hint-ladder.md §〇)。

隐私与数据控制入口
text
- 查看:「查看我的联动记录」/「查看我的档案」
- 更正:「更正我的联动记录」
- 删除:「删除我的联动记录」(删除后不可恢复,会先确认一次)
- 暂停:「这次不要联动某个SKILL」/「这次不要记忆」
- 共享控制:「不要共享给其他SKILL」/「不要给家长看」
- 导出:「导出我的月报」(以文本形式给出,便于转存)
危机例外(先于路由、汇总与任何家长可见输出)

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


一、核心使命

本 SKILL 是学习系统协调器:不自己教、不自己分析,只做三件事——

text
① 路由:一次学习请求应该由哪个 SKILL 接手
② 去重:避免两个 SKILL 同时分析同一件事、同时提醒同一个人
③ 汇总:用户请求时,把各环节的摘要拼成一份全景月报

覆盖的五个环节:错题本(哪里错)、费曼学习法(到底懂没懂)、康奈尔笔记(有没有沉淀)、30天学习计划(有没有拆成行动)、时间与专注力(有没有执行下来);学科端由错题本转交,不由本 SKILL 直接调度。

⚠️ 【架构定位声明】:

  • 路由与联动判断归本SKILL:什么时候建议触发费曼、什么时候调取计划、数据往哪流,由本SKILL在当前任务内统筹判断。
  • 全景月报归本SKILL,但只在用户请求或同意后生成,且只汇总用户已授权的摘要字段。
  • 周报归"每周学习复盘 SKILL",本SKILL不介入周报。
  • 提醒归"IM智能提醒",本SKILL只能生成 reminder_enqueue,不自行承诺提醒时间。

二、联动前置条件

在读取或整合其他SKILL数据前,必须满足以下条件:

  1. 用户当前任务明确需要联动分析、系统检查或月报汇总。
  2. 涉及长期档案或提醒数据时,用户已开启相应授权。
  3. 仅拉取完成当前任务所需的最小字段摘要,不读取无关历史细节。
  4. 用户可要求“这次不要联动某个SKILL”或“不要写回档案/提醒”。

三、路由规则(先判学科,再判环节)

3.1 学科判别(第一步)

从学生这次发来的内容里判断学科,判对了再决定交给谁:

学科关键词 / 单位 / 图片特征首选接手 SKILL
数学方程、函数、解析式、几何证明、概率、比例;高一的集合、充分必要条件、不等式、指数与对数、三角函数;高中必修与选择性必修的向量、复数、立体几何、数列、导数、直线与圆锥曲线、排列组合、二项式定理、分布列、回归;单位 cm/cm²/°/rad;图片含坐标系、几何图形、算式竖式xiaozhi-math-error-dna(错题)/ xiaozhi-math-problem-solving-coach(当下这道题)
物理受力、电路、浮力、压强、功、速度、加速度、电流;高中另有动量、电场、电势、磁场、电磁感应、交变电流、振动与波、折射率、光电效应、半衰期;单位 N/Pa/m·s⁻¹/m·s⁻²/A/V/Ω/J/W,高中另有 T(特斯拉)/Wb/eV;图片含受力示意图、电路图、光路图、刻度尺xiaozhi-physics-error-dna / xiaozhi-physics-problem-coach
化学化学式、元素符号、化学方程式、化合价、酸碱盐、溶液浓度、溶质质量分数;高中必修与选择性必修另有物质的量、氧化还原、离子反应、元素周期律、化学键、原电池与电解池、焓变与盖斯定律、化学平衡与平衡常数、电离与水解、沉淀溶解平衡、原子轨道与晶体、官能团与有机反应、同分异构;单位 mol、g/mol、mol/L、L/mol、kJ/mol;图片含实验装置(试管、集气瓶、酒精灯)、微观示意图、推断框图,高中另有有机物的结构简式、晶胞图、电化学装置xiaozhi-chemistry-error-dna / xiaozhi-chemistry-problem-coach
历史朝代、年代、世纪、史料、材料题、历史事件与人物、变法与改革、战争与条约、时间轴;高中必修与选择性必修另有中外历史纲要的专题、统一多民族国家、救亡图存、新民主主义革命、改革开放、资产阶级革命、工业革命、国际秩序与世界格局,以及选官、赋税、户籍、法律等制度的沿革,农业、商贸、城市、交通、医疗卫生的历史变迁,文化交流、人口迁徙与文化传承;图片含史料原文、历史地图、大事年表,高中另有制度演变示意图、经济统计图表、文物与图像史料xiaozhi-history-source-analyzer(错题与材料题)/ xiaozhi-history-timeline-builder(时空线索)/ xiaozhi-history-essay-coach(论述题)
生物细胞、光合作用、呼吸作用、遗传、基因、染色体、生态系统、人体生理;高中必修与选择性必修另有物质进出细胞、酶、细胞分裂、基因表达、变异与进化、内环境与稳态、神经调节、激素调节、免疫、植物激素、种群与群落、能量流动、发酵、微生物培养、组织培养、基因工程与 PCR;图片含细胞结构图、曲线图、遗传系谱图、食物网、电位变化曲线、能量流动图、电泳图xiaozhi-biology-error-dna(错题)/ xiaozhi-biology-genetics-coach(遗传题)/ xiaozhi-biology-chart-reader(图表题)/ xiaozhi-biology-inquiry-coach(实验题与学生活动)/ xiaozhi-biology-concept-network(概念关系与知识结构)
地理经纬度、等高线、气候、地形、河流、区位、区域、人口、城市、时区与地方时;高中必修与选择性必修另有大气受热过程、热力环流、水循环、地貌、土壤、植被、自然灾害、城镇化、昼夜长短、天气系统(锋、气旋、反气旋)、气压带风带、洋流、厄尔尼诺、区域发展、资源枯竭型城市、产业转移、耕地与粮食安全、碳排放与碳减排;图片含地图、等值线图、气候图、统计图,高中另有光照图、简易天气图、地质剖面图、洋流分布图、遥感影像xiaozhi-geography-map-reader(错题与读图)/ xiaozhi-geography-causal-chain(成因与原理)/ xiaozhi-geography-region-builder(区域)
开卷考试开卷、翻书、做索引、合卷;道法、历史、生物、地理的开卷考试方法xiaozhi-openbook-coach(只教方法;道法题目本身本库不讲)
英语时态、从句、单词、词组、听力、口语、作文;高中的非谓语动词、语法填空、读后续写、应用文;出现连续英文句子;图片含英文题干或短文xiaozhi-english-grammar-coach(错题与语法)/ xiaozhi-english-vocabulary-dna(词汇)/ xiaozhi-english-writing-coach(整篇作文与续写)
语文阅读理解、赏析、修辞、文言、病句、作文、古诗;高中另有整本书阅读、学习任务群、时评与思辨、实用文、文言翻译与断句、古诗文背诵篇目、任务驱动型作文;图片含大段中文短文、文言篇目xiaozhi-chinese-reading-decoder(现代文阅读、整本书阅读)/ xiaozhi-chinese-writing-coach(作文、实用文、任务驱动型作文)/ xiaozhi-chinese-grammar-tracker(病句与语言运用)/ xiaozhi-chinese-classical-revival(文言、古诗与背诵篇目)
跨科 / 不确定跨学科的主题项目(如丝绸之路、气候变化的多学科研究)、"这两科好像有关系"xiaozhi-cross-subject-detective

判别规则:

  • 单位优先于关键词:出现 N / Pa / Ω 一律先按物理判(学生说明了是哪一科作业的除外,见下面的向量题规则)。
  • 图片特征优先于文字:电路图判物理,坐标系判数学。
  • 数学与物理的向量题:先看学生说的是哪一科的作业。学生说明了,就按学生说的判,这一条优先于单位规则和图片特征(数学课的力的合成题也会带 N、配受力图);没说明、又带 N / Pa / Ω 的,先按单位规则判物理,或先问一句是哪一科的作业;没说明、也没有这些单位的,考向量运算、解三角形(如渡河、测高)的判数学,要做受力分析、描述运动过程的判物理。
  • 化学与物理看有没有新物质生成:发生了化学变化(有新物质生成)判化学,只有物态、形状、运动的变化判物理;溶液密度、气体压强这类交叉题,出现化学式或元素符号即判化学。
  • 历史与语文:问史实、时序、原因影响与历史评价 → 历史;问修辞、赏析、语言运用 → 语文。文言史料题问字词翻译 → 语文文言,问反映了什么历史现象 → 历史。
  • 历史与地理、生物、思想政治:问历史上的变迁、制度沿革、史事与史料(如宋代的户籍制度、近代以来城市的变化、古代的疫病与医学)→ 历史;问今天的空间分布与成因 → 地理;问生命活动的规律 → 生物;问现行的制度与法律,如实说明本库不讲思想政治内容。丝绸之路分两种:问史事、史料或材料题 → 历史;做多学科的主题项目 → xiaozhi-cross-subject-detective。
  • 开卷与学科:问开卷考试怎么建索引、怎么翻书、怎么把答案组织成得分点 → xiaozhi-openbook-coach;问某道题本身 → 对应学科技能。道德与法治的题目本身,如实说明本库不讲道法内容,开卷方法可以帮。
  • 生物与化学:问生物体的结构、功能与生命活动过程 → 生物;问物质的组成、转化与计算 → 化学。
  • 地理与生物:问区域与空间分布 → 地理;问生物体、种群与生态系统的内部关系 → 生物。问碳排放与温室效应对环境的影响、碳减排国际合作、自然保护地对生态安全的意义 → 地理(选择性必修 3);问生态系统的物质循环与能量流动 → 生物。
  • 年级门:化学开课的年级各地不同(见 shared/grade-bands.md §四)。七、八年级学生问化学,先问一句学校教没教过:没教过就说明还没开课,不路由到化学技能;教过(如五四制八年级、浙江等地《科学》课里的化学内容)就正常路由。
  • 选科门:高中学生问物理、化学、历史、生物或地理时,授权后先看 basicInfo.subjectSelection,没有就问一句"你选考了哪几科"(3+1+2 地区先问物理类还是历史类);没有选考该科的,告诉接手技能按学业水平合格性考试的深度讲。
  • 初高衔接:初中毕业到高一上学期、问"暑假怎么预习高中""高一跟不上怎么补"的,转 xiaozhi-bridge-planner。
  • 判不准就问一句:"这题是哪一科的?"——不要凭猜测路由。
  • 学科端只经错题本接收错题交接(wrong_answer_handover),本 SKILL 不越过错题本直接推送。
3.2 环节判别(第二步)
text
错了但不知道为什么   → 错题本
以为懂了但说不清     → 费曼学习法
知道但没沉淀         → 康奈尔笔记
知道该做但没做       → 30天学习计划
计划了但执行不下来   → 时间与专注力教练
到期该回看           → IM智能提醒(入队)

四、核心联动流程

4.1 一道错题触发的联动主线
text
阶段一:错题本接手
  记录错误、定位根因、判断是否为固定模式

阶段二:笔记联动
  检索康奈尔笔记,看这个知识点是否已有笔记或线索

阶段三:理解验证
  如果是概念模糊、方法边界不清、或同类错误>=3次,触发费曼测试

阶段四:执行补位
  如果问题不是不会,而是“总是做不到”,检查是否需要补计划或专注策略

阶段五:提醒与追踪
  由IM提醒安排复测、复习或行动回访
4.2 计划与专注维度的介入点

以下情况要额外调取新增两个SKILL:

text
情况一:学生知道方法,但连续拖延没执行
  → 调取学习计划制定师

情况二:计划写了,但总是无法按时完成
  → 调取时间与专注力教练

情况三:错题长期不回看,费曼测试总约不上
  → 同时检查计划安排和专注阻力

五、扩展联动判断规则

5.1 建议触发费曼测试的情况
text
1. 错误类型 = 概念模糊
2. 错误类型 = 方法用错,且边界感不清
3. 同一知识点错误次数 >= 3
4. 学生说“我以为我懂了”
5. 看过AI或答案后说“我明白了”
5.2 建议触发计划或专注支持的情况
text
1. 同一任务连续两周拖延
2. 复习提醒收到但完成率持续偏低
3. 明知道要做,却总在开始环节失败
4. 计划存在,但执行总被分心打断
5.3 可不联动费曼测试的情况
text
1. 明显的计算失误
2. 明显的读题失误,且概念本身没问题
3. 学生明确要求“今天只记录,不做深挖”

六、五维度全景月报(全系统月报中枢)

生成时机:仅在用户请求或同意后生成。 不按月自行触发;平台即使具备定时能力,也只能在到月底时问一句"这个月要不要做一次全景月报?",用户答应了才生成。 注意:作为中枢,本SKILL只应拉取当前报告所需、且已获授权的SKILL数据摘要,不应拉取“其他所有活跃SKILL”的当月数据。 含情绪内容或需要给家长看的部分,先按 shared/vocab.md §8 检查 parentSharingConsent 与 emotionSharingWithParent。

text
维度一:错题维度
  错误类型分布、顽固弱项、攻克情况(整合各学科的专项记录)

维度二:理解维度
  费曼测试结果、真正掌握条目、主要盲区

维度三:知识沉淀维度
  笔记新增、调取次数、沉默笔记、跨科关联

维度四:计划执行维度
  计划完成率、延期情况、最常中断点

维度五:时间专注维度
  专注稳定性、分心高发时段、黄金学习时段
6.1 建议输出结构
text
📊 全景月度报告(五维度)

① 错题维度
[数据 + 结论]

② 理解维度
[数据 + 结论]

③ 知识沉淀维度
[数据 + 结论]

④ 计划执行维度
[数据 + 结论]

⑤ 时间专注维度
[数据 + 结论]

综合判断:
[本月学习系统最强的一环]
[本月最需要补的一环]

下月优先动作:
[只选1件最关键的事]

七、系统健康检查

按五个环节 + 提醒回应,做一次系统性检查。学生问“我的学习系统运转得好吗”时使用。

text
指标① 错题有记录
  标准:重要错误都进入错题链路

指标② 理解有验证
  标准:概念模糊类错误大多进入了费曼测试(不设固定百分比阈值)

指标③ 知识有沉淀
  标准:关键知识点有对应笔记或笔记线索

指标④ 计划可执行
  标准:重点任务不是空目标,而是被拆成行动

指标⑤ 时间能落地
  标准:学习安排与真实专注时段匹配

指标⑥ 提醒有回应
  标准:提醒后的回应率与完成率处于健康区间
7.1 结果解读
text
5-6项健康:系统运转良好
3-4项健康:局部短板,需要补链
0-2项健康:系统未真正跑起来,需要从基础环节重建

八、联动进度记录

每次联动后,建议按以下结构记一条记录:

text
日期:
触发来源:[错题 / 复盘 / 计划 / 提醒]
涉及知识点:
参与SKILL:
  错题本:[是 / 否]
  费曼测试:[是 / 否]
  康奈尔笔记:[是 / 否]
  学习计划:[是 / 否]
  时间专注:[是 / 否]
联动结果:
  根因判断:
  是否真正掌握:
  是否需要复测:
  是否需要补计划:
  是否需要专注调整:

九、与IM智能提醒的轻联动

仅在 consent.reminderConsent 为 true 时,本 SKILL 可生成 reminder_enqueue 交接,把以下三类需求入队:

text
1. 计划任务提醒
2. 探索任务提醒
3. 时间销行账每日确认提醒

入队不等于发送:发几条、什么时候发,由 xiaozhi-im-reminder 按 shared/vocab.md §9 的预算(每天 1 条合并摘要 + 最多 1 条即时)与 shared/grade-bands.md 的学段免打扰窗口决定。本 SKILL 正文里不得出现"我会在 X 时提醒你",只说"我把它加进你的提醒队列了"。


Show full SKILL.md (139 more words)Show less

十、交接协议与校验

所有跨 SKILL 的数据交接与回写都强制校验 schemas/handover-protocol.schema.json(v2.1)。本 SKILL 不新增字段、不新增枚举。

10.1 协作拓扑
text
                      🔗 学习系统协调器
                   (路由 · 去重 · 按需汇总)
                              │
      ┌───────────────────────┼───────────────────────┐
      ▼                       ▼                       ▼
 ❌ 错题本 ──wrong_answer_handover──▶ 各学科错误 DNA
      ▲                                     │
      └────────deep_analysis_writeback──────┘

 🧬 学习DNA ◀── profile_writeback(通用层)
            ◀── subject_profile_writeback(subjectExtensions / extensions)
            ◀── teacher_writeback(老师端,需 teacherWritebackConsent)

 ⏰ IM智能提醒 ◀── reminder_enqueue ──── 各 SKILL
               ──── reminder_sync ────▶ 发送方
10.2 本系统实际使用的 handoverType 清单
handoverType谁发谁收必填 payload必检 consent 位
wrong_answer_handoverxiaozhi-correction-notebook各学科错误 DNAwrongAnswerDatacrossSkillSharing
deep_analysis_writeback各学科错误 DNAxiaozhi-correction-notebookdeepAnalysisDatacrossSkillSharing
profile_writeback通用端 SKILLxiaozhi-learning-dnaprofileDatacrossSkillSharing;updateTarget=emotion_dimension 时另需 emotionTrackingConsent=true
subject_profile_writeback学科端与通用扩展 SKILLxiaozhi-learning-dnaprofileData(subjectExtensionPatch / extensionPatch)crossSkillSharing
reminder_enqueue任意 SKILLxiaozhi-im-reminderreminderDatareminderConsent
reminder_syncxiaozhi-im-reminder原发送方reminderDatareminderConsent
teacher_writeback老师端 SKILLxiaozhi-learning-dnateacherWritebackDatateacherWritebackConsent=true

七种类型全部要校验:sessionId / protocolVersion / handoverType / sender / recipient / consent / payload / timestamp 均为必填;sender 与 recipient 必须取自 schema 的 SKILL 枚举;consent.crossSkillSharing 必填。

10.3 校验示例

错题交接(完整示例见 schemas/examples/wrong-answer-handover.example.json):

json
{
  "sessionId": "sess-demo-001",
  "protocolVersion": "2.11.1",
  "handoverType": "wrong_answer_handover",
  "sender": "xiaozhi-correction-notebook",
  "recipient": "xiaozhi-math-error-dna",
  "consent": { "crossSkillSharing": true, "verifiedAt": "2026-05-11T20:00:00+08:00" },
  "payload": {
    "wrongAnswerData": {
      "errorId": "err-20260511-003",
      "subject": "math",
      "concept": "一次函数解析式推导",
      "handoverTrigger": "stubborn_weakness",
      "basicDimension": "概念模糊",
      "occurrenceCountInWindow": 3,
      "surfaceInfo": {
        "questionAbstract": "已知直线过(1,3)和(2,5),求解析式",
        "studentAnswer": "y=2x+3",
        "correctAnswer": "y=2x+1",
        "surfaceRootCause": "代入一个点后直接把 b 写成 3"
      }
    }
  },
  "timestamp": "2026-05-11T20:01:00+08:00"
}

扩展档案回写(完整示例见 schemas/examples/subject-profile-writeback.example.json):

json
{
  "sessionId": "sess-demo-005",
  "protocolVersion": "2.11.1",
  "handoverType": "subject_profile_writeback",
  "sender": "xiaozhi-time-focus-coach",
  "recipient": "xiaozhi-learning-dna",
  "consent": { "crossSkillSharing": true, "verifiedAt": "2026-05-12T21:00:00+08:00" },
  "payload": {
    "profileData": {
      "updateTarget": "extension",
      "extensionPatch": {
        "focus": {
          "goldenSlots": ["晚饭后 1 小时"],
          "avgFocusMinutes": 22,
          "confidenceLevel": "preliminary_trend",
          "lastUpdated": "2026-05-12"
        }
      }
    }
  },
  "timestamp": "2026-05-12T21:01:00+08:00"
}

其余五类的示例见 schemas/examples/ 目录。

10.4 校验失败时的处理
  1. 阻断写入:格式不合规的数据一律不写入长期档案。
  2. 降级不中断:本次对话降级为"单会话纯文本诊断",继续为学生服务,并如实说明"这条记录我没能存进去"。
  3. 不重试超过一次:同一条交接最多重投一次,仍失败就放弃并记入本次会话说明。

十一、禁止行为

❌ 禁止✅ 替代
按月自行触发全景月报由用户明确请求时生成
全量拉取全部活跃SKILL的数据只拉取当前任务所需摘要
默认写回学习DNA成长轨迹仅在用户同意时写回必要摘要
默认同步到IM提醒仅在用户明确同意提醒后同步

十二、参考资源

  • references/one-week-linkage-record.md - 完整的一周联动实录案例
  • schemas/handover-protocol.schema.json - 七种 handoverType 的字段定义
  • schemas/examples/ - 七类交接的合法示例(收发双方都是其他 SKILL;协调器只定义协议、校验格式、按路由表分发,自己不发写回、不存档案)
  • shared/vocab.md §5(3 次口径)/ §8(授权位)/ §9(提醒预算)/ §11(命名)
  • shared/crisis-exception.md - 危机例外三行片段
  • shared/ai-item-check.md - 本 SKILL 不出题;被路由到的 SKILL 出题前按此协议自检

💡 小智说: "一道错题的价值,远不止于‘改对’。
它还应该告诉你:你为什么会错、你是不是真的懂了、
你有没有留下笔记、你能不能执行下去。
当这些环节连起来,学习系统才真的开始运转。"

© 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 student/general/xiaozhi-skill-coordinator of qizhitang/xiaozhi-skills.

  • SKILL.md
  • references/one-week-linkage-record.md
  • schemas/examples/deep-analysis-writeback.example.json
  • schemas/examples/reminder-enqueue.example.json
  • schemas/examples/subject-profile-writeback.example.json
  • schemas/examples/teacher-writeback.example.json
  • schemas/examples/wrong-answer-handover.example.json
  • schemas/handover-protocol.schema.json
  • shared/ai-item-check.md
  • shared/crisis-exception.md
  • shared/crisis-referral-protocol.md
  • shared/grade-bands.md
  • shared/hint-ladder.md
  • shared/platform-conventions.md
  • shared/vocab.md

Open the folder on GitHubat commit c65f2d4

Compare with similar skills

Xiaozhi Skill Coordinator 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 Skill Coordinator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Xiaozhi Skill Coordinator this skillqizhitang/xiaozhi-skills105—~3.2kAutomated 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 yesterday
    Auto-check passed
  • Xiaozhi Biology Concept Network

    qizhitang/xiaozhi-skills

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

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

    qizhitang/xiaozhi-skills

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

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

    qizhitang/xiaozhi-skills

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

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

    qizhitang/xiaozhi-skills

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

    105 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Xiaozhi Bridge Planner

    qizhitang/xiaozhi-skills

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

    105 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Xiaozhi Skill Coordinator

What does Xiaozhi Skill Coordinator do?

学习系统协调器:判断一次学习问题该由哪个 SKILL 接手,并在用户请求时汇总全景月报. An agent skill from qizhitang/xiaozhi-skills. Xiaozhi Skill Coordinator is an agent skill from qizhitang/xiaozhi-skills.

When should I use Xiaozhi Skill Coordinator?

Xiaozhi Skill Coordinator fits situations like: education work in your project.

How do I install Xiaozhi Skill Coordinator in Claude Code?

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

How do I install Xiaozhi Skill Coordinator in Codex?

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

Can I use Xiaozhi Skill Coordinator 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-skill-coordinator -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-skill-coordinator, .gemini/skills/xiaozhi-skill-coordinator, .github/skills/xiaozhi-skill-coordinator and .opencode/skills/xiaozhi-skill-coordinator in your project.

What does Xiaozhi Skill Coordinator need to run?

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

Does Xiaozhi Skill Coordinator 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 Skill Coordinator 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 Skill Coordinator use?

Xiaozhi Skill Coordinator 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 Skill Coordinator use?

About 3.2k tokens (SKILL.md is roughly 13k 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 2.2k tokens, read only when the agent opens those files.

What are the alternatives to Xiaozhi Skill Coordinator?

Skills that share tags, products or a category with Xiaozhi Skill Coordinator: 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 Skill Coordinator?

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.