框架迁移与依赖升级
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/framework-migration-deps-upgrade。
技能介绍
要解决什么问题
主版本依赖一升,编译报错、运行时行为变化、间接依赖冲突往往一起冒出来。团队常见做法是「全量升到最新」或长期锁死版本,前者容易在生产踩坑,后者会累积安全漏洞与维护债。本技能面向安全、增量的升级:在可接受的测试成本下,把破坏性变更拆成可验证的步骤,并保留可执行的回退路径。
技能如何工作
你提供项目背景与约束(通过 $ARGUMENTS 等输入),技能按依赖管理最佳实践产出结构化方案,典型输出包括:
- 升级概览:可更新项汇总与风险分级
- 优先级矩阵:按重要性与升级安全性排序的清单
- 迁移指南:针对大版本的分步说明(含破坏性变更应对)
- 兼容性报告:直接/传递依赖的冲突与约束分析
- 测试策略:用于验证升级的自动化测试建议
- 回滚计划:失败或回归时的回退流程
- 监控面板与时间线:升级后的健康指标与排期建议
更细的模式与示例可参考技能附带的 resources/implementation-playbook.md。
适用边界
任务若与依赖升级策略无关(例如纯业务功能开发、与版本矩阵无关的基础设施选型),不必启用本技能。它不会替代你在 CI 里实际跑测试或执行 npm/pip/go mod 等命令,而是帮你把「升什么、先升谁、怎么验、怎么退」说清楚。
使用场景
- 收到安全通告后,需在不大改业务代码的前提下,梳理哪些直接/传递依赖可增量升级并评估回归风险。
- 框架或运行时主版本升级前,要把官方 breaking changes 拆成可排期的分步迁移,并对应每步的验证方式。
- 多个服务共用锁文件或 BOM,需要按优先级矩阵决定先升哪几个包,避免一次改动面过大导致联调失败。
- 升级后偶发构建或运行时异常,需要事先写清的兼容性报告与回滚流程,以便快速退回已知良好版本。
适合人员
- 负责生产服务依赖锁与发版节奏的后端维护者,希望在 CVE 时限内完成分批升级而非临时全量 pin
- 牵头 React/Vue/Spring 等大版本替换的前端或全栈负责人,需要向协作团队交付可执行的迁移顺序与测试范围
- 撰写依赖变更 RFC 的架构师或 Tech Lead,要把风险分级、自动化测试建议与回滚步骤写进评审材料
- 维护多年期单体或模块化老项目的工程负责人,希望用增量升级消化主版本积压而不是冻结依赖数年