SuperAPI AI 工具集

nx-multi-repo-migrate

部署与运维

查看项目

更新于 10-16 07:23

技能介绍

用途:把一组仓库协调迁移到同一个目标 Nx 版本(例如 23.0.0-beta.25),并为每个仓库创建关联的 PR。输入为目标版本与仓库列表;未指定时默认使用 nrwl 组织下的 nx、ocean、nx-labs、nx-examples、nx-console。

主要能力:借助 polygraph 技能发现仓库、选择组织并建立会话;为每个仓库派生独立子代理并行执行迁移,用 show_agent 轮询至终态;每个子代理从 origin/<base> 新建 migrate-nx-<VERSION> 分支,按锁文件识别包管理器,先安装再运行 nx migrate <VERSION>,再次安装(保持可变安装,勿设 CI=true),先提交版本升级,再运行迁移。目标支持编排循环(nx ≥ 23.2.0-beta.8)时使用 NX_MIGRATE_ORCHESTRATOR=true 与 --create-commits;否则走经典回退,手动逐条提交并自行应用 AI 迁移提示。子代理成功后立即推送该仓库分支并单独创建 PR,不等待最慢仓库。

使用方式与限制:需先验证目标版本存在(npm view nx@<version> version)。注意发布年龄门控可能导致静默降级到 latest,需按命令临时绕过;pnpm 在 Bash 沙箱下可能失败,可关闭沙箱或从父代理迁移。迁移可能改写源码,需审查非依赖差异;框架大版本不兼容等真实阻塞应交给人工,不要自行编造绕过方案。完成后删除 migrations.json 与经典路径的 tools/ai-migrations/,保留 .nx/migrate-runs/。