用途:deps-migrate 用于两类迁移——库替换(如 moment.js → date-fns、webpack → vite、lodash → es-toolkit)和同库 API 模式迁移(如 React 19 移除 forwardRef、Vue Options API 转 Composition API)。版本升级(A v1 → A v2)应改用 deps-upgrade。
主要能力:检测包管理器、monorepo 结构、CI、hooks、changeset 与测试基础设施;扫描源库导入与用法范围;借助 Context7 与社区资料做 API 对比并构建 API 映射表;检测官方 codemod 与兼容层(如 es-toolkit/compat);识别 @types 等相关包;在 /tmp 中做测试优先验证;输出带置信度指数的迁移计划;执行迁移并遵循仓库约定;最终做类型检查、lint、测试与构建。
使用方式:按阶段推进(非线性,发现推翻假设时回到受影响阶段)。先分析环境,再识别迁移目标,做文档与兼容性分析,检测官方工具与兼容层,检测相关包,在 /tmp 中验证(含 tsc --noEmit),生成计划并获用户确认后执行,最后完成仓库约定合规与最终验证。源库在最终验证通过后才移除。
适用场景:跨库替换、弃用 API 清理、框架迁移等。
限制:需要 gh CLI 与包管理器 CLI;Context7 可选但推荐,可通过 /plugin marketplace add upstash/context7 安装;支持 npm、pnpm、yarn、bun、cargo、pip/uv/poetry、go、bundler、composer;私有仓库认证需手动配置,不自动处理 2FA;大型 monorepo 可能需手动指定目标包。