前言¶
在 MongoDB 里落地业务，常见卡点不在「能不能连上库」，而在文档怎么拆、索引怎么配、复杂统计用聚合怎么写。嵌入和引用各走一路，改起来成本高；索引漏了或多了，线上表现和存储都会受影响。单靠通用对话，Agent 往往只能给出零散建议，缺少一套可重复的设计节奏。
下面介绍 SkillHub 上的 MongoDB 设计与使用助手（坐标 @user_3651d062/mongodb-design，当前版本 1.0.2）。它面向 Agent 工作流，把文档模型、索引、聚合管道和场景化用法收进同一套 Skill 说明里，在你要做 Schema、选型或聚合设计时由 Agent 按触发条件拉起。
这是什么¶
MongoDB 设计与使用助手 是社区来源（community）的 Agent Skill，发布者为 user_3651d062，分类为 dev-programming。官方简介写明：帮助 Agent 为项目进行 MongoDB 文档模型设计、索引设计、聚合管道设计，并提供场景化使用指南；当用户需要设计 MongoDB Schema、选择嵌入 vs 引用、设计聚合查询时触发。
Skill 标签标明 requires_api_key=false，不依赖额外 API Key。在 SkillHub 页面可见评分 100000、下载 743 次（数据以 SkillHub 展示为准）。
- SkillHub 页面：https://www.skillhub.cn/skills/user_3651d062/mongodb-design
- API 入口（资料中的官方地址）：https://api.skillhub.cn/user_3651d062/mongodb-design
核心功能¶
以下能力均来自官方简介与 Skill 定位，不展开未在资料中出现的实现细节。
-
文档模型（Schema）设计
协助 Agent 根据业务描述整理集合与字段结构，并讨论文档形状是否贴合读写路径。 -
嵌入 vs 引用
在「单文档内嵌」与「跨集合引用」之间做场景化取舍，对应官方列出的典型触发场景之一。 -
索引设计
围绕查询模式讨论索引字段、顺序与类型方向（具体语句由 Agent 结合 Skill 指引生成，需你在环境中自行校验）。 -
聚合管道设计
面向统计、分组、关联类需求，引导 Agent 组织$match、$group、$lookup等阶段（以 Skill 内指南为准）。 -
场景化使用指南
把上述设计点落到「什么情况下怎么用」的说明上，减少 Agent 只给概念、不给落地步骤的情况。
安装与启用¶
SkillHub 页面给出的安装方式是：让 Agent 依照官方安装文档，安装坐标包 @user_3651d062/mongodb-design。完整流程以对 https://skillhub.cn/install/skillhub.md 的说明为准。
1、确认或安装 SkillHub CLI¶
先检查本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill 到当前 Agent 的 skills 目录¶
安装文档强调：必须用 --dir 指向当前 Agent 实际使用的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。
skillhub install @user_3651d062/mongodb-design --dir <skills 目录>
常用客户端路径（摘自安装文档，按你实际环境选用其一）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将下面提示词发给支持 Skill 的 AI，由它按安装文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_3651d062/mongodb-design`。
安装后若 Agent 未立刻识别新 Skill，需按你所用客户端的惯例重启或刷新技能目录（安装文档对「需重启」有说明）。
典型用法¶
官方未提供独立代码仓库示例；可复现的入口是 触发条件 + 自然语言任务描述。
- 确认 Skill 已装入当前 Agent 的 skills 目录。
- 在对话中直接提出与官方触发语一致的需求，例如：
- 「为这个订单系统设计 MongoDB Schema，说明嵌入和引用怎么选。」
- 「根据这些查询条件，帮我设计索引。」
- 「用聚合管道做按月销售额统计，请给出阶段划分。」 - Agent 在匹配到 Schema / 嵌入 vs 引用 / 聚合设计等场景时，应加载本 Skill 的指引再回答。
经过上面的步骤，你得到的是设计稿与查询/索引/管道建议，仍需在目标 MongoDB 版本与数据量下自行验证执行计划与性能。
适用场景与注意¶
适合谁
- 已在或计划使用 MongoDB，希望 Agent 按统一套路做模型与查询设计，而不是每次从零讲概念。
- 需要在对话里反复权衡嵌入与引用、或整理聚合阶段的开发者。
限制与注意
- 资料未声明绑定特定 MongoDB 云服务；设计结论需与你使用的 MongoDB 版本、事务与分片策略对照。
- Skill 输出是设计辅助，不能替代压测、慢查询分析与生产变更评审。
- 安装、搜索等操作依赖 SkillHub CLI 与网络；沙箱或限网环境需按安装文档处理权限。
- 评分与下载量随 SkillHub 页面更新，引用数据时以页面为准。
结尾¶
MongoDB 设计与使用助手 把文档模型、索引、聚合与场景说明收敛到一套 Agent Skill 里，适合在 Schema 与查询设计阶段接入对话工作流。需要查看版本与安装入口时，请打开 SkillHub 页面：https://www.skillhub.cn/skills/user_3651d062/mongodb-design 。
