相关性导航检索
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_84aa03cf/chenlin-relevance-first-search。
技能介绍
问题从哪来
语义检索会给你一份 top-k,但关键句可能被截断,多跳问题一次排名也兜不住;直接 grep 全库虽然精确,扫描顺序与相关性无关——你可能先翻完几十个无关文件才撞上目标。常见痛点不是「完全检不到」,而是排序只当了内容筛选器,没有在执行阶段继续当导航器。
三层协议怎么跑
本技能把「谁更相关」翻译成「先扫谁、先读哪几段」。
- L1(文档级):在限定扩展名/子目录后,用 BM25 对候选路径打分,输出有序
scope,并按清单顺序扫描;按序扫描时必须给 ripgrep 加-j1,否则多线程输出会打乱顺序且不可复现。 - L2(入口点):从排名靠前的文件抽出 2~3 段高相关原文当「开门砖」,拿术语、人名、配置键等线索,再精确定位——有时 L2 本身已经给出答案。
- L3(匹配级):先收大批量行级匹配,再用「全局意图 + 本次关键词」拼接查询对行重排,让藏在低排名文件里的好句子浮上来;收敛型任务适合全开,覆盖型任务应关掉 L3 以免伤召回。
停止条件写得很硬:证据逐条核验、连续两轮无新证据就换策略、工具调用接近预算就汇报已知/未知;证据够不够、收不收工由人拍板,脚本与排序可自动重跑验证。
边界与注意点
BM25 不是嵌入模型,同义改写和跨表述容易失手,可依赖 L2 先读原文措辞;语料极大且查询很宽时,-j1 会牺牲扫描速度;候选少于约 20 个文件时排序开销不值当;含密钥或私信的目录慎把 --root 指过去,因为 L2 会把原文片段打进对话上下文。方法面向本地可枚举语料,不适用于无法控制完整候选集的联网搜索。
使用场景
- 在几百个 Markdown 技能说明里定位「平台评测分数波动多少算噪声」的唯一表述
- 排查报错时要在多仓库配置与文档中按相关性顺序扫,而不是无序 grep
- 写综述前需要「找全所有涉及某术语」的段落,因而只用 L1+L2、关闭 L3
- Agent 对话里本地检索已超二十次仍无新证据,需要按停止条件换关键词并汇报未知
适合人员
- 维护上百份内部 Markdown/SKILL 文档、常被「文件在哪一段」拖住的知识库编辑
- 在多子目录代码仓里查配置键与报错出处、厌倦先扫无关文件的后端工程师
- 用 Cursor/自建 Agent 做本地 RAG、希望把「排序」延续到翻阅顺序的集成者
- 需要可重跑 benchmark(build_cases + bench_navigation)验证自己语料收益的数据/平台同学