核心用法
本 Skill 是一个纯文档型的 MongoDB 技术知识库，专为数据库设计、开发和运维场景打造。用户可通过自然语言查询获取针对性的技术指导：
- Schema 设计：提供 embed vs reference 决策框架，处理无界数组、多租户布局、版本化文档等复杂场景
- 性能诊断：解读
explain("executionStats")输出，识别 COLLSCAN、索引选择性不足、内存排序等问题 - 聚合管道：构建高效 pipeline，处理
$lookup连接、物化视图、窗口函数，规避 100MB 内存限制 - 连接管理：配置连接池、超时重试、ODM（Mongoose/Prisma）行为调优
- 生产运维：复制集故障转移、分片键设计、WiredTiger 缓存调优、备份恢复策略
- 实时事件：变更流（change streams）、CDC 模式、简历令牌管理
Skill 采用"情境驱动"组织方式，用户描述问题症状（如"查询超时""secondary 滞后""分片热点"），即可获得对应场景的排查路径和解决方案。
显著优点
1. 深度专业化：覆盖 MongoDB 4.4-8.0 全版本特性，包含 13 个专题文档（schema、indexes、aggregation、sharding、transactions 等），形成完整知识体系
2. 实战导向：提供 8 条核心规则（Core Rules）和大量反模式陷阱（Traps），如"16MB 是上限而非预算""无界数组是 #1 schema 失败"，直接对应生产教训
3. 可配置性：支持通过 ~/Clawic/data/mongodb/config.yaml 自定义服务器版本、部署环境（Atlas/自托管/DocumentDB）、驱动语言、ODM 类型、字段命名风格等，输出内容自动适配
4. 安全零风险：纯 Markdown 文档，无可执行代码、无网络请求、无敏感信息，通过 CLS-Certify S+ 顶级安全认证
5. 决策框架清晰：Embed/Reference 三问法、ESR 索引排序原则、8 条输出门禁检查，将经验转化为可执行流程
潜在缺点与局限性
1. 无自动化执行：作为纯知识库 Skill，无法直接执行查询分析、生成索引或连接数据库，需用户手动操作
2. 版本适配依赖配置：若用户未主动配置 server_version，部分特性建议可能针对默认 7.0 版本，与实际情况不符
3. 生态局限：专注于 MongoDB 原生生态，对 PostgreSQL、Elasticsearch 等关联技术仅提供跳转指引（pg、elasticsearch 技能）
4. 中文支持有限：文档内容为英文，中文用户需自行翻译理解
5. Atlas 中心化：默认配置偏向 MongoDB Atlas 托管服务，自托管用户的部分场景（如 mongod.conf 调参）覆盖相对简略
适合的目标群体
- 后端开发者：设计文档模式、优化查询性能、集成 Mongoose/Prisma ODM
- DBA/运维工程师：处理复制集故障、分片集群调优、容量规划、备份策略
- 架构师：评估 MongoDB 适用场景、设计多租户方案、制定技术规范
- 技术负责人：建立团队 MongoDB 最佳实践、制定代码审查门禁
特别适合从 SQL 背景转型 MongoDB 的团队——文档反复强调"关系型规范化直觉会误导"，提供明确的思维模式转换指南。
使用风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 配置漂移 | 默认 `server_version: 7.0` 可能与实际环境不符 | 首次使用时明确配置 `config.yaml` |
| 建议误用 | 技术建议需结合实际数据分布验证 | 始终遵循"先 `explain`，再优化"原则 |
| 破坏性操作 | 文档包含 `drop`、`deleteMany` 等操作建议 | 依赖 `destructive_confirm: true` 默认配置，强制人工复核 |
| 版本特性差异 | Atlas/DocumentDB/Cosmos DB 功能支持不一 | 配置 `deployment` 参数过滤不适用的特性建议 |
整体而言，本 Skill 风险极低，主要风险在于用户未充分理解建议背景而直接应用，遵循文档内置的"输出门禁"（Output Gates）检查可有效规避。