1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | mongodb-query-optimizer-mongodb-agent-skills（SKILL.md 自述名称：“mongodb-query-optimizer”） | GitHub 仓库 + SKILL.md |
| 作者/维护者 | MongoDB, Inc.（官方，NASDAQ: MDB） | GitHub API（组织账号 mongodb） |
| 来源链接 | https://github.com/mongodb/agent-skills/tree/main/skills/mongodb-query-optimizer | — |
| 许可证 | Apache-2.0 | GitHub API 实测 |
| GitHub Stars / Forks | 165 / 30（整仓库口径——本技能所在的 mongodb/agent-skills 是 MongoDB 官方发布的多技能合集，非本技能独立仓库，星数不代表单个技能热度；该技能自身在 skills.sh 上有 3,624 次独立安装记录，见第 6 章） |
GitHub API 实测（2026-08-04）；skills.sh 实测 |
| 最新版本 | SKILL.md metadata 版本号 1.0.0 | SKILL.md 实测 |
| 安装方式 | Claude Code：/plugin install mongodb-atlas；Codex：官方插件浏览器 /plugins 安装；通用：npx skills add mongodb/agent-skills |
官方 README 实测 |
2. 功能介绍与亮点
MongoDB 官方技能，把“这条查询为什么慢、该怎么修”这套原本依赖专家经验的诊断流程系统化为可复用工作流：
- 分级诊断工作流：先用
collection-indexes核对现有索引，再用explain跑执行计划（先queryPlanner看是否全表扫描，命中索引或集合很小再补executionStats拿扫描/返回文档比），最后用find取样本文档辅助判断字段类型 - 两级优雅降级：有 MongoDB MCP 连接串时走完整诊断流程；进一步配置 Atlas API 后可调用 Performance Advisor 拉取慢查询日志与索引建议；两者都没有时仍能仅凭查询结构给出通用索引建议，而不是直接拒绝服务
- ESR 复合索引规则：建议复合索引时遵循 Equality→Sort→Range 顺序，并给出可直接执行的
createIndex语句与推理依据 - 真实反模式库：
antipattern-examples.md用可运行的 bad/good 代码对照，收录$exists应改稀疏索引、未锚定$regex无法走索引范围扫描、$where服务端 JS 应改用$expr原生聚合表达式等具体案例，并解释每条背后的索引原理 - 谨慎表达：明确要求不用“你应该建这些索引、必然提升性能”式绝对化语言，只给出建议与依据；只有 Performance Advisor 明确给出建议时才提删除索引，不擅自替用户做主
3. 适用场景
所属分类：工程效率与代码质量（诊断慢查询、给出索引修复方案，本质是对已有查询的调试与性能调优，而非数据洞察或可视化产出）。面向已经在用 MongoDB 的初中级开发者与团队：某条查询变慢想知道原因、想为集合主动规划索引、或想例行排查集群上的慢查询时使用；未配置 MongoDB MCP/Atlas API 时仍可退化使用，只是建议精度会降低。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方 Claude 插件市场一条命令 /plugin install mongodb-atlas 接入 |
| Codex | 原生支持 | 官方 README 明确列出 mongodb-atlas 插件“available on Claude, Cursor, Codex, GitHub Copilot (CLI and VS Code), and Grok”，并给出 Codex 插件浏览器 /plugins 安装步骤 |
| OpenClaw | 未验证 | 已抓取材料未提及 |
| Hermes Agent | 未验证 | 已抓取材料未提及 |
5. 推荐理由
MongoDB 官方出品，把“为什么慢、怎么修”这套原本要靠专家经验判断的诊断流程，系统化为核对索引→执行计划→复合索引建议的三步工作流，并把真实场景踩过的索引反模式提炼成可直接对照的代码示例，让初中级开发者也能看懂问题出在哪、该怎么解。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | MongoDB 官方出品（一线数据库厂商）；技能自身在 skills.sh 安装目录有 3,624 次独立安装记录，高于同合集内多个兄弟技能；另有独立作者（数据库公司解决方案架构师）在 Medium 测评文章中将其列入打包安装清单，第三方认知度可查证 |
| 可用性 | 9 | 官方插件市场一条命令安装，覆盖 Claude/Cursor/Codex/Copilot/VS Code/Grok；SKILL.md 与四份专项参考文档（核心索引原则、反模式示例、聚合优化、更新查询示例）内容详尽且按场景条件加载；无 MCP/Atlas 配置时仍有可用的降级路径；仓库近日仍有推送，维护活跃 |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 8.3 | 三项均值（7+9+9）/3 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 不直接执行 shell 命令，全部动作通过 MongoDB MCP Server 提供的受限工具（collection-indexes、explain、find、atlas-get-performance-advisor 等）完成，绝大多数为只读操作；明确要求“未经用户批准不得直接通过 MCP 创建索引” |
| ② 运行时联网外发 | 仅通过用户自行配置的 MongoDB MCP Server 连接用户自己的 MongoDB/Atlas 实例，无其他联网行为 |
| ③ API Key/凭据 | 托管版走浏览器 OAuth 登录，技能本身不接触也不存储凭据；自管版由官方 MCP Server 统一管理连接字符串 |
| ④ 可疑指令排查 | SKILL.md 与四份参考文档全文均为索引诊断与优化指导，未发现 prompt injection 或隐藏指令 |
| ⑤ 作者/组织信誉 | MongoDB, Inc.——NASDAQ 上市数据库公司，官方 GitHub 组织账号发布 |
| ⑥ License | Apache-2.0，清晰、完全开源可审计 |
| ⑦ 最近维护 | 所属仓库最后推送 2026-08-02；本技能自身最近一次功能性提交为 2026-05-20 的元数据整理 |
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| mongodb-schema-design-mongodb-agent-skills（同合集，MongoDB 官方） | 系统化指导 Schema 设计，规避常见性能反模式 | 定位是设计期决策（建表/建模阶段规避问题）；本技能定位是运行期诊断（已有查询变慢后定位原因并给索引修复方案） |
| postgres-timescale-pg-aiguide（Timescale 官方） | 用参考文档补齐 Agent 写 Postgres 代码时的表设计与索引策略知识盲区 | 是静态参考文档型技能，不连接真实数据库；本技能通过 MCP 实时读取用户集合的真实索引与执行计划，诊断基于该用户集群的实际数据 |
| qdrant-performance-optimization-qdrant-skills（Qdrant 官方） | 从搜索速度/索引/内存三方向诊断向量检索集群性能问题 | 服务对象是运维 Qdrant 向量检索集群的工程师；本技能服务对象是排查 MongoDB 文档查询变慢的应用开发者，问题域（向量检索 vs. 文档查询）不同 |
核心差异化：同类官方数据库性能技能里，有的聚焦设计期（schema-design），有的是不连接真实环境的静态参考文档（postgres-timescale）；本技能的差异点在于通过 MCP 直接读取用户集群的真实索引与执行计划做运行期诊断，且明确提供“无 MCP/Atlas 配置也能退化使用”的兜底路径。
8. 用户评价
一位数据库行业解决方案架构师在 Medium 发表的 MongoDB 技能测评文章中，将本技能列入其打包安装的官方技能清单，但该文重点展开测评的是同合集的检索类技能，未对本技能做具体点评。目前未查到独立于该合集打包清单之外、专门针对本技能的第三方评价。
9. 其他补充
同一官方合集还包含连接配置、Schema 设计、自然语言查询、全文/向量检索、MCP 接入向导等技能，共同覆盖 MongoDB 应用开发全生命周期，可按需搭配安装。
10. 安装使用方式
Claude Code（托管 Atlas，推荐）：
/plugin install mongodb-atlas安装后按提示完成浏览器 OAuth 登录，运行 /reload-plugins 激活。
自管部署（MongoDB Community / Enterprise Advanced / 自托管）：
/plugin install mongodb该插件在本地通过 npx 启动 MongoDB MCP Server，连接到用户自行指定的连接字符串。
Codex： 打开插件浏览器 /plugins，搜索并安装 mongodb-atlas。
通用（跨编码助手）：
npx skills add mongodb/agent-skills手动安装： 克隆仓库后将 skills/mongodb-query-optimizer/ 目录（含 SKILL.md 与 references/ 参考文档）复制到所用编码助手读取 skills 的位置。
无论哪种方式，都需另外配置 MongoDB MCP Server（npx "mongodb-mcp-server@latest" setup）才能获得完整诊断能力；未配置连接时技能仍可运行，但只能给出不核对真实索引/执行计划的通用索引建议。
11. 注意事项
- 仓库星数为整个官方技能合集口径，非本技能独立仓库数据；技能自身热度以 skills.sh 3,624 次安装量为准
- 完整诊断能力（读取真实索引、执行计划、慢查询日志）依赖 MongoDB MCP Server，进一步的性能顾问建议还需额外配置 Atlas API；两者都未配置时仅能给出基于查询结构的通用建议
- 技能本身默认不会未经用户同意直接创建或删除索引
- OpenClaw、Hermes Agent 支持情况未获验证