framework-migration-deps-upgrade

依赖升级策略技能

技能概述

依赖升级策略技能帮助开发者安全、有序地更新项目依赖，评估风险并制定清晰的迁移路径。

适用场景

1. 项目依赖严重落后

当项目依赖版本长期未更新，存在安全漏洞或性能问题时，可以使用此技能制定渐进式升级计划，避免一次性大规模更新带来的风险。

2. 处理破坏性变更

当主要依赖发布大版本更新，包含不兼容的 API 变更时，此技能可以提供详细的迁移指南和兼容性分析，帮助平稳过渡。

3. 建立依赖更新流程

团队需要建立规范的依赖管理流程，包括风险评估、自动化测试和回滚机制时，此技能提供完整的实施框架和最佳实践。

核心功能

升级概览与风险评估

自动扫描项目依赖，生成可用的更新列表，并根据变更范围、社区反馈、测试覆盖率等因素评估每次升级的风险等级，帮助决策升级优先级。

分步迁移指南

为每个主要版本升级提供详细的迁移步骤，包括代码变更、配置调整、API 替换等具体操作，确保开发者知道如何处理破坏性变更。

兼容性与测试策略

分析依赖之间的兼容性关系，推荐升级顺序，并提供测试清单用于验证升级后的功能完整性，确保更新不会破坏现有功能。

回滚与监控机制

提供清晰的回滚程序和步骤，当升级出现问题时可以快速恢复到稳定版本，同时建议升级后需要监控的关键指标。

常见问题

依赖升级的最佳顺序是什么？

建议遵循"从叶子到根"的升级原则：先升级最底层的工具类依赖（如 lodash、date-fns），然后是中间件和插件，最后升级框架核心依赖（如 React、Vue）。每次升级后都要确保测试通过，再继续下一次升级。

如何处理破坏性变更（Breaking Changes）？

首先阅读官方迁移文档，列出所有受影响的 API 和配置；然后在开发分支进行代码修改，运行完整测试套件；对于复杂的变更，可以考虑使用适配器层逐步过渡，而不是一次性重写。

升级依赖后需要做哪些测试？

至少要运行：单元测试覆盖修改的代码区域；集成测试验证模块间交互；端到端测试确保核心用户流程正常；性能测试检查是否有回归；手动测试关键功能路径。建议在预发布环境先验证，再部署到生产环境。