lkhfrgc/scholar-llm-wiki / .dsh/skills/query
query
Verified在本地 LLM Wiki 知识库中检索并回答问题。支持 `/query <问题>`。先读 index.md 定位,再深度阅读相关页面,综合出带 [[双链]] 引用的答案;若回答产生新洞见,主动提议保存为 synthesis / connection / question 页面。当用户说「wiki 里有没有关于 X 的内容」「帮我查一下 Y」「我的笔记里关于 Z 是怎么说的」时触发。禁止凭模型记忆回答。
query 技能
前置:初始化
若 .dsh/wiki.config.json 或根目录的 index.md 不存在,说明骨架尚未生成,先跑一次 python .dsh/scripts/setup_wiki.py。知识库还没建立时没有可检索的内容,此时如实告知用户并建议先摄入资料。
路径以配置为准
.dsh/wiki.config.json 是本仓唯一配置源,目录名与文件名都从它读,不写死绝对路径:
python .dsh/scripts/wiki_env.py --paths # 常用目录一览
下文出现的
wiki/papers/、wiki/concepts/、index.md、log.md等均为默认值;若wiki.config.json改过,以配置为准,拿不准先跑上面的自省命令。
核心目标
将用户的提问转化为对本地 Wiki 的深度检索。从 wiki/ 下的 papers、concepts、connections、questions、syntheses 中提取相关信息,综合出带有明确 [[双链]] 引用的回答。当回答产生新洞见时,主动将其固化为知识库的一部分。
触发场景
- 用户输入
/query <问题> - 用户用自然语言询问知识库内容,如"wiki 里有没有关于 X 的资料"、"帮我查一下 Y 概念"、"Z 和 W 之间有什么关系"、"有哪些论文讨论了 Q"
- 用户提及 wiki、知识库、论文、概念、连接等关键词且需要检索答案时
降级策略
如果问题属于纯通用知识(如"今天天气怎么样"),且通过步骤 1 确认 wiki/ 中无相关内容:
本地知识库中未找到相关内容,以下为通用知识回答:
然后直接基于通用知识回答。此情况下不记录 log.md(因为未使用知识库)。
如果问题与工作区关注的主题相关但 wiki 中确实没有覆盖,如实告知并建议用户摄入相关资料。
检索与综合流水线
步骤 1:查阅全局索引 + 关键词搜索
永远的第一步:读取 index.md。
在 index.md 中定位与问题相关的页面。index.md 的分类结构如下(与 AGENTS.md 一致):
- Papers — 论文讲解页面(一篇论文一个文件)
- Concepts — 概念定义
- Connections — 跨概念连接
- Questions — 开放研究问题
- Syntheses — 综合论述
补充搜索:如果 index.md 中的条目名称不足以判断相关性,用 grep 在 wiki/ 下按关键词搜索,确保不遗漏。
grep({ pattern: "<正则>", path: "wiki", include: "*.md" })— 按内容检索glob({ pattern: "wiki/**/*.md" })— 按文件名检索
⚠️ 本技能运行在当前宿主的工具集上(DSH:grep / glob / read)。不要把工具名写成 search_content、search_files 之类——那些名字在本宿主不存在,会导致检索步骤直接失败,进而退化成"凭记忆回答",而这是本技能明令禁止的。
步骤 2:深度阅读目标页面
选取步骤 1 中找到的最相关页面(通常 2-5 个),完整读取其内容。阅读优先级:
- 直接命中关键词的 concept 页面 — 概念定义最精炼,是理解的锚点
- 相关的 paper 页面 — 有具体方法、结果和数据
- 相关的 connection 页面 — 揭示跨概念关系
- 相关的 synthesis 页面 — 已有综合论述,避免重复劳动
步骤 3:综合与回答
综合所有已读页面的信息,用清晰的逻辑组织答案。
双链引用规范:
- 引用某个 Wiki 页面的信息时,在文中使用
[[页面名称]]标注 - 若整段内容来自同一页面,在段首或段尾引用一次即可
- 若引用特定原文,使用块引用:
> 原文内容 - 答案末尾列出"参考页面"汇总:
**参考页面**:[[page-a]]、[[page-b]]、[[page-c]]
矛盾处理:如果不同页面对同一问题给出了相互矛盾的说法,不要掩盖——在回答中明确指出矛盾所在,引用双方来源,并建议用户检查相关页面的 ## 知识冲突 区块。
步骤 4:新洞见固化
如果本次回答满足以下任一条件,主动询问用户是否保存:
| 条件 | 保存类型 | 目录(默认值) |
|---|---|---|
| 综合了 2 个以上页面的信息,形成新的分析或对比 | synthesis | wiki/syntheses/ |
| 揭示了已有概念之间尚未被记录的连接 | connection | wiki/connections/ |
| 识别出一个值得追踪的开放问题 | question | wiki/questions/ |
询问话术:
这次回答综合了 [[page-a]] 和 [[page-b]] 的内容,形成了一个新的 [综合分析 / 概念连接 / 开放问题]。是否需要我将其保存到对应目录?
用户同意后,按 AGENTS.md 规范创建页面:
Synthesis 页面模板:
---
title: "综合论述标题"
type: synthesis
created: YYYY-MM-DD
updated: YYYY-MM-DD
sources: ["wiki/page-a.md", "wiki/page-b.md"]
tags: []
---
## 问题
[本次回答试图解决什么问题?]
## 综合论述
[综合后的完整论述。]
## 关联连接
- [[相关概念]]
- [[相关论文]]
命名规则:synthesis-简短描述.md
Connection 和 Question 页面的模板参见 ingest/SKILL.md 中的对应模板(注意 question 页面必须带 updated / sources / ## 关联连接 三件套)。
创建后同步更新 index.md 的对应分类。
步骤 5:记录操作日志
查询结束后,在 log.md 顶部追加(只能追加,不可覆盖已有内容;操作类型只允许 ingest / query / lint;新条目必须独占一行并以空行结尾,追加后回读确认没有和旧内容粘连):
## [YYYY-MM-DD] query | <问题简述>
- **输出**: <已保存至 [[新页面]];或"即时回答未保存">
- **参考**: [[page-a]], [[page-b]], [[page-c]]
格式遵循 AGENTS.md 中的示例。如果是降级回答(未使用知识库),不记录 log。
强制约束
- 禁止凭记忆回答:必须先检索
wiki/,以知识库内容为唯一依据 - 禁止过度引用:同一页面在同一段落中引用一次即可
- 禁止静默回答:知识库无相关内容时必须声明"本地知识库中未找到相关内容"
- 禁止掩盖矛盾:如发现不同来源的说法冲突,必须在回答中明确指出
- 使用简体中文回答,专有名词可保留英文
- 回答面向具有扎实数学/计算机背景的读者,不要降格简化
- 中英文混用没问题 — 用对概念最清晰的表达方式
关联连接
- [[index]] — 全局索引入口
- [[log]] — 操作日志
- [[AGENTS.md]] — Wiki 架构总规范
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |