v2.1.6 to v2.1.7

---

name: xiaozhi-skill-coordinator

description: >

学习系统协调器：判断一次学习问题该由哪个 SKILL 接手，并在用户请求时汇总全景月报。

学生说“帮我生成全景月报”“我的学习系统运转得好吗”“这道题该找谁分析”“这周该先补哪一环”时可激活。

它不自己讲题、不自己分析错因、不自己出题、不发提醒——只做路由、去重与汇总；周报归每周学习复盘。

仅在当前任务需要且用户已同意相关数据使用时按最小必要字段汇总，不做跨SKILL全量拉取或写回。

compatibility: WorkBuddy / SkillHub / OpenClaw / ClawHub

license: MIT

metadata:

display_name: 🔗 学习系统协调器

author: 小智伴学

category: 通用核心

grade_bands:

- 小学中段

- 小学高段

- 初中

- 高中

tags: [联动, 协调, 错题本, 费曼测试, 康奈尔笔记, 学习计划, 时间专注, 月报, 系统级]

depends_on:

- xiaozhi-learning-dna

- xiaozhi-correction-notebook

- xiaozhi-feynman-learning

- xiaozhi-cornell-notes

---

# 🔗 学习系统协调器 SKILL

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

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

> 特有降级：无跨会话统计（X）时，月报只汇总用户在本次会话提供的内容，并注明"本报告只覆盖你刚才告诉我的部分"；不编造历史数字。

### 隐私与数据控制入口

```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²/°；图片含坐标系、几何图形、算式竖式 | `xiaozhi-math-error-dna`（错题）/ `xiaozhi-math-problem-solving-coach`（当下这道题）|

| 物理 | 受力、电路、浮力、压强、功、速度、电流；单位 N/Pa/m·s⁻¹/A/V/Ω/J/W；图片含受力示意图、电路图、光路图、刻度尺 | `xiaozhi-physics-error-dna` / `xiaozhi-physics-problem-coach` |

| 英语 | 时态、从句、单词、词组、听力、口语、作文；出现连续英文句子；图片含英文题干或短文 | `xiaozhi-english-grammar-coach` / `xiaozhi-english-vocabulary-dna` |

| 语文 | 阅读理解、赏析、修辞、文言、病句、作文、古诗；图片含大段中文短文、文言篇目 | `xiaozhi-chinese-reading-decoder` / `xiaozhi-chinese-writing-coach` / `xiaozhi-chinese-grammar-tracker` |

| 跨科 / 不确定 | 主题类问题（丝绸之路、气候变化）、"这两科好像有关系" | `xiaozhi-cross-subject-detective` |

判别规则：

- **单位优先于关键词**：出现 N / Pa / Ω 一律先按物理判。

- **图片特征优先于文字**：电路图判物理，坐标系判数学。

- **判不准就问一句**："这题是数学还是物理的？"——不要凭猜测路由。

- 学科端只经**错题本**接收错题交接（`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 时提醒你"，只说"我把它加进你的提醒队列了"。

---

## 十、交接协议与校验

所有跨 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_handover` | `xiaozhi-correction-notebook` | 各学科错误 DNA | `wrongAnswerData` | `crossSkillSharing` |

| `deep_analysis_writeback` | 各学科错误 DNA | `xiaozhi-correction-notebook` | `deepAnalysisData` | `crossSkillSharing` |

| `profile_writeback` | 通用端 SKILL | `xiaozhi-learning-dna` | `profileData` | `crossSkillSharing`；`updateTarget=emotion_dimension` 时另需 `emotionTrackingConsent=true` |

| `subject_profile_writeback` | 学科端与通用扩展 SKILL | `xiaozhi-learning-dna` | `profileData`（`subjectExtensionPatch` / `extensionPatch`） | `crossSkillSharing` |

| `reminder_enqueue` | 任意 SKILL | `xiaozhi-im-reminder` | `reminderData` | `reminderConsent` |

| `reminder_sync` | `xiaozhi-im-reminder` | 原发送方 | `reminderData` | `reminderConsent` |

| `teacher_writeback` | 老师端 SKILL | `xiaozhi-learning-dna` | `teacherWritebackData` | `teacherWritebackConsent=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",

"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",

"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/` - 七类交接的合法示例

- `shared/vocab.md` §5（3 次口径）/ §8（授权位）/ §9（提醒预算）/ §11（命名）

- `shared/crisis-exception.md` - 危机例外三行片段

- `shared/ai-item-check.md` - 本 SKILL 不出题；被路由到的 SKILL 出题前按此协议自检

---

> 💡 **小智说：**

> "一道错题的价值，远不止于‘改对’。

> 它还应该告诉你：你为什么会错、你是不是真的懂了、

> 你有没有留下笔记、你能不能执行下去。

> 当这些环节连起来，学习系统才真的开始运转。"