--- name: xiaozhi-teach-resource-library description: > 把独立教师散在文件夹、微信收藏和笔记本里的讲义、题目、讲评话术、错因案例收进一个可检索的库。 适用于老师说"帮我找一下 [X] 的讲义""有没有 [X 题型] 的题""这类错题怎么讲评""这个讲义存一下""教过的类似案例""这个教案能给别的学员用吗""资源怎么分类"。 流程：入库时打标签与版权状态 → 按知识点/难度检索 → 改编适配后复用 → 记录用过几次、效果如何。 本 SKILL 不出题、不备课、不批改、不联系家长——只管资源的存、找、改；AI 生成的题必须老师验算后才算入库。 compatibility: WorkBuddy / SkillHub / OpenClaw / ClawHub license: MIT metadata: display_name: 教学资源复用库 version: 2.1.8 author: 小智伴学 category: 独立教师 grade_bands: - 小学中段 - 小学高段 - 初中 - 高中 tags: [资源库, 讲义题库, 讲评话术, 错因案例, 教学复用, 独立教师] depends_on: - xiaozhi-teach-homework-tracker id: openclaw:xiaozhi-teach-resource-library min_platform_version: "2.0" max_round_limit: 20 --- # 教学资源复用库 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`。 --- ## 一、核心使命 独立教师资源管理常见的三个误区： ```text 误区① 资源散落：讲义在电脑文件夹、题库在微信收藏、 讲评话术在脑子里、错题案例在笔记本上， 需要时找不到，找到时已过时。 误区② 从零开始：每个新学员/新学期都从零备课， 之前教过的优秀案例、题库、讲评话术 都没有积累，白白浪费。 误区③ 资源孤岛：优秀讲义、题库、讲评话术 只在某个学员/某次课用一次， 之后被遗忘。 ``` 本 SKILL 要解决的是： - **让教学资源有"家"**：统一分类入库 - **让资源可检索**：标签化 + 关键词 + 学员匹配 - **让经验可复用**：讲义、题库、讲评话术、错因案例 - **让教学资产持续增值**：每次教学都是资源的更新机会 --- ## 二、触发时机 | 触发场景 | 示例语句 | |---------|---------| | 资源检索 | "帮我找一下 [X 讲义]" / "有没有 [X 题型]" | | 讲评话术 | "这类错题怎么讲评" / "讲评怎么说" | | 学员匹配 | "[化名] 适合什么资源" | | 案例查找 | "教过的案例" / "类似情况怎么处理" | | 资源入库 | "这个讲义/题库/案例存一下" | | 资源管理 | "资源怎么分类" / "教学资源库" | | 错因案例 | "学员犯过这种错吗" / "类似错因" | | 教案复用 | "这个教案可以给另一个学员用吗" | --- ## 三、核心流程 ```text ┌──────────────────────────┐ │ ① 入库 │ │ 分类 + 版权状态 │ └────────────┬─────────────┘ ↓ ┌──────────────────────────┐ │ ② AI 生成的先验算 │ │ aiGenerated=true │ │ 老师验算 → verifiedByTeacher│ └────────────┬─────────────┘ ↓ ┌──────────────────────────┐ │ ③ 打标签 │ │ 学科/知识点/难度/学段 │ └────────────┬─────────────┘ ↓ ┌──────────────────────────┐ │ ④ 检索 │ │ 关键词/知识点/难度 │ └────────────┬─────────────┘ ↓ ┌──────────────────────────┐ │ ⑤ 改编适配后复用 │ │ 记来源 + 记效果 │ └──────────────────────────┘ ``` ### 3.1 AI 生成题的入库门槛 ```text 生成时（在别的环节）： 按 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[]` 的字段： ```text ┌──────────────────┬──────────────────────────────┬──────────────┐ │ 字段 │ 取值 │ 用途 │ ├──────────────────┼──────────────────────────────┼──────────────┤ │ subject │ 数学/语文/英语/物理/… │ 主分类 │ │ knowledgePoint │ 一次函数图象/定语从句/… │ 精确定位 │ │ gradeLevel │ 年级或学段 │ 适用筛选 │ │ difficulty │ 基础/中等/提升/挑战（四档枚举）│ 难度匹配 │ │ resourceType │ 题目/讲义/课件/板书/讲评话术/ │ 类型筛选 │ │ │ 错因案例/家长话术（七档枚举） │ │ │ copyrightStatus │ 自有/改编/公开可引用/仅存索引 │ 版权（必填） │ │ aiGenerated │ true / false │ 是否 AI 生成 │ │ verifiedByTeacher│ true / false │ 老师是否验算过│ │ usageNotes │ 自由文本（≤500 字） │ 用过几次、效果│ └──────────────────┴──────────────────────────────┴──────────────┘ ``` **没有"学员类型"这个字段**。按"基础学员/拔尖学员"给资源贴适用人群，等于把学员分了层再把资源分了层，用起来看着方便，实际会让老师照着标签发题而不是照着这个孩子当前卡在哪里发题。要匹配就按 `knowledgePoint` + `difficulty` 匹配。 ### 5.2 标签使用规则 ```text ■ 必填 · resourceId / title / resourceType / copyrightStatus（schema required） · knowledgePoint + difficulty（不填就检索不到，等于没存） ■ 推荐 · subject / gradeLevel · aiGenerated（AI 生成的必须为 true） ■ usageNotes 里写什么 · 用过几次、给什么情况的学员用过、效果如何 · 改编来源（"改自 R-001，把出租车换成快递"） · AI 生成未验算时的【AI 生成，入库前请人工验算】标注 ``` --- ## 六、检索与匹配 ### 6.1 关键词检索 ```text 输入：关键词（如"一次函数复习"） 匹配：所有包含"一次函数"+"复习"的资源 排序：按相关度 / 使用频率 / 学员匹配度 ``` ### 6.2 按学员当前情况匹配 ```text 输入：学员化名 + 当前卡住的知识点 读：workspace.studentCards[].gradeBand / .primaryWeaknesses workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension 匹配：knowledgePoint 相同 + difficulty 与当前掌握度相称 + gradeLevel 在该学员学段内 输出（每条标明为什么推荐它）： · [资源标题]（[类型]，[难度]） 推荐理由：针对 [知识点] 的 [dimension]，上次给 [场景] 用过 ⚠️ 待验算：aiGenerated=true 且 verifiedByTeacher=false 的标出来 不做的事： ❌ 按"这是基础学员"整批推荐一组资源 ❌ 推荐超出该学员 gradeBand 的内容（要用就标 ⚠高中 并说明是拓展） ``` ### 6.3 错因案例检索 ```text 输入：通用四维之一（概念模糊 / 计算失误 / 读题失误 / 方法用错， 见 shared/vocab.md §1） 匹配：resourceType=错因案例 且 knowledgePoint 或维度相符的条目 输出： · 案例描述（已脱敏，不含任何可识别到具体学员的细节） · 当时的应对动作 · 效果记录（写事实，不写"效果很好"） ``` --- ## 七、复用与改编 ### 7.1 复用流程 ```text 第 1 步：检索资源 · 基于当前需求（学员画像/学情）检索 · 找到 1-3 个候选资源 第 2 步：评估匹配度 · 难度匹配？ · 知识点匹配？ · 学员类型匹配？ 第 3 步：调整适配 · 修改参数（数字/情境） · 调整难度 · 添加学员特定元素 第 4 步：使用并记录 · 标记"复用自 [资源 ID]" · 记录使用效果 · 反馈到资源库 ``` ### 7.2 改编原则 ```text ■ 改数（参数） 原题 y=2x+1 → 改编 y=3x-2 适合：同一知识点不同参数 ⚠️ 改完必须重算一遍：换个系数就可能算出无理数或负人数 ■ 改问（设问角度） 原题"求 X" → 改编"判断 X 是否正确" 适合：换角度测同一概念 ■ 改情境（背景） 原题"出租车" → 改编"网约车" 适合：让题目更贴近学生生活 ⚠️ 换情境要检查量纲还合不合理（速度、单价、人数） ■ 改综合度 单知识点 → 多知识点综合 适合：检验综合应用 ⚠️ 改成综合题后不再与原题同型，不能再当"同类题"用于弱项验证 改编后一律按 shared/ai-item-check.md 复核：自解一遍、有解且唯一、 条件充分不多余、数值友好、学段内。改编件的 copyrightStatus 记 `改编`， usageNotes 里写清原出处与改动点。 ``` ### 7.3 复用记录 复用记录**不单独建表**，直接写进 `workspace.resourceLibraryIndex[].usageNotes`（≤500 字符）。一行一次，累积成这条资源的使用史： ```text usageNotes 写法（**只记资源本身的使用情况，不记学员**）： 用过 2 次 | 效果：1 次需提示、1 次直接做对 | 下次配纯净版再试 → 不写学员化名、日期、分数、个体弱项。个体层面的记录在 lessonLogs / homeworkFollowups 里已经有， 靠 resourceId 关联即可；把它们再抄一遍进 usageNotes，会在一条自由文本里累积成准可识别的学员画像 改自 R-001（把出租车情境换成快递），已重算 【AI 生成，入库前请人工验算】← 验算后删掉这一行 写事实，不写"效果很好""这题很经典"—— 后者三个月后回头看，等于什么都没说。 超过 500 字符时保留最近几条，旧的合并成一句"此前用过 N 次"。 ``` --- ## 八、版权管理 ### 8.1 资源版权分类 四档取值来自 `shared/vocab.md §11`，本 SKILL 不另设分类。 ```text ✅ 自有 老师自己写的 完整存储 ✅ 改编 基于某资源改编 必须在 usageNotes 标注"原出处 + 改了什么" ✅ 公开可引用 教材例题、明确开放授权（如 CC 协议）的资源 完整存储，标注来源 ⚠️ 仅存索引 **教辅原题与历年真题一律归这一档**，没有例外 只记书名/卷名、页码、题号，不录入题干、不存扫描件 检索时给出"在哪本书第几页"，老师自己去翻 ❌ 禁止入库 未授权的教辅原题题干 盗版扫描件、拍照件 未授权转载的网络资源 ``` **为什么真题也只存索引**：历年真题的汇编本同样有版权，"大家都在用"不构成授权。存索引不影响使用——老师手上有那本书，需要时按页码翻到即可；存题干则是在自己的库里做了一份未授权复制件。 ### 8.2 版权标注模板 > 📎 完整模板见 `references/copyright-annotation-template.md`（四档 copyrightStatus 的版权信息填写模板） --- ## 九、案例脱敏规则 ### 9.1 必脱敏字段 ```text ■ 必脱敏 · 真实姓名 → 化名 · 学校名称 → "某公立/民办学校" · 年级 → 模糊（"初中学员"） · 家长身份 → 移除 · 家庭住址 → 移除 · 联系方式 → 移除 ■ 可保留（用于案例分析） · 学科 · 知识点 · 错因 · 应对动作 · 效果数据 ``` ### 9.2 脱敏检查清单 ```text □ 学员姓名已替换为化名 □ 学校名称已模糊化 □ 年级已模糊化（"初中学员"等） □ 家长身份信息已移除 □ 家庭住址已移除 □ 联系方式已移除 □ 案例描述不含可识别细节 □ 案例分析基于错因/方法/效果而非具体人 ``` --- ## 十、持续更新机制 ### 10.1 入库时机 ```text ■ 必入库时机 · 学员试讲课讲义通过后 · 优秀作业讲评案例 · 重要错因突破案例 · 阶段性测评优秀试卷 · 复习规划方案 ■ 选入库时机 · 课堂过渡话术 · 家长沟通案例 · 学员进步转折点 ``` ### 10.2 资源使用反馈 ```text 每次使用资源后： · 标记使用次数 · 记录使用效果 · 标记"使用频率高"或"待改进" → 资源库排序基于实际使用效果 → 高频高质量资源进入"我的最爱" → 低频低质资源进入"待优化"或"归档" ``` ### 10.3 资源生命周期 ```text 新入库 → 试用 → 优化 → 成熟 → 经典 ↓ 归档（如过时/淘汰） ``` --- ## 十一、接口 ### 11.1 数据流 ```text 老师说"这个存一下" ──→ ┌────────────────────┐ ──→ 检索结果（带推荐理由） 老师说"帮我找…" ──→ │ resource-library │ ──→ 改编后的资源 │ （本 SKILL） │ └─────────┬──────────┘ │ 只写这一处 resourceLibraryIndex[] ``` 本 SKILL 不需要任何 SKILL 先跑，也不向任何 SKILL 推送。老师需要资源时来找，找到了自己拿走用。 ### 11.2 读写字段 ```text 读： 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 生成，入库前请人工验算】的标注。 --- ## 十二、字段级高敏信息防护 ```text ✅ 可存储：化名案例、自有内容、改编件、公开可引用资源 ❌ 禁止：未授权教辅原题的题干、盗版扫描件、未授权转载 ✅ 案例可保留：学科/知识点/错因维度/应对方法/效果事实 ❌ 不保留：真实姓名/学校/家长信息/家庭住址/联系方式 ✅ 检索基于：知识点、难度、类型、关键词 ❌ 检索不支持：反查具体学员（"这条案例是谁"） ``` --- ## 十三、行为准则 | ✅ 应该做 | ❌ 不能做 | |---------|---------| | 入库即填 knowledgePoint + difficulty | 存了不打标签，等于没存 | | 案例入库前逐条脱敏 | 真实学员案例直接入库 | | 教辅/真题一律仅存索引 | 把题干抄进库里 | | AI 生成的标 aiGenerated | 混进库里看不出是 AI 写的 | | 老师验算后才 verifiedByTeacher | 未验算就发给学员 | | 改编后重新验算一遍 | 改完数字直接用 | | 用过之后写进 usageNotes | 用了不留痕，下次重新判断 | | 按知识点 + 难度匹配 | 按"基础学员/拔尖学员"整批推 | --- ## 十四、与其他 SKILL 的协同清单 ```text 教学资源复用库（自成闭环，不需要前置 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 个学员不用再走弯路。 > 教学资源库是独立教师的'第二大脑'—— > 你不会累，不会忘，不会因为今天状态不好就教错。"