SuperAPI AI 工具集

modernize-uplift

编程与开发

查看项目

更新于 11-10 16:23

技能介绍

用途:modernize-uplift 用于执行同栈版本升级,即把 $system 从 $source_version 升级到 $target_version,保持技术栈不变。它明确区别于代码转换(transform):这里代码本身是好的,只需要在新版本运行时上运行。工作方式是保留结构、做最小的可编译差异、在目标版本上行为一致,变更由两个版本之间已知的破坏性变更驱动,而不是重新推导业务逻辑。可选的第四个参数 $project_pattern 用于把工作范围限定到匹配的项目。

前置条件:代码位于 legacy/$system,若其为符号链接,需先说明指向位置;若不存在则停止。该技能建议先运行 /code-modernization:modernize-preflight 获取就绪报告,并要求在 .NET、Java 或 Python 环境中确认目标运行时和源运行时能否构建与测试。若源运行时无法在当前环境运行,则双运行降级为目标版本单运行,等价性证明回退为基于录制的输出的特性化测试,并需在计划与 UPLIFT_NOTES 中如实标注。

流程:包括工具链与版本固定(失败即停)、工作副本、项目图与顺序、人工审批的计划、版本差异目录(DELTA_CATALOG.md)、双目标测试脚手架(BASELINE.md 作为基线预言机)、先试点一个单元再分批迁移(PLAYBOOK.md 记录经验)、以及依赖感知的升级批次。每一步都有明确的准入门槛,例如没有基线不能宣称测试通过。

主要能力:支持 .NET、Java、Python 与前端生态的迁移工具探测(如 dotnet upgrade-assistant、OpenRewrite、pyupgrade、ng update),区分工具已安装、可运行和实际运行;构建按爆炸半径排序的差异目录,标记机械性可自动修复与需人工判断的变更;生成试点后可供后续代理使用的 playbook;支持多目标(multi-target)共享库过渡。

使用方式:需在支持子代理和 Workflow 工具的环境中调用;可调用 code-modernization:modernize-uplift-deltas 工作流生成差异,或使用 uplift-migrate 工作流按单元与依赖顺序批量迁移。编辑全部发生在 modernized/$system-uplifted/ 副本中,源目录保持不动。

限制:需要人工审批计划与试点;双运行取决于平台(如 net48 仅在 Windows 或 Mono 上运行);版本号模糊时必须停下询问;跨多个主版本需拆分为逐跳升级;涉及凭据或生产配置的文件不应提交。官方未提供收费、价格或平台信息,暂未提供。