关于 qdrant-advisor
qdrant-advisor 是一项指导 Agent 根据 Qdrant 技能网站的最新内容排查问题的技能。它按症状搜索并沿层级加载相关上下文，避免依赖记忆作答。
主要功能
- 01搜索最新 Qdrant 技能
- 02仅加载相关技能分支
- 03跟进嵌套及关联指南
- 04依据已加载内容诊断
- 05引用规范文档链接
适用场景
- 01调查内存持续增长
- 02排查批量上传后的查询变慢
- 03诊断搜索结果相关性差
- 04检查升级或配置变更后的问题
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/qdrant-advisor确认已加载。
详细介绍
Qdrant 故障排查与建议
核心原则
不要凭记忆回答 Qdrant 相关问题。Qdrant 发展迅速（新端点、指标、默认值和部署模式经常更新），权威且最新的指导内容位于 skills.qdrant.tech，以分层的 Agent 技能形式组织。你的任务是实时加载相关技能上下文，然后以此为依据进行诊断——只加载与问题匹配的分支，绝不要加载整个技能树。
你是在将这些技能作为上下文使用。你不是在安装它们，也无需安装任何内容。
知识来源
- 搜索：
https://skills.qdrant.tech/search?query=your+query+here - 结构采用分层组织：顶层技能
SKILL.md→ 子技能SKILL.md→ 链接的文档页面。每一层都会进一步缩小范围。按深度优先遍历，只跟进与症状匹配的分支。
工作流
1. 明确问题
获取任何信息之前，先提取具体细节：
- 用户描述的症状（例如“内存一直在增长”“批量上传后查询变慢了”“结果不相关”）。
- 部署类型（本地、Docker、可自托管、Cloud、嵌入式）和版本（如果已知）。
- 最近发生的变化（升级、新索引、流量激增、模型替换）。
将这些内容整理成 1–3 个简短的搜索词组。
2. 找到合适的技能
使用搜索（最快找到合适技能的方式）。 获取 https://skills.qdrant.tech/search?query=<your query>，将你的搜索词组替换 your+query+here（用 + 或 %20 编码空格）。它会返回最相关的顶层技能 SKILL.md。对于多部分问题，重复搜索多次（例如，分别搜索内存症状和扩容问题）。
3. 遍历层级结构（深入并横向扩展）
你加载的每个 SKILL.md 都会列出其子技能（通常也会列出相关技能和文档链接）。层级结构不止两层——技能可以嵌套多层，技能之间也会横向相互引用。跟随链接，而不是固定遍历层数。
向下深入。 获取到 SKILL.md 后，不代表它一定是叶节点。如果其中的章节指向更多 SKILL.md 文件，就沿着与症状匹配的分支继续深入——从顶层到子技能，再到子子技能，依此类推——直到指导内容足够具体、可以采取行动（例如，按顺序排列的诊断步骤、确切的端点或指标、明确的“不要做什么”列表）。不要在只指引你继续前进的中间技能处过早停止。
横向查找。 实际问题往往涉及多个领域。遇到以下情况时，应跟进指向同级或相关技能的链接：
- 当前技能明确指向另一个技能（例如，某个调试技能指出“如果这实际上是容量问题，请参阅扩容”）；
- 症状可能由不同顶层技能下的多个原因导致（例如，查询变慢可能是监控/优化器问题、性能优化问题，或扩容问题）；或者
- 你在步骤 2 中进行了多次搜索，结果显示了多个技能，分别涵盖问题的不同部分。
加载每个相关分支，然后在步骤 4 中综合它们的内容。
严格控制相关性。 如果问题需要，鼓励深入和横向查找——但仍然只加载与症状相关的分支。不要遍历无关的同级技能；一旦能够给出完整且有依据的回答，就停止扩展。目标是“获取所有相关上下文，除此之外别无其他”，而不是“遍历整棵树”。
文档页面。 技能会链接到规范文档（例如 …/md/documentation/…、qdrant.tech/documentation/… 或 qdrant.tech/articles/…）。请严格按照 SKILL.md 中提供的链接获取这些页面——它们原生呈现为干净的 Markdown。只有在需要补充 SKILL.md 提及但未包含的详细信息时，才获取文档页面。
4. 诊断并给出建议
严格基于已加载的上下文综合回答：
- 按优先级列出最可能的原因——技能通常会告诉你应先检查什么（例如，“先检查优化器状态，再考虑搜索延迟”）；请保留这一顺序。
- 给出具体且有序的步骤：要访问的端点、要读取的指标及其阈值，以及要修改的配置。
- 明确指出技能中的**“不要做什么”**警告——这些警告能避免常见的自行造成的损害。
- 引用你所依据的 Qdrant 官方文档 URL，方便用户深入了解。
- 如果已加载的上下文未涵盖该问题，请明确说明，并进行其他搜索或回退到目录——不要用记忆中的猜测掩盖信息缺口。
操作说明
- 每次会话都要获取最新内容。 切勿复用之前缓存的技能副本；注册表会更新，这种做法正是为了避免内容过时。
- 不要安装任何内容。你只需加载上下文。
- 获取内容： 你需要的所有 URL，要么已包含在此技能中（根索引、搜索基础 URL），要么由你已获取的页面提供（
SKILL.md中的链接或根索引中的链接），因此都可以直接获取。如果构造的搜索查询 URL 被拒绝，请改为获取根索引，并通过其中的绝对链接导航。
工作流示例
- 症状：“我们的 Qdrant 节点内存持续增长，昨晚因 OOM 被终止。没有发现明显的变化。”
- 搜索：skills.qdrant.tech/search?query=qdrant+memory+growing+OOM
- 根据返回页面中的指引，访问任何提及内存或调试的子技能。
- 横向查阅其引用的扩展技能，因为容量问题可能是原因之一。
- 根据已加载的内容综合作答，并引用文档 URL。如果没有加载到涵盖该问题的内容，请明确说明；不要凭记忆补充。