技能介绍

要解决什么问题

个人或团队把 PDF、Word、Markdown 教材堆在文件夹里时，常见两种失败模式：要么让模型凭记忆「讲课本」，容易幻觉；要么把内容重写成 wiki，维护成本高、还和原文脱节。本技能走 检索式 路径：不编译知识，只索引原文，回答必须来自 textbooks/、INDEX.md、笔记与 wiki 检索结果。

技能如何工作

初始化：用户说「初始化」或「创建知识库」时，按流程复制 scripts/、建目录、生成 INDEX.md、CHANGELOG.md、.wiki-state.json，INDEX 行格式为「标准术语 | 同义词 → 文件路径」。

每次提问：先抽 3～5 个关键词（非标准说法映射到术语），再必须调用 scripts/q.sh，按优先级查 wiki 仓（entities → concepts → topics）、INDEX、notes、textbooks/ 全文；据输出读 2～4 个文件，原文有 ![图X-X] 须在回答中保留引用。

导入与维护：「导入 xxx 教材」走自动管道（PDF 类型检测、OCR、配图进 figures/、OKF frontmatter、知识点写入 INDEX、wiki 构建与 sync.sh）；.md/.docx 有对应分支。INDEX 禁止手改，用 index-add.sh / sync.sh；删改 wiki 用脚本，避免状态不同步。

适用边界

未命中（INDEX、教材全文、wiki/notes 均为空）时 必须拒绝，不得用模型常识补答。跨文件推理须标注「综合判断」；教材矛盾如实列出，不替用户调和。笔记可通过「保存/记下来」进入 notes/，后续检索可命中，但低置信度内容仍应谨慎引用。

截图预览

使用场景

把手头 PDF 或 Word 教材说「导入 xxx」，走 OCR、配图与 OKF 流程，之后答疑只读 textbooks/ 原文并标注文件出处。
复习某章节前先让模型跑 q.sh：按 INDEX 与同义词映射定位 2～4 个 md 文件，回答里保留原文中的配图引用。
新增一章 Markdown 到 textbooks/ 后，用 index-add 提取知识点更新 INDEX，再 sync 生成 wiki，避免手改 INDEX 导致状态不一致。
讨论中口径已确认时说「保存/记下来」，写入 notes/，下次同类问题由 q.sh 一并检索 notes 与教材。