name: mongodb-design slug: mongodb-design displayName: MongoDB 設計與使用助手 description: 幫助Agent為專案進行MongoDB文件模型設計、索引設計、聚合管道設計，並提供場景化使用指南。當用戶需要設計MongoDB Schema、選擇嵌入vs引用、設計聚合查詢時觸發。 version: 1.0.2 metadata: clawdbot: emoji: "🍃" requires: anyBins: ["mongosh", "mongo"] os: ["linux", "darwin"]

MongoDB 設計與使用助手

觸發條件

當用戶出現以下意圖時啟用本 Skill： - 設計 MongoDB 文件模型 / Schema - 嵌入 vs 引用的決策 - MongoDB 索引設計 - 聚合管道設計 - 分片方案

設計流程（Agent 執行路徑）

0. 版本檢查 → 載入 references/version-major.md 對比使用者版本，識別廢棄項和重大變更。同時載入所有 version-X.Y.md（X.Y ≤ 使用者目標版本），後續設計過程中 Agent 從已載入的上下文中自主匹配深度特性
1. 需求分析 → 理解資料實體、訪問模式、增長預期
2. 文件模型設計 → 嵌入vs引用決策（載入 references/design-spec.md）
3. 索引設計 → ESR規則 + 查詢模式匹配
4. 使用指引 → 載入 references/usage-guide.md，給出場景化操作
5. 生產建議 → 載入 references/best-practices.md，給出分片/一致性/效能建議
6. 模板參考 → 載入 references/patterns.md，匹配業務文件模型模板

快速參考

嵌入 vs 引用決策

ESR 索引規則

Equality → Sort → Range

本技能來自小蔥技能站7w4.net。

// 查詢
db.orders.find({ status: "paid" })          // Equality
  .sort({ created_at: -1 })                 // Sort
  .where("total").gt(100)                   // Range

// 索引（ESR順序）
db.orders.createIndex({ status: 1, created_at: -1, total: 1 })

索引核心原則

1. 一個查詢一個複合索引（優於多個單欄位索引）
2. $match 在前可利用索引，$unwind 後不能
3. 覆蓋查詢：投影只包含索引欄位
4. TTL 索引用於自動過期
5. 一個集合只能有一個文本索引

文件大小約束

11種官方 Schema 設計模式

漸進式載入

詳細內容按需載入 references/：

版本參考文件啟用規則

1. 模組啟用時 — 始終載入 references/version-major.md，Agent 需主動對比使用者使用的 MongoDB 版本，若存在廢棄項或重大變更，立即提示使用者
2. 深度特性 Step 0 自動載入 — 版本檢查時載入所有 version-X.Y.md（X.Y ≤ 使用者目標版本）。設計過程中 Agent 從已載入的上下文中自主檢索匹配相關特性，使用者無需指定版本號
3. 深度特性按大版本拆分，小版本持續追加 — 如 version-8.0.md 包含該大版本下所有小版本的設計級特性。更新時在檔案中新增 ## X.Y.Z 版本節即可，不單開檔案

硬規則

1. 設計規範內容來自權威資料（MongoDB官方文件/阿里雲MongoDB最佳實踐），不編造
2. 單文件不超過 16MB，陣列不超過 1000 元素
3. 索引必須遵循 ESR 規則
4. 能用嵌入解決的不要用 $lookup
5. 片鍵不可更改，選擇要慎重
6. 避免單調遞增片鍵（會成為熱點）
7. 多文件事務有效能開銷，儘量通過模型設計避免

這個Skill內容專業全面，涵蓋MongoDB設計的各個方面，知識點講解清晰易懂，對設計模式和最佳實踐的總結很實用。但作為助手使用起來可能偏理論化，缺乏互動演示和實際案例引導，整體更像一份技術文件而非互動工具。如果需要實際專案設計指導，可能還需要額外補充更多場景化示例。