SuperAPI AI 工具集

ask

通用与其它

查看项目

更新于 10-15 23:47

技能介绍

用途:ask 用于从个人或项目知识库(vault)中快速检索答案,覆盖决策历史、阻塞状态、文档查找和项目状态查询。

主要能力:优先调用 QMD 混合搜索(BM25 + 向量 + 重排)进行深度检索;当 QMD 不可用或未建立索引时,自动回退到 vault grep。回答会附带来源文件路径与相关性说明,并标注所用搜索模式。

使用方式:以 /ask 加问题作为输入。技能先检测 QMD MCP 工具是否可用(qmd_status),再解析问题类型与项目,然后选择 QMD 模式或回退模式。QMD 模式调用 qmd_deep_search,按配置的 collection_name(默认 pm-kit)、max_results(默认 8)、min_score(默认 0.35)取结果,再用 qmd_get 或 qmd_multi_get 获取正文并综合回答。回退模式按问题类型定位目录:决策查 decisions/{project}/.md,阻塞查 blockers/{project}/.md,文档查 docs/{project}/.md 与 docs/general/.md,状态查 01-index/{project}.md,通用则搜索全部文件夹;检索顺序为文件名匹配、frontmatter 字段匹配、内容 grep。

适用场景:需要快速回顾团队或项目历史决策、查看谁被阻塞、定位某份文档、查询项目状态时。

限制:QMD 未安装或索引为空时只能使用较慢的 grep 回退,语义理解能力有限;无结果时会建议换用更宽泛的关键词、检查拼写,或在已安装 QMD 但未索引时运行 qmd embed。配置项位于 _core/config.yaml。