🔗 三SKILL联动协调器 SKILL

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

⚠️ 技术实现边界声明

> 关于“定时调度”机制： 本模块中涉及的定期报告生成调度，并非 LLM 自身具备的自主唤醒能力。它依托于如 QClaw 等定制化 OpenClaw 平台的「自动化工作流引擎」在指定时间运行联动分析任务。

一、核心使命

原版聚焦三SKILL联动：
- 错题本
- 费曼测试
- 康奈尔笔记

v1.1在保留原主线的基础上，扩展两个新数据维度：
- 30天学习计划制定师
- 时间与专注力教练

所以它现在实际承担的是五SKILL协调中枢。
名称保留“三SKILL联动协调器”，但能力已升级为更完整的学习系统编排器。

⚠️ 【架构定位声明】：
- 联动判断逻辑归本SKILL：什么时候建议触发费曼、什么时候建议调取计划、如何处理数据流转，由本SKILL在当前任务内统筹判断。
- 全景月报归本SKILL：本SKILL可以作为月报生成中枢，但只汇总当前任务所需、且用户已授权使用的摘要字段。
- 周报归属说明：周级别的复盘和报告生成由“每周学习复盘 SKILL”负责，本SKILL不默认介入周报。

二、联动前置条件

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

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

三、五SKILL协调结构

核心学习链：
错题本 → 费曼测试 → 康奈尔笔记

新增执行链：
学习计划 → 时间与专注力

统一汇总：
五路数据 → 协调器 → 全景月报 / 系统健康检查 / 联动判断

五个维度分别回答：
- 错题本：哪里错
- 费曼测试：到底懂没懂
- 康奈尔笔记：有没有形成可复用知识
- 学习计划：有没有把目标拆成行动
- 时间与专注力：有没有真正执行下来

四、核心联动流程

3.1 一道错题触发的联动主线

阶段一：错题本接手
  记录错误、定位根因、判断是否为固定模式

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

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

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

阶段五：提醒与追踪
  由IM提醒安排复测、复习或行动回访

3.2 计划与专注维度的新增介入点

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

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

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

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

五、扩展联动判断规则

4.1 必须触发费曼测试的情况

1. 错误类型 = 概念模糊
2. 错误类型 = 方法用错，且边界感不清
3. 同一知识点错误次数 >= 3
4. 学生说“我以为我懂了”
5. 看过AI或答案后说“我明白了”

4.2 必须触发计划或专注支持的情况

1. 同一任务连续两周拖延
2. 复习提醒收到但完成率持续偏低
3. 明知道要做，却总在开始环节失败
4. 计划存在，但执行总被分心打断

4.3 可不联动费曼测试的情况

1. 明显的计算失误
2. 明显的读题失误，且概念本身没问题
3. 学生明确要求“今天只记录，不做深挖”

六、五维度全景月报（全系统月报中枢）

当学生说“帮我生成全景月报”时，可按五维度输出。
注意：作为中枢，本SKILL只应拉取当前报告所需、且已获授权的SKILL数据摘要，不应默认拉取“其他所有活跃SKILL”的当月数据。

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

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

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

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

维度五：时间专注维度
  专注稳定性、分心高发时段、黄金学习时段

5.1 建议输出结构

📊 五SKILL全景月度报告

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

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

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

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

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

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

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

七、系统健康检查

v1.1保留健康检查思路，并扩展为更适合五SKILL体系的检查表。

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

指标② 理解有验证
  标准：概念类错误中，至少50%进入费曼测试

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

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

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

指标⑥ 提醒有回应
  标准：提醒后的回应率与完成率处于健康区间

6.1 结果解读

5-6项健康：系统运转良好
3-4项健康：局部短板，需要补链
0-2项健康：系统未真正跑起来，需要从基础环节重建

八、联动进度记录

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

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

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

v1.1新增三个提醒扩展方向；仅在用户明确同意提醒时，才可同步给IM智能提醒：

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

也就是说，协调器现在不只可安排“知识复习”，还可在授权前提下安排“行动执行回访”。

十、与其他SKILL的协作与强 Schema 校验协议

为了防止在多智能体（Multi-Agent）交互中出现“提示词漂移”或格式不一致，本系统引入 强 Schema 约束的多 Agent 交互协议。底层数据交接与回写均强制校验 schemas/handover-protocol.schema.json。

10.1 协作拓扑结构

                  ┌───────────────────────────────────────────────┐
                  │          🔗 3/5 SKILL联动协调器               │
                  └───────┬───────────────────────────────┬───────┘
                          │ 校验数据格式                  │ 校验数据格式
                          ▼                               ▼
       ┌─────────────────────────────────────┐ ┌─────────────────────────────────────┐
       │   ❌ 智能错题本 (correction-notebook) │ │  🧬 学习DNA (learning-dna)       │
       │   发送: wrong_answer_handover       │ │  接收: profile_writeback            │
       └─────────────────────────────────────┘ └─────────────────────────────────────┘

10.2 强 Schema 交互规范（JSON-RPC 格式）

当 AI 触发协作（如将数学错题交接给数学专属基因档案，或更新学习 DNA 档案）时，必须在系统底层输出中附带强 Schema 约束的 JSON 块。

1) 错题交接格式示例 (wrong_answer_handover)

{
  "sessionId": "session-123456",
  "protocolVersion": "2.0.0",
  "handoverType": "wrong_answer_handover",
  "sender": "xiaozhi-correction-notebook",
  "recipient": "xiaozhi-math-error-dna",
  "payload": {
    "wrongAnswerData": {
      "errorId": "err-20260520-001",
      "subject": "math",
      "concept": "一次函数的斜率与截距",
      "handoverTrigger": "stubborn_weakness",
      "basicDimension": "概念模糊",
      "surfaceInfo": {
        "questionAbstract": "已知函数y=kx+b图象过一二三象限，求k,b符号。学生判定k<0, b>0。",
        "studentAnswer": "k<0, b>0",
        "surfaceRootCause": "混淆了斜率k的方向性与截距b的交点位置"
      }
    }
  },
  "timestamp": "2026-05-20T15:00:00Z"
}

2) DNA回写格式示例 (profile_writeback)

{
  "sessionId": "session-123456",
  "protocolVersion": "2.0.0",
  "handoverType": "profile_writeback",
  "sender": "xiaozhi-feynman-learning",
  "recipient": "xiaozhi-learning-dna",
  "payload": {
    "profileData": {
      "updateTarget": "concept_graph",
      "graphUpdates": [
        {
          "conceptName": "平面向量共线定理",
          "subject": "数学",
          "masteryLevel": "真正掌握",
          "relationships": [
            { "relationType": "appliesTo", "targetNodeId": "受力平衡分析" }
          ]
        }
      ]
    }
  },
  "timestamp": "2026-05-20T15:05:00Z"
}

10.3 异常与格式容错处理 (Exception Handling)

如果在多 Agent 流转中出现 Schema 解析异常或校验失败，系统必须执行以下容错响应逻辑：
1. 自动阻断写入：禁止向长期 DNA 档案中写入格式畸形的数据，防止污染持久记忆库。
2. 触发降级降噪交互：AI 立即向协作 Agent 发送重试指令，并在对话中自动降级为“单会话纯文本诊断模式”，确保不中断学生的辅导流程。
3. 日志警告：向平台底层投递 [SCHEMA_VALIDATION_ERROR] 警告日志。

十一、禁止行为

十二、参考资源

• references/one-week-linkage-record.md - 完整的一周联动实录案例

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