1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | qdrant-advisor | GitHub API / SKILL.md |
| 作者/维护者 | Qdrant（官方 qdrant/skills 仓库，17 位贡献者） |
GitHub API |
| 来源链接 | https://github.com/qdrant/skills/tree/main/meta/qdrant-advisor | — |
| 许可证 | Apache-2.0 | GitHub API |
| GitHub Stars / Forks | 所属仓库 203★ / 23 forks（该数字属整个 Qdrant Agent Skills 合集，不代表本技能个体热度，仅供了解所属仓库规模） | GitHub API |
| 最新版本 | v0.1.0（2026-03-30 发布）；qdrant-advisor 子技能最近一次提交 2026-07-09，仓库整体最近提交 2026-07-17 | GitHub API |
| 安装方式 | npx skills add qdrant/skills/meta/qdrant-advisor 或 Claude Code 插件市场一条命令安装（见第 10 章） |
仓库 README |
2. 功能介绍与亮点
qdrant-advisor 是 Qdrant 官方 Agent Skills 合集的入口诊断技能，定位不是静态文档搬运，而是“按症状而非按功能”组织的解决方案架构师决策树。
核心能力：
- 运行时实时从 skills.qdrant.tech 拉取最新指导内容，而非打包过时的静态文本，保证建议始终对齐 Qdrant 当前版本
- 先用内置搜索定位最相关的顶层技能，再按需深入具体分支：性能优化、扩缩容、搜索质量、监控、部署选型、模型迁移、版本升级、多语言 SDK
- 覆盖 Python、TypeScript、Rust、Go、.NET、Java 六种官方客户端 SDK
- 明确要求内容覆盖不到的情况坦然说明，不回退到模型记忆里的过时知识
亮点：团队实测显示，加载该技能后 Claude Opus 4.6 在 150 项诊断断言中的通过率从 65%（97/150）提升到 96%（144/150）；仓库由 17 位贡献者共同维护，Qdrant 官方组织出品。
3. 适用场景
所属分类：工程效率与代码质量。适合用 Claude Code / Codex 等 agent 构建基于 Qdrant 的向量检索、RAG 应用的开发者，在遇到搜索质量下降、内存/OOM、索引变慢、扩容选型、模型迁移、版本升级等工程问题时，用它获取诊断优先级排序与具体处置步骤。
4. 跨 Agent 兼容性
- Claude Code：原生支持——官方提供
npx skills add与/plugin marketplace add qdrant/skills两种一条命令安装路径 - Codex：原生支持——官方发布博客明确列出 OpenAI Codex 为受支持平台之一
- OpenClaw：原生支持——官方发布博客同样列出 OpenClaw
- Hermes Agent：未验证——官方支持列表与已抓取材料均未提及
5. 推荐理由
它是尚未被收录、由官方向量数据库厂商维护、且有实测数据支撑效果的诊断类技能：加载后显著提升 agent 处理 Qdrant 工程问题的准确率，且因内容动态拉取而不会像静态技能那样过时。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | Qdrant 官方仓库出品，向量数据库赛道认知度高；技能仓库 203★、17 位贡献者，在同类向量数据库/数据基础设施官方技能包中处于中上规模 |
| 可用性 | 9 | 一条命令安装；SKILL.md 结构清晰、覆盖面完整；子技能 9 天前、仓库整体 1 天前均有提交，维护活跃；Apache-2.0，无付费依赖 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单： ① 执行 shell 命令——不涉及，纯指令性文本，不含可执行脚本 ② 联网外发数据——运行时会单向 GET 拉取 skills.qdrant.tech 官方文档内容，不涉及用户代码或数据被发送出去 ③ API key/凭据——不需要，advisor 仅做诊断建议，不连接用户自己的 Qdrant 实例 ④ 可疑指令——抓取 SKILL.md 原文与仓库结构，未见 prompt injection 或混淆代码迹象 ⑤ 作者信誉——Qdrant 官方组织出品，17 位具名贡献者 ⑥ License——Apache-2.0，明确 ⑦ 维护时间——最近提交在 9 天内，活跃
综合评分：8.7（三项均值）
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 qdrant-advisor 的差异 |
|---|---|---|
| Weaviate Agent Skills（weaviate/agent-skills） | 另一款向量数据库官方技能包，面向 Weaviate 应用开发者 | 按功能而非按症状组织内容，未见诊断决策树设计；仓库已一个多月未更新 |
| Pinecone 官方 Agent Skills（pinecone-io/skills） | 覆盖 Cursor、GitHub Copilot、Gemini CLI 等多种 IDE 的官方技能库 | 仓库处于早期阶段，内容体量和覆盖广度都还有限 |
| Snowflake Cortex Code 子代理（Snowflake-Labs/subagent-cortex-code） | 面向企业数据仓库场景的路由子代理 | 需要额外安装 Cortex Code CLI 作为中转层，安装路径比 qdrant-advisor 的一条命令更复杂 |
qdrant-advisor 的差异化在于“实时性 + 诊断式组织”：内容不是打包进仓库的静态快照，而是运行时向官方文档源实时取数，且按“症状 → 可能原因 → 处置步骤”的诊断树组织，不是简单的功能罗列。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
该技能包由 Qdrant 团队 8 位工程师主导发布，仓库同时提供免安装模式——在 prompt 中加入“Use skills.qdrant.tech”即可直接引用远程技能内容，无需本地安装。
10. 安装使用方式
- npx（推荐，仅装入口技能）：
npx skills add qdrant/skills/meta/qdrant-advisor - npx（完整安装，含全部 9 个专项技能）：
npx skills add qdrant/skills - Claude Code 插件市场：
/plugin marketplace add qdrant/skills - 免安装模式：在 prompt 中添加“Use skills.qdrant.tech”直接引用远程内容
- 注意事项：advisor 设计为运行时动态拉取内容而非静态打包，使用时需要网络能访问 skills.qdrant.tech；安装后无需重启，下次对话涉及 Qdrant 问题时会自动触发
11. 注意事项
- 当前为 2026-03-30 发布的 v0.1.0 早期版本，作者在文档中声明内容和结构可能在版本间变化
- 仅覆盖 Qdrant 本身的工程决策，不涉及 LangChain/LlamaIndex 等上层 AI 框架的集成细节，需另行使用对应框架的技能
- 依赖网络连接实时拉取指导内容，离线环境下功能会受限
- Hermes Agent 上的兼容性未经验证