SuperAPI AI 工具集

stack-modernization

编程与开发

查看项目

更新于 10-16 03:04

技能介绍

用途:让项目保持最新、精简、符合惯例的依赖。三项工作:升级落后的依赖、删除未使用或废弃的包、迁移大版本升级后遗留的旧模式(例如 v4 仓库里还留着 v3 配置)。会编辑 package.json 与源码,因此运行在确认闸门之后,升级前先核实版本。版本号不以训练数据为准,而是联网查最新。

授权范围:只在用户请求与已有批准内行动;加载本技能不授予新权限。仅报告的请求保持只报告,遵守调用方给出的目标、主机、提供方与成本限制,扩大范围前先询问,并将这些限制传递给被委派方。

契约:输入为一个仓库,可选焦点(deps / dead / patterns / all,默认 all)。输出为先给出现代化计划(每个包:当前 → 最新、风险、迁移说明),再在每步之间测试通过的前提下逐个应用升级。经计划批准后才修改 package.json、锁文件与源码。外部副作用为 bun install/upgrade 命令与用 WebSearch 确认最新版本,不部署。应用任何升级或删除前需确认,先展示计划;遇到有迁移成本的大版本跳升要明确说明。

步骤:1)盘点,用 bun outdated、bun pm ls;未使用包可跑 knip 或 depcheck,否则逐依赖 grep 导入;同时标记框架模式漂移(Bun 项目中的 npm/yarn/pnpm 锁文件、Tailwind v4 项目中的 tailwind.config.{js,ts} 或 @apply 指令、当前大版本已改名的 middleware.ts → proxy.ts 等)。2)提议前逐个用 WebSearch 核实最新版,记录目标大版本及是否有破坏性变更/迁移指南。3)输出计划表(包名、当前、最新、跳幅、迁移链接)。排序:安全/补丁与次要升级在先,带迁移的大版本逐个来,再删死包,最后迁移模式。4)增量应用,一次一项并在每步之间跑类型检查与相关测试,如 bun add <pkg>@<已验证最新>、bun remove <pkg>、bun run type-check || bunx tsc --noEmit、bun run test <受影响区域>,每步成功即提交以便回滚;有大版本迁移指南就照做而非猜测新 API。

限制与反模式:不要凭记忆升级版本、不要一次性大爆炸升级、不要不读迁移指南就跳大版本、不要仅凭缺少导入就删包(需查动态导入、配置引用、peer 依赖角色)、本项目使用 Bun,不要重新引入 npm/yarn。资料未提供收费、价格与平台等更多信息。