SuperAPI AI 工具集

qmd-expert

通用与其它

查看项目

更新于 10-16 03:16

技能介绍

用途:qmd-expert 描述 AI 智能体使用 qmd(Quick Markdown Search)CLI 从知识库检索相关上下文的最有效工作流。由于 qmd 在底层对文档分块,普通搜索常返回带 #hash 的具体块而非整份文件,该技能强调保留块指针以免丢失最相关信息。

主要能力与用法:

  1. 了解能力:不确定语法、查询类型(lex、vec、hyde、expand)或可用参数时,运行 qmd skill show 查看内置文档。
  2. 构造查询:混合多种查询类型,如 qmd query "exact search terms"(通用混合搜索,自动扩展)、qmd search "keywords"(严格 BM25 文本搜索,无 LLM,适合精确匹配)、qmd vsearch "natural language question"(向量相似度搜索,适合不确定词汇时)。
  3. 绕过限制并提取块 ID:--files 默认限制 20 条结果,可用 --all 绕过,配合 --min-score 0.7 设定质量阈值,并把原始结果写入文件,不要立即在 shell 中解析,以免丢弃 #hash。
  4. 处理原始结果:--files 输出为逗号分隔的 ChunkID,Score,URI。可用 awk 提取第一列 #hash、排序去重,或按分数降序取前 N 个块,避免上下文窗口过载。
  5. 取回块内容:用 qmd get "$chunk_id" 获取精确片段,输出到 markdown 文件;可用 -l 参数限制返回行数(如 qmd get "#888e5a" -l 20)。
  6. 取回整份文档:从 URI 列提取并去掉行号后缀,再用 qmd get 获取完整文档。

适用场景:需要从大型知识库中为 AI 智能体收集高相关上下文、进行多查询检索并控制上下文窗口时。

限制:资料未提供 qmd 的安装方式、平台支持、收费或性能数据;具体命令行为以 qmd 实际版本为准。