SuperAPI AI 工具集

ln-711-npm-upgrader

通用与其它

查看项目

更新于 10-15 23:59

技能介绍

用途:作为 ln-710-dependency-upgrader 的子 Worker,按项目路径与包管理器类型升级 Node.js 依赖,处理破坏性变更并生成迁移报告。

主要能力:支持 npm、yarn(classic 与 berry)、pnpm;按 peer、framework、build、ui、state、utils、dev 等类别划分升级优先级;执行安全审计(npm audit --audit-level=high、yarn audit --level high、pnpm audit --audit-level high),critical 级别阻断升级;通过 npm outdated --json 等命令检查过期依赖;对比主版本并结合 breaking_changes_patterns.md 与 MCP 工具识别破坏性变更;按优先级顺序应用升级,失败可回滚;最后验证构建与类型检查并输出报告。

使用方式:工作流分为 Pre-flight、Analyze、Security Audit、Check Outdated、Identify Breaking、Apply Upgrades、Apply Migrations、Verify Build、Report 九个阶段。升级命令如 npm install <package>@latest --save、yarn add <package>@latest、pnpm add <package>@latest。迁移指南优先通过 mcp__context7__query-docs 查询,其次 mcp__Ref__ref_search_documentation,最后回退 WebSearch。配置项包括 upgradeType、allowBreaking、autoMigrate、auditLevel、minimumReleaseAge、legacyPeerDeps、force、runBuild、runTests、runTypeCheck、createBackup、rollbackOnFailure 等。

适用场景:需要批量升级 Node.js 依赖并处理主版本破坏性变更的前端或 Node 项目。

限制:要求存在 package.json,缺少锁文件时会警告并先执行 npm install;peer 依赖冲突可用 --legacy-peer-deps,仍失败才用 --force;不应用硬编码迁移,须通过 MCP 工具获取最新指南;构建失败时回滚该包并继续其他包。具体收费、平台与效果资料暂未提供。