mcpField
M
mongodb-migration-expert

mongodb-migration-expert

github.com/shipshitdev数据与数据库38183 次安装2 天前更新
代码仓库

关于 mongodb-migration-expert

面向 MongoDB 开发者的迁移规划技能，帮助安全地调整集合结构并支持大数据集。重点包括分阶段兼容更新、批量回填，以及按查询模式设计索引。

主要功能

  1. 01规划兼容性优先的增量变更
  2. 02分批回填数据
  3. 03按查询模式设计索引
  4. 04编写幂等迁移脚本
  5. 05用 explain 验证索引使用

适用场景

  1. 01规划仅向前的结构迁移
  2. 02更新多租户集合
  3. 03为常用筛选和排序添加索引

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/shipshitdev/skills --skill mongodb-migration-expert

安装后在 Claude Code 中输入/mongodb-migration-expert确认已加载。

附带文件plugin.json

详细介绍

MongoDB 迁移专家

设计安全、已建立索引且向后兼容的架构变更与迁移。

适用场景

  • 添加或变更 MongoDB 集合、索引或字段
  • 为多租户或大型数据集设计架构模式
  • 规划只向前的迁移

核心原则

  • 架构变更应先采用增量方式，之后再进行破坏性变更。
  • 分批回填数据；避免锁定大型集合。
  • 索引必须匹配查询模式。
  • 确保迁移具备幂等性且可观测。

迁移工作流

  1. 添加带默认值或可为空的新字段。
  2. 部署能够处理新旧字段的代码。
  3. 回填数据（使用脚本分批处理）。
  4. 如有需要，在回填后添加或调整索引。
  5. 在后续版本中移除旧字段。

索引

  • 为常用的筛选和排序添加复合索引。
  • 避免索引过多；每个索引都会降低写入速度。
  • 使用 explain 验证索引使用情况。

多租户模式（如适用）

  • 在文档中包含 tenantId。
  • 复合索引应以 tenantId 开头。

检查清单

  • 读写均向后兼容
  • 脚本具备幂等性
  • 使用安全选项创建索引
  • 已记录向前修复方案

评论

支持 Markdown