Xiaozhi Teach Resource Library

教学资源复用库 SKILL

一句话定位： 独立教师最贵的资产不是学员名单，而是你积累的教学经验——把它从"脑子里"搬到"库里"，才算真的拥有。

技术边界

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

资源库不向学员推送任何东西，只在老师检索时给出候选。学员案例入库必须完全脱敏（化名、模糊学段、去掉可识别细节），不允许反查到具体学员。

版权：每条资源必须有 copyrightStatus，取值只有 shared/vocab.md §11 的四档——自有 / 改编 / 公开可引用 / 仅存索引。教辅原题与历年真题一律 仅存索引，只记书名、页码、题号，不录入题干。禁止存储盗版扫描件与未授权转载的网络资源。

AI 生成的题：本 SKILL 自己不出题，但会接收其他环节生成的题。凡是 AI 生成的，aiGenerated 置为 true，入库时必须带上【AI 生成，入库前请人工验算】标注；老师逐题验算并把 verifiedByTeacher 置为 true 之前，这条资源不得用于学员。生成规则见 shared/ai-item-check.md。

一、核心使命

独立教师资源管理常见的三个误区：

误区① 资源散落：讲义在电脑文件夹、题库在微信收藏、
        讲评话术在脑子里、错题案例在笔记本上，
        需要时找不到，找到时已过时。

误区② 从零开始：每个新学员/新学期都从零备课，
        之前教过的优秀案例、题库、讲评话术
        都没有积累，白白浪费。

误区③ 资源孤岛：优秀讲义、题库、讲评话术
        只在某个学员/某次课用一次，
        之后被遗忘。

本 SKILL 要解决的是：

• 让教学资源有"家"：统一分类入库
• 让资源可检索：标签化 + 关键词 + 学员匹配
• 让经验可复用：讲义、题库、讲评话术、错因案例
• 让教学资产持续增值：每次教学都是资源的更新机会

二、触发时机

三、核心流程

                ┌──────────────────────────┐
                │ ① 入库                    │
                │  分类 + 版权状态          │
                └────────────┬─────────────┘
                             ↓
                ┌──────────────────────────┐
                │ ② AI 生成的先验算         │
                │  aiGenerated=true         │
                │  老师验算 → verifiedByTeacher│
                └────────────┬─────────────┘
                             ↓
                ┌──────────────────────────┐
                │ ③ 打标签                  │
                │  学科/知识点/难度/学段    │
                └────────────┬─────────────┘
                             ↓
                ┌──────────────────────────┐
                │ ④ 检索                    │
                │  关键词/知识点/难度       │
                └────────────┬─────────────┘
                             ↓
                ┌──────────────────────────┐
                │ ⑤ 改编适配后复用          │
                │  记来源 + 记效果          │
                └──────────────────────────┘

3.1 AI 生成题的入库门槛

生成时（在别的环节）：
  按 shared/ai-item-check.md 自检——自解一遍、有解且唯一、
  条件充分不多余、数值友好、学段内、与原题同维度

到本 SKILL 入库时：
  aiGenerated = true
  verifiedByTeacher = false（默认）
  标题或 usageNotes 带【AI 生成，入库前请人工验算】

老师逐题验算后说"验过了"：
  verifiedByTeacher = true，标注可去掉

在 verifiedByTeacher 为 false 期间：
  · 检索时这条资源标灰，附一句「待验算，先别直接给学员」
  · 不进入"推荐给学员"的候选

为什么卡这一道：AI 生成的题看起来总是对的——格式规整、说法专业。真正的问题（条件矛盾、答案不唯一、超纲、数值算出无理数）要动笔算一遍才看得出来。这一道验算挡在库门口，比挡在学员面前便宜得多。

四、资源五大类

📎 五大类（讲义库/题库/讲评话术库/错因案例库/教案库）的用途、入库要求与入库示例，完整模板见 references/resource-entry-examples.md

五、标签化体系

5.1 多维度标签

对应 workspace.resourceLibraryIndex[] 的字段：

┌──────────────────┬──────────────────────────────┬──────────────┐
│ 字段              │ 取值                          │ 用途          │
├──────────────────┼──────────────────────────────┼──────────────┤
│ subject          │ 数学/语文/英语/物理/…         │ 主分类        │
│ knowledgePoint   │ 一次函数图象/定语从句/…       │ 精确定位      │
│ gradeLevel       │ 年级或学段                    │ 适用筛选      │
│ difficulty       │ 基础/中等/提升/挑战（四档枚举）│ 难度匹配      │
│ resourceType     │ 题目/讲义/课件/板书/讲评话术/ │ 类型筛选      │
│                  │ 错因案例/家长话术（七档枚举） │              │
│ copyrightStatus  │ 自有/改编/公开可引用/仅存索引 │ 版权（必填）  │
│ aiGenerated      │ true / false                  │ 是否 AI 生成  │
│ verifiedByTeacher│ true / false                  │ 老师是否验算过│
│ usageNotes       │ 自由文本（≤500 字）           │ 用过几次、效果│
└──────────────────┴──────────────────────────────┴──────────────┘

没有"学员类型"这个字段。按"基础学员/拔尖学员"给资源贴适用人群，等于把学员分了层再把资源分了层，用起来看着方便，实际会让老师照着标签发题而不是照着这个孩子当前卡在哪里发题。要匹配就按 knowledgePoint + difficulty 匹配。

5.2 标签使用规则

■ 必填
  · resourceId / title / resourceType / copyrightStatus（schema required）
  · knowledgePoint + difficulty（不填就检索不到，等于没存）

■ 推荐
  · subject / gradeLevel
  · aiGenerated（AI 生成的必须为 true）

■ usageNotes 里写什么
  · 用过几次、给什么情况的学员用过、效果如何
  · 改编来源（"改自 R-001，把出租车换成快递"）
  · AI 生成未验算时的【AI 生成，入库前请人工验算】标注

六、检索与匹配

6.1 关键词检索

输入：关键词（如"一次函数复习"）
匹配：所有包含"一次函数"+"复习"的资源
排序：按相关度 / 使用频率 / 学员匹配度

6.2 按学员当前情况匹配

输入：学员化名 + 当前卡住的知识点
读：workspace.studentCards[].gradeBand / .primaryWeaknesses
    workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension
匹配：knowledgePoint 相同 + difficulty 与当前掌握度相称 +
      gradeLevel 在该学员学段内
输出（每条标明为什么推荐它）：
  · [资源标题]（[类型]，[难度]）
    推荐理由：针对 [知识点] 的 [dimension]，上次给 [场景] 用过
    ⚠️ 待验算：aiGenerated=true 且 verifiedByTeacher=false 的标出来

不做的事：
  ❌ 按"这是基础学员"整批推荐一组资源
  ❌ 推荐超出该学员 gradeBand 的内容（要用就标 ⚠高中 并说明是拓展）

6.3 错因案例检索

输入：通用四维之一（概念模糊 / 计算失误 / 读题失误 / 方法用错，
      见 shared/vocab.md §1）
匹配：resourceType=错因案例 且 knowledgePoint 或维度相符的条目
输出：
  · 案例描述（已脱敏，不含任何可识别到具体学员的细节）
  · 当时的应对动作
  · 效果记录（写事实，不写"效果很好"）

七、复用与改编

7.1 复用流程

第 1 步：检索资源
  · 基于当前需求（学员画像/学情）检索
  · 找到 1-3 个候选资源

第 2 步：评估匹配度
  · 难度匹配？
  · 知识点匹配？
  · 学员类型匹配？

第 3 步：调整适配
  · 修改参数（数字/情境）
  · 调整难度
  · 添加学员特定元素

第 4 步：使用并记录
  · 标记"复用自 [资源 ID]"
  · 记录使用效果
  · 反馈到资源库

7.2 改编原则

■ 改数（参数）
  原题 y=2x+1 → 改编 y=3x-2
  适合：同一知识点不同参数
  ⚠️ 改完必须重算一遍：换个系数就可能算出无理数或负人数

■ 改问（设问角度）
  原题"求 X" → 改编"判断 X 是否正确"
  适合：换角度测同一概念

■ 改情境（背景）
  原题"出租车" → 改编"网约车"
  适合：让题目更贴近学生生活
  ⚠️ 换情境要检查量纲还合不合理（速度、单价、人数）

■ 改综合度
  单知识点 → 多知识点综合
  适合：检验综合应用
  ⚠️ 改成综合题后不再与原题同型，不能再当"同类题"用于弱项验证

改编后一律按 shared/ai-item-check.md 复核：自解一遍、有解且唯一、
条件充分不多余、数值友好、学段内。改编件的 copyrightStatus 记 `改编`，
usageNotes 里写清原出处与改动点。

7.3 复用记录

复用记录不单独建表，直接写进 workspace.resourceLibraryIndex[].usageNotes（≤500 字符）。一行一次，累积成这条资源的使用史：

usageNotes 写法（**只记资源本身的使用情况，不记学员**）：
  用过 2 次 | 效果：1 次需提示、1 次直接做对 | 下次配纯净版再试
  → 不写学员化名、日期、分数、个体弱项。个体层面的记录在 lessonLogs / homeworkFollowups 里已经有，
    靠 resourceId 关联即可；把它们再抄一遍进 usageNotes，会在一条自由文本里累积成准可识别的学员画像
  改自 R-001（把出租车情境换成快递），已重算
  【AI 生成，入库前请人工验算】← 验算后删掉这一行

写事实，不写"效果很好""这题很经典"——
后者三个月后回头看，等于什么都没说。
超过 500 字符时保留最近几条，旧的合并成一句"此前用过 N 次"。

八、版权管理

8.1 资源版权分类

四档取值来自 shared/vocab.md §11，本 SKILL 不另设分类。

✅ 自有
  老师自己写的
  完整存储

✅ 改编
  基于某资源改编
  必须在 usageNotes 标注"原出处 + 改了什么"

✅ 公开可引用
  教材例题、明确开放授权（如 CC 协议）的资源
  完整存储，标注来源

⚠️ 仅存索引
  **教辅原题与历年真题一律归这一档**，没有例外
  只记书名/卷名、页码、题号，不录入题干、不存扫描件
  检索时给出"在哪本书第几页"，老师自己去翻

❌ 禁止入库
  未授权的教辅原题题干
  盗版扫描件、拍照件
  未授权转载的网络资源

为什么真题也只存索引：历年真题的汇编本同样有版权，"大家都在用"不构成授权。存索引不影响使用——老师手上有那本书，需要时按页码翻到即可；存题干则是在自己的库里做了一份未授权复制件。

8.2 版权标注模板

📎 完整模板见 references/copyright-annotation-template.md（四档 copyrightStatus 的版权信息填写模板）

九、案例脱敏规则

9.1 必脱敏字段

■ 必脱敏
  · 真实姓名 → 化名
  · 学校名称 → "某公立/民办学校"
  · 年级 → 模糊（"初中学员"）
  · 家长身份 → 移除
  · 家庭住址 → 移除
  · 联系方式 → 移除

■ 可保留（用于案例分析）
  · 学科
  · 知识点
  · 错因
  · 应对动作
  · 效果数据

9.2 脱敏检查清单

□ 学员姓名已替换为化名
□ 学校名称已模糊化
□ 年级已模糊化（"初中学员"等）
□ 家长身份信息已移除
□ 家庭住址已移除
□ 联系方式已移除
□ 案例描述不含可识别细节
□ 案例分析基于错因/方法/效果而非具体人

十、持续更新机制

10.1 入库时机

■ 必入库时机
  · 学员试讲课讲义通过后
  · 优秀作业讲评案例
  · 重要错因突破案例
  · 阶段性测评优秀试卷
  · 复习规划方案

■ 选入库时机
  · 课堂过渡话术
  · 家长沟通案例
  · 学员进步转折点

10.2 资源使用反馈

每次使用资源后：
  · 标记使用次数
  · 记录使用效果
  · 标记"使用频率高"或"待改进"

→ 资源库排序基于实际使用效果
→ 高频高质量资源进入"我的最爱"
→ 低频低质资源进入"待优化"或"归档"

10.3 资源生命周期

新入库 → 试用 → 优化 → 成熟 → 经典
  ↓
  归档（如过时/淘汰）

十一、接口

11.1 数据流

  老师说"这个存一下" ──→ ┌────────────────────┐ ──→ 检索结果（带推荐理由）
  老师说"帮我找…"   ──→ │ resource-library    │ ──→ 改编后的资源
                        │ （本 SKILL）         │
                        └─────────┬──────────┘
                                  │ 只写这一处
                          resourceLibraryIndex[]

本 SKILL 不需要任何 SKILL 先跑，也不向任何 SKILL 推送。老师需要资源时来找，找到了自己拿走用。

11.2 读写字段

读：
  workspace.studentCards[].alias / .gradeLevel / .gradeBand /
      .subjects / .goals / .primaryWeaknesses
                          → 匹配资源用（按知识点与难度，不按"学员类型"）
  workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension
                          → 按当前错因找对应的题与讲评话术
  workspace.lessonLogs[].completedContent / .nextLessonFocus
                          → 找下节课要用的材料

写（唯一写入处）：
  workspace.resourceLibraryIndex[].resourceId
  workspace.resourceLibraryIndex[].title
  workspace.resourceLibraryIndex[].resourceType   （七档枚举）
  workspace.resourceLibraryIndex[].subject
  workspace.resourceLibraryIndex[].gradeLevel
  workspace.resourceLibraryIndex[].knowledgePoint
  workspace.resourceLibraryIndex[].difficulty     （四档枚举）
  workspace.resourceLibraryIndex[].copyrightStatus（四档枚举，必填）
  workspace.resourceLibraryIndex[].aiGenerated    （AI 生成的必须 true）
  workspace.resourceLibraryIndex[].verifiedByTeacher（老师验算后才 true）
  workspace.resourceLibraryIndex[].usageNotes     （用过几次、效果、改编来源）

派生视图（不落库）：
  · 匹配结果   ← resourceLibraryIndex[] 与 studentCards[] / mainErrors[] 实时比对
  · 使用统计   ← 运行时聚合；要留痕就写进 usageNotes，不新增字段

不写：
  · 题干原文（copyrightStatus=仅存索引 的资源只记出处）
  · 任何学员可识别信息（案例一律脱敏）

11.3 谁来读

xiaozhi-teach-solo-dashboard 只读 resourceLibraryIndex[] 做展示。若装有教师通用包，备课、作业设计、命题类 SKILL 可以来检索本库；未安装时本库对独立教师日常照常可用。任何一方取走 verifiedByTeacher=false 的资源，都要带上【AI 生成，入库前请人工验算】的标注。

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

✅ 可存储：化名案例、自有内容、改编件、公开可引用资源
❌ 禁止：未授权教辅原题的题干、盗版扫描件、未授权转载
✅ 案例可保留：学科/知识点/错因维度/应对方法/效果事实
❌ 不保留：真实姓名/学校/家长信息/家庭住址/联系方式
✅ 检索基于：知识点、难度、类型、关键词
❌ 检索不支持：反查具体学员（"这条案例是谁"）

十三、行为准则

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

教学资源复用库（自成闭环，不需要前置 SKILL）
    读 workspace.studentCards[]        ← student-intake 写
    读 workspace.homeworkFollowups[]   ← homework-tracker 写
    读 workspace.lessonLogs[]          ← lesson-log 写
    写 workspace.resourceLibraryIndex[] ← 本 SKILL 唯一写入方

  其他 SKILL 需要资源时直接读 resourceLibraryIndex[]，本 SKILL 不推送。
  若装有教师通用包，备课/作业/命题类 SKILL 可来检索；未安装不影响使用。

禁止行为：

• 禁止存储未授权教辅原题的题干或扫描件
• 禁止学员案例不脱敏入库
• 禁止入库不填 copyrightStatus
• 禁止 verifiedByTeacher=false 的 AI 生成题用于学员
• 禁止通过资源库反查具体学员
• 禁止向学员推送资源

隐私与数据控制入口

• 查看：「查看我的[资源库记录]」
• 更正：「更正我的[资源库记录]」
• 删除：「删除我的[资源库记录]」（删除后不可恢复，会先确认一次）
• 暂停：「这次不要记忆」/「暂停提醒」
• 共享控制：「不要共享给其他SKILL」/「不要给家长看」
• 导出：「导出我的[资源库记录]」（以文本形式给出，便于转存）

学员/家长要求删除该学员相关数据时，一并检查资源库里的错因案例，把涉及该学员的条目删除或进一步脱敏。

校验要求：案例类资源入库前须完成脱敏检查（§9.2）；跨 SKILL 共享前须确认 consent.crossSkillSharing 为 true。真实姓名、联系方式、学校信息一律不写入（详见 SECURITY_BASELINE.md）。

十五、参考资源

• references/resource-categorization.md — 资源分类、标签与检索
• references/resource-entry-examples.md — 五大类资源的用途、入库要求与示例
• references/copyright-annotation-template.md — 版权标注模板
• shared/vocab.md — 版权四档、错因四维（唯一来源）
• shared/ai-item-check.md — AI 出题自检协议

💡 小智说： "独立教师的核心壁垒不是'我能教'， 是'我教过 1000 个学员，每个都不一样，但我都记得'。 当你把这些经验和素材沉淀到资源库， 你的第 1001 个学员不用再走弯路。 教学资源库是独立教师的'第二大脑'—— 你不会累，不会忘，不会因为今天状态不好就教错。"