SuperAPI AI 工具集

modernize

编程与开发

查看项目

更新于 11-10 16:22

技能介绍

modernize 是一个面向代码现代化场景的引导式技能,位于 smartworldarafath/google_antigravity_plugins 下。它的定位是“前门”,即用户接触现代化流程的起点,而不是直接执行代码改造。

用途:帮助用户明确要对现有代码库做什么,并给出一条可执行的下一步命令。它适合对现代化流程不熟悉、不清楚从何开始的人,也适合需要快速记录改造意图并生成后续计划的场景。

主要能力:

  1. 定位系统与代码:如果已指定系统名则直接使用;否则检查 analysis/ 和 legacy/ 目录,判断是否存在一个或多个系统,或需要询问代码位置。代码通常位于 legacy/$system 目录,可以是副本或符号链接。若未提供,工具会询问代码在本机文件夹还是 git URL,并可在用户同意后克隆到 legacy/<name>。
  2. 询问目标与约束:通过弹出问题收集用户意图,最多两次弹出。第一次询问“想做什么”和“必须保持什么不变”。前者选项包括:迁移到同技术的新版本、逐块重写到不同技术并保持旧系统运行、在新架构上从零重建、先理解代码并列出功能。后者可选:迁移期间旧系统继续运行、行为必须完全一致含已知怪癖、同时修复已知缺陷、先做安全审查。第二次询问“目标是什么”,根据第一步发现的代码栈给出定制选项。
  3. 记录意图:将用户回答逐字写入 analysis/$system/INTENT.md,包括目标类型(uplift、transform、reimagine 或 understand)、源与目标、必须保持的约束和日期。后续命令读取此文件,避免重复询问。
  4. 展示路线:用最多八行列出按顺序执行的命令(preflight、assess、map、extract-rules、review、brief,以及后续的 uplift、transform 或 reimagine、verify、harden),每行说明产出和人工决策点。若用户选择“先理解”,路线在 brief 后停止;若不确定,先运行 preflight 和 assess,由评估推荐模式决定路线。若选择“先做安全审查”,harden 会放在 assess 之后、任何构建之前。
  5. 给出第一步:提供填好参数的精确命令,例如 /code-modernization:modernize-preflight billing "Java 17" --source /work/billing,并询问是否开始。用户同意后,读取插件根目录下的 commands/modernize-preflight.md 并执行。

使用方式:用户通过自然语言说明想对代码做什么,工具以弹出式问题收集最少信息,然后写入 INTENT.md 并输出路线和第一条命令。在无头运行等无法弹出问题的环境下,工具会选择默认值并记录为待办项。

适用场景:需要将 .NET Framework 迁移到 .NET 8、Java 8 迁移到 17、Python 2 迁移到 3 等版本升级;逐块重写到不同技术栈;在新架构上重建;或先梳理并理解遗留系统。

限制:资料未提供具体实现语言、安装方式、收费模式、平台支持、运行环境要求或效果保证。工具依赖 ask_question 工具进行交互,无该工具时只能使用默认值。它本身不执行代码改造,实际改造由后续命令完成。