1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | mongodb-schema-design-mongodb-agent-skills（README/SKILL.md 自述名称：“MongoDB Schema Design”） | GitHub 仓库 + SKILL.md |
| 作者/维护者 | MongoDB, Inc.（官方，NASDAQ: MDB） | GitHub API（组织账号 mongodb） |
| 来源链接 | https://github.com/mongodb/agent-skills/tree/main/skills/mongodb-schema-design | — |
| 许可证 | Apache-2.0 | GitHub API 实测 |
| GitHub Stars / Forks | 158 / 28（整仓库口径——本技能所在的 mongodb/agent-skills 是 MongoDB 官方发布的多技能合集，非本技能独立仓库，星数不代表单个技能热度） |
GitHub API 实测（2026-07-16） |
| 最新版本 | 本技能 SKILL.md 内部版本号 1.0.0 | SKILL.md metadata 字段实测 |
| 安装方式 | Claude Code：/plugin install mongodb；Codex：codex plugin marketplace add mongodb/agent-skills；通用：npx skills add mongodb/agent-skills，或克隆仓库后手动复制 skills/ 目录 |
官方 README 实测 |
2. 功能介绍与亮点
MongoDB 官方技能，教编码助手按文档模型思维设计/审查数据模型，而非照搬关系型范式化习惯：
- 反模式检测：识别拆分集合过细、过度
$lookup、冗余索引等常见反模式并给出修复方案 - 设计模式库：bucket（时间序列分桶）、polymorphic 等 11 种验证过的建模模式，均附错误/正确示例
- 访问模式驱动：先引导用户结合真实读写负载定位问题，再给建议，而非直接下结论
- 可选 MCP 联动：可接官方 MCP Server 自动读取真实 schema 验证，默认只读
3. 适用场景
所属分类：工程效率与代码质量。适合用 MongoDB 开发、对文档建模不熟悉的初中级开发者：新建 schema、SQL 迁移、审查集合性能，或踩到 16MB 限制、索引冗余等坑时使用。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方插件市场一条命令 /plugin install mongodb 接入 |
| Codex | 原生支持 | README 提供 codex plugin marketplace add mongodb/agent-skills 官方安装步骤 |
| OpenClaw | 未验证 | 官方仅列出 Claude/Cursor/Codex/Gemini/Copilot CLI；SKILL.md 遵循开放 Agent Skills 标准格式，理论上可手动复制 skills/ 目录接入，但未查到官方专项说明 |
| Hermes Agent | 未验证 | 同上，已抓取材料未提及 |
5. 推荐理由
MongoDB 官方出品，把建模哲学系统化为可复用的反模式/模式参考库，一条命令即可让编码助手按官方最佳实践审查或设计 schema，避免常见性能反模式。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | MongoDB 官方出品（一线数据库厂商）；公开渠道目前仅见官方自家博客公告与一段第三方评测视频，尚无多平台独立讨论；仓库星数 158（合集整体口径） |
| 可用性 | 9 | Claude Code 一条命令安装；SKILL.md + 19 篇分类参考文档，示例完整；本技能目录最近一次提交在 2026-07-01，整仓库 2026-07-15 仍有推送，维护活跃；核心指导内容免费，仅可选的实时诊断功能（Query Stats/慢查询日志）需要 Atlas M10+ 付费层 |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 8.3 | 三项均值（7+9+9）/3 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 技能目录本身只含 SKILL.md 与 19 篇纯 Markdown 参考文档，不含任何脚本或可执行代码 |
| ② 运行时联网外发 | 无强制外联；仅在用户主动连接可选的官方 MongoDB MCP Server 时才会访问用户自己配置的数据库实例，用途单一透明 |
| ③ API Key/凭据 | 核心 schema 指导无需任何凭据；仅可选 MCP 联动需要数据库连接串，遵循 MongoDB MCP Server 官方文档配置，且明确建议默认只读（--readOnly） |
| ④ 可疑指令排查 | SKILL.md 全文未发现 prompt injection 或隐藏指令；相反，文中显式声明“绝不在未经用户明确批准的情况下执行写操作”的行为准则 |
| ⑤ 作者/组织信誉 | MongoDB, Inc.——NASDAQ 上市数据库公司，官方 GitHub 组织账号发布，具名维护 |
| ⑥ License | Apache-2.0，清晰、完全开源可审计 |
| ⑦ 最近维护 | 本技能目录最后提交 2026-07-01，整仓库最后推送 2026-07-15 |
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| elasticsearch-esql（Elastic 官方） | 教编码助手写 ES|QL 查询，面向已用 Elasticsearch 做日志/检索分析的团队 | 解决“如何查询”，本技能解决“如何设计存储结构”，且面向所有 MongoDB 应用开发者，通用性更强 |
| dd-apm（Datadog 官方） | APM 链路追踪安装与性能分析 | 属于可观测性/DevOps 范畴，依赖已有 Datadog 账号，与本技能的数据建模场景不重叠 |
| 同包姊妹技能 mongodb-connection / mongodb-query-optimizer | 分别聚焦连接池配置、查询优化 | 与 Schema Design 互补而非竞争，三者共同覆盖“连接-建模-查询”全链路 |
核心差异化：在上述官方厂商技能中，本技能是唯一系统化覆盖“文档数据库建模反模式”这一初中级开发者高频踩坑领域的一款。
8. 用户评价
该技能目前在第三方平台尚无具名的独立用户评价：除 MongoDB 官方博客的发布公告外，公开渠道仅见 1 段第三方评测视频，其正文内容无法核实。
9. 其他补充
据官方博客，Agent Skills 于 2026-03-31 发布，为全生命周期技能包第一批，将持续扩充；同包还含连接管理、查询优化等技能。
10. 安装使用方式
Claude Code（推荐）：
/plugin install mongodb安装后运行 /reload-plugins 激活。
Codex：
codex plugin marketplace add mongodb/agent-skills而后在 /plugins 中找到 “MongoDB Agent Skills” 安装 mongodb 插件。
通用（跨编码助手）：
npx skills add mongodb/agent-skills手动安装： 克隆仓库后将 skills/mongodb-schema-design/ 目录复制到所用编码助手读取 skills 的位置。
若需连接真实数据库自动验证，可另配置官方 MCP Server（npx "mongodb-mcp-server@<3" setup，默认只读）。
11. 注意事项
- 仓库星数为整个官方技能合集口径，非本技能独立仓库数据
- 可选实时诊断功能需 Atlas M10+ 付费层，免费层不可用，但不影响核心设计指导
- OpenClaw、Hermes Agent 支持情况未获验证，可尝试手动复制目录接入
- 技能上线约 3.5 个月，社区独立讨论与实测案例尚不多