AgentSkillsCN

dependency-upgrade

通过兼容性分析、分阶段上线与全面测试,稳妥推进重大依赖版本升级。无论是升级框架版本、更新核心依赖,还是应对库中可能引发的破坏性变更,这一方法都能助你从容应对,风险可控。

SKILL.md
--- frontmatter
version: 4.1.0-fractal
name: dependency-upgrade
description: Manage major dependency version upgrades with compatibility analysis, staged rollout, and comprehensive testing. Use when upgrading framework versions, updating major dependencies, or managing breaking changes in libraries.

Dependency Upgrade

Master major dependency version upgrades, compatibility analysis, staged upgrade strategies, and comprehensive testing approaches.

Do not use this skill when

  • The task is unrelated to dependency upgrade
  • You need a different domain or tool outside this scope

Instructions

  • Clarify goals, constraints, and required inputs.
  • Apply relevant best practices and validate outcomes.
  • Provide actionable steps and verification.
  • If detailed examples are required, open resources/implementation-playbook.md.

Use this skill when

  • Upgrading major framework versions
  • Updating security-vulnerable dependencies
  • Modernizing legacy dependencies
  • Resolving dependency conflicts
  • Planning incremental upgrade paths
  • Testing compatibility matrices
  • Automating dependency updates

Semantic Versioning Review

code
MAJOR.MINOR.PATCH (e.g., 2.3.1)

MAJOR: Breaking changes
MINOR: New features, backward compatible
PATCH: Bug fixes, backward compatible

^2.3.1 = >=2.3.1 <3.0.0 (minor updates)
~2.3.1 = >=2.3.1 <2.4.0 (patch updates)
2.3.1 = exact version

Dependency Analysis

🧠 Knowledge Modules (Fractal Skills)

1. Audit Dependencies

2. Analyze Dependency Tree

3. Phase 1: Planning

4. Phase 2: Incremental Updates

5. Phase 3: Validation

6. Identifying Breaking Changes

7. Codemod for Automated Fixes

8. Custom Migration Script

9. Unit Tests

10. Integration Tests

11. Visual Regression Tests

12. E2E Tests

13. Renovate Configuration

14. Dependabot Configuration

15. Lock File Management

16. Peer Dependency Resolution

17. Workspace Upgrades