name: framework-compatibility-checker description: 检查代码库与目标框架版本的兼容性并生成迁移路径 allowed-tools: [“Bash”, “Read”, “Write”, “Grep”, “Glob”, “Edit”]
框架兼容性检查器技能
检查代码库与目标框架版本的兼容性，识别破坏性变更，并推荐迁移路径。
目的
为以下方面启用框架升级评估：
- 废弃API检测
- 破坏性变更影响分析
- 兼容性矩阵生成
- 迁移路径推荐
- 风险评估
能力
1. 废弃API使用检测
- 查找废弃的方法调用
- 识别已移除的API
- 检测过时模式
- 映射替代API
2. 破坏性变更影响分析
- 分析升级变更日志
- 将破坏性变更与代码匹配
- 评估影响范围
- 按严重性排序
3. 兼容性矩阵生成
- 映射当前版本与目标版本
- 列出兼容的依赖项
- 识别版本冲突
- 生成升级路径
4. 迁移路径推荐
- 建议增量升级
- 识别中间版本
- 推荐安全升级顺序
- 规划破坏性变更处理
5. 风险评估
- 评分升级难度
- 识别高风险区域
- 评估测试需求
- 计算时间线影响
工具集成
| 工具 | 框架 | 集成方法 |
|---|---|---|
| Angular 更新指南 | Angular | 网页 / API |
| React Codemod | React | CLI |
| Next.js 升级 | Next.js | CLI |
| Spring Boot 迁移器 | Spring | CLI |
| Vue 迁移指南 | Vue | 网页 / CLI |
| .NET 升级助手 | .NET | CLI |
输出模式
{
"analysisId": "string",
"timestamp": "ISO8601",
"current": {
"framework": "string",
"version": "string"
},
"target": {
"framework": "string",
"version": "string"
},
"compatibility": {
"compatible": "boolean",
"breakingChanges": [
{
"type": "string",
"description": "string",
"locations": [],
"migration": "string",
"effort": "string"
}
],
"deprecations": [],
"removedApis": []
},
"migrationPath": {
"steps": [],
"intermediateVersions": [],
"estimatedEffort": "string"
},
"risk": {
"score": "number",
"factors": []
}
}
与迁移流程集成
- framework-upgrade: 主要兼容性检查
- language-version-migration: 版本分析
相关技能
codemod-executor: 自动修复dependency-updater: 依赖项升级
相关代理
framework-upgrade-specialist: 升级执行