knowledge-base-query

查询 physics-wiki 知识库中某个主题已有哪些内容,快速定位相关页面、推导、方法和讲义。纯只读操作,不修改任何文件。当用户问"wiki 里有没有讲 X"、"关于 X 我们整理过什么"、"查一下 X 的推导在不在 wiki 里"、"X 的学习路线建好了吗"、"X 还有哪些没覆盖"时触发。也适合在学习新主题前先摸底 wiki 覆盖情况,避免重复建页。

SKILL.md

GitHub

Knowledge 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 开始或新建页面)

提示

  1. 名字可能不同:用户说"电磁波",wiki 里可能叫"电磁波"或"电磁辐射"或"电磁场波动解"—从 index/目录名推断,必要时 Grep 搜索
  2. 不要擅自定义:只汇报 wiki 里有什么,不替代概念讲解
  3. 区分"已覆盖"和"已触及":页面具体讲了这个概念才算覆盖,只是提了一句不算
  4. 注意分类边界:同一个物理概念可能在 concepts/ 有定义页,在 derivations/ 有推导页—分开汇报
  5. 检查目录结构:wiki 概念页有深层目录结构(如 concepts/分析力学/约束系统/),搜索时注意子目录