SuperAPI AI 工具集

modernize-reimagine

编程与开发

查看项目

更新于 11-10 16:24

技能介绍

该技能是代码现代化流程中的“重新构想”(reimagine)命令,用于基于从遗留系统提取的意图,在全新架构上重建系统,而非简单移植。其核心流程分为六个阶段,并包含两个必须的人工检查点。

用途 适用于需要对遗留系统进行根本性重构的场景:将旧系统视为规范来源而非结构模板,从业务规则、接口和领域模型中提取意图,设计全新架构并搭建服务骨架。

主要阶段与能力

  • 阶段A:规范挖掘。复用已有的分析产物(如业务规则、数据对象、拓扑图、评估报告),缺失时并发启动对应代理(业务规则提取器、遗留分析师)补充。最终生成AI原生规范文件,包含能力清单、领域模型、接口契约、非功能需求和行为契约(验收测试)。所有凭据均被掩码,连接信息以环境变量占位符表示。
  • 检查点1:呈现规范摘要,询问哪些能力为P0、是否有意舍弃,等待用户回答并记录。
  • 阶段C:架构设计与批评。设计目标架构(C4容器图、服务边界与理由、技术选型、数据迁移方案),随后由架构批评代理审查过度工程、遗漏需求、扩展风险等,整合后写入架构文档。
  • 检查点2:呈现架构并停止,未经用户明确批准不进行任何脚手架搭建。
  • 阶段E:并行脚手架。批准后,通过工作流工具或并行代理为每个服务生成项目骨架、领域模型、API桩和可执行的验收测试。未实现的规则标记为预期失败并附规则ID。禁止使用遗留代码中的真实凭据作为测试数据。完成后运行验收套件并报告测试总数、通过数、待实现规则等。
  • 阶段F:知识交接。生成AGENTS.md文件,包含架构摘要、服务职责、规范位置、测试运行方式、遗留到现代的追溯映射。凭据仅以环境变量名出现。

使用方式 命令的第一个参数为系统名,其后全部内容为目标愿景描述(不可截断)。代码位于legacy/$system(可能是符号链接,需先说明指向)。若代码不存在则停止并提示使用/code-modernization:modernize --source指定路径。所有子代理在前台运行并等待结果,结束时停止所有已启动的服务器或进程。若存在MODERNIZATION_BRIEF.md,需匹配当前命令的阶段并遵守其范围、进入/退出标准和用户编辑。

适用场景

  • 遗留系统现代化改造,尤其是需要架构重构而非简单迁移的项目。
  • 已有部分分析产物(业务规则、数据对象等)的系统,可复用加速。
  • 团队希望在关键决策点(能力优先级、架构方案)保留人工控制。

限制

  • 必须提供遗留代码路径,否则无法运行。
  • 依赖多个子代理和可能的工作流工具,若工作流工具不可用则需手动并行启动代理(最多同时3个)。
  • 需要用户响应两个检查点,流程才会继续。
  • 若缺少MODERNIZATION_BRIEF.md中匹配的阶段,需停止并询问。
  • 报告生成脚本依赖python3,失败时仅提示并继续。
  • 凭据安全要求严格:不得将遗留凭据用于任何配置或测试数据。