SuperAPI AI 工具集

cobol-modernization

编程与开发

查看项目

更新于 11-08 04:13

技能介绍

用途

cobol-modernization 是一个面向 COBOL 代码库的端到端迁移工作流插件,目标是将 COBOL 项目逐步迁移为 Java。它把迁移过程拆分为多个阶段,并配有各阶段对应的技能说明文档(SKILL.md)。

工作流阶段

阶段 1:构建配置(Build Setup)

为迁移建立基础:配置 GnuCOBOL 编译环境;创建 Java 项目结构(Maven/Gradle + JUnit 5);通过运行 COBOL 生成带黄金输出的测试夹具。产出包括 build_notes.md(构建说明)、test-fixtures/(输入/输出测试数据)和 test_manifest.json(测试用例映射)。

阶段 2:大型机规划(Mainframe Planning)

在不修改代码的前提下生成转换指南:将 CICS/VSAM 构造映射为标准 COBOL 等价物,记录错误处理替换方案,识别需要打桩的 UI 操作。产出为 mainframe_dependency_removal_plan.md。

阶段 3:大型机依赖移除(Mainframe Removal)

应用转换指南:用文件 I/O 替换 EXEC CICS 命令,添加 FILE STATUS 检查,对 BMS/屏幕操作打桩。验证标准为代码可用 GnuCOBOL 编译,并能使用测试夹具运行。

阶段 4:Java 迁移(Java Migration)

将标准化后的 COBOL 翻译为符合 Java 惯例的代码(而非逐字直译),编写基于黄金输出的 JUnit 测试,并在注释中保留 COBOL 引用。完成标准为:全部代码可编译、全部 JUnit 测试通过、不残留 TODO 或桩代码。

前置条件

  • GnuCOBOL 编译器(cobc)
  • Java 11+,搭配 Maven 或 Gradle
  • Python 3.13 与 uv
  • LLM API 密钥(Anthropic 或 OpenAI)

使用方式

设置环境变量并运行迁移模块,传入 COBOL 项目源码路径:

export LLM_API_KEY="your-api-key" export LLM_MODEL="anthropic/claude-3-5-sonnet-20241022"

uv run python -m lc_sdk_examples.cobol_modernization --src-path /path/to/cobol/project

PowerShell 环境变量设置等价写法:

$env:LLM_API_KEY = "your-api-key" $env:LLM_MODEL = "anthropic/claude-3-5-sonnet-20241022"

uv run python -m lc_sdk_examples.cobol_modernization --src-path C:\path\to\cobol\project

输出结构

your-project/ ├── .lc-sdk/ │ ├── initial_batch_graph.json │ ├── fixed_batch_graph.json │ └── mainframe_dependency_removal_plan.md ├── test-fixtures/ │ ├── inputs/ │ └── expected_outputs/ ├── test_manifest.json ├── src/main/java/ └── src/test/java/

适用场景

适用于需要将 COBOL 遗留系统迁移到 Java 的项目,尤其是包含 CICS/VSAM 大型机依赖、需要先标准化再翻译的代码库。

限制

该工作流依赖外部 LLM API(需自备密钥与模型),并依赖 GnuCOBOL、Java、Python/uv 等工具链;迁移范围按四个阶段依次推进,需先完成构建配置与大型机依赖移除,才能进行 Java 翻译。常见问题可参考项目提供的 troubleshooting.md。