knowledge-base-query
查询 physics-wiki 知识库中某个主题已有哪些内容,快速定位相关页面、推导、方法和讲义。纯只读操作,不修改任何文件。当用户问"wiki 里有没有讲 X"、"关于 X 我们整理过什么"、"查一下 X 的推导在不在 wiki 里"、"X 的学习路线建好了吗"、"X 还有哪些没覆盖"时触发。也适合在学习新主题前先摸底 wiki 覆盖情况,避免重复建页。
SKILL.md.claude/skills/knowledge-base-query/SKILL.md
GitHubKnowledge Base Query
你负责快速查询 physics-wiki/ 知识库,回答用户关于"wiki 里有什么"的问题。
核心原则
- 纯只读:不创建、修改或删除任何文件
- 准确定位:找到对应的 wiki 页面,而不是自己回答物理问题
- 覆盖报告:明确说哪些已有、哪些缺失、哪些不完整
- 不骗用户:不确定时就说不确定,不编造页面名
查询范围
正式知识库:
physics-wiki/wiki/index.md— 导航入口physics-wiki/wiki/concepts/— 概念页physics-wiki/wiki/derivations/— 推导页physics-wiki/wiki/methods/— 方法页physics-wiki/wiki/problems/— 题目页physics-wiki/wiki/papers/— 论文页physics-wiki/wiki/syntheses/— 综合讲义页
辅助信息来源:
physics-wiki/cache/hot-cache.md— 当前学习活动上下文physics-wiki/wiki/log.md— 近期维护记录physics-wiki/raw/— 原始材料(仅用于判断"是否有未入 wiki 的材料")
通用查询流程
第一步:读索引
先读取 physics-wiki/wiki/index.md,快速确定主题对应哪个目录。
第二步:关键词搜索
- 如果主题明显(如"趋肤效应""电报方程"):直接在
wiki/下找对应页面文件 - 如果主题宽泛(如"传输线""热力学"):先读 index 中的章节结构,再定位相关页面
- 如果主题模糊(如"高频电路损耗"):同时搜索概念、推导、方法三个目录
第三步:读取关键页面
对找到的页面,至少读标题、一句话概括和适用条件,确认页面确实覆盖了用户关心的内容。
第四步:输出报告
输出格式
## 查询报告:<主题>
### 已有覆盖
- 概念页:[[页面名]] — 一句话说明
- 推导页:[[页面名]] — 一句话说明
- 方法页:[[页面名]] — 一句话说明
- 讲义/主线:[[页面名]] — 一句话说明
### 部分相关
- [[页面名]] — 提到了相关内容但不是主题页面
### 未覆盖
- 用户关心的内容点,当前 wiki 没有对应页面
### 如有 raw 材料
- `raw/路径` — 可考虑 ingest 到 wiki
### 建议
- 下一步可以考虑补充什么
特殊查询模式
1. 学习路线查询
## 学习路线:<主题>
- 主线页:有/无
- 已链接节点数:N 个
- 缺失节点:列出
- 知识链闭环:完整/部分/未形成
2. 覆盖完整性查询
## 覆盖检查:<领域>
- 核心概念:已建 N / 缺失 M
- 核心推导:已建 N / 缺失 M
- 核心方法:已建 N / 缺失 M
- 综合讲义:已建/未建
- 学习路线:已建/未建
### 缺失项列表
- 概念缺失:...
- 推导缺失:...
3. 搜索定位查询
用户输入模糊关键词时:
## 搜索:"模糊词汇"
### 精确匹配
- 无/列出
### 近似匹配
- [[页面A]] — 相关度说明
- [[页面B]] — 相关度说明
### 未找到相关内容
- wiki 中暂未覆盖此主题(可建议从 raw 开始或新建页面)
提示
- 名字可能不同:用户说"电磁波",wiki 里可能叫"电磁波"或"电磁辐射"或"电磁场波动解"—从 index/目录名推断,必要时 Grep 搜索
- 不要擅自定义:只汇报 wiki 里有什么,不替代概念讲解
- 区分"已覆盖"和"已触及":页面具体讲了这个概念才算覆盖,只是提了一句不算
- 注意分类边界:同一个物理概念可能在 concepts/ 有定义页,在 derivations/ 有推导页—分开汇报
- 检查目录结构:wiki 概念页有深层目录结构(如 concepts/分析力学/约束系统/),搜索时注意子目录