用途：分析遗留 COBOL 程序与 JCL 脚本，辅助迁移到现代 Java 应用，提取业务逻辑、数据结构与依赖，生成可执行的迁移策略。
主要能力：解析 COBOL 各分部、Working-Storage 变量、FD 文件定义、业务段落、PERFORM、CALL 层级、嵌入式 SQL 与错误处理；解析 JCL 作业步骤、程序调用、DD 数据依赖、条件逻辑与返回码；处理 copybook 记录布局、REDEFINES、OCCURS、PICTURE，并生成 Java POJO；构建 CALL 层级、copybook、文件、数据库表等依赖图。
使用方式：先用 find 查找 .cbl/.CBL/.cob、.jcl/.JCL、.cpy/.CPY 文件；运行 scripts/analyze-dependencies.sh 或 .ps1 生成依赖图；用 scripts/extract-structure.py 提取结构为 JSON；用 scripts/generate-java-classes.py 将 copybook 转为 Java POJO；用 scripts/estimate-complexity.py 评估复杂度；最后编写迁移策略文档。脚本仅用标准库，输出 JSON，便于接入 CI/CD。
适用场景：COBOL/JCL 资产盘点、依赖梳理、数据结构映射、迁移工作量评估与 Java 架构设计。
限制与注意：COMP-3 与含小数数值必须用 BigDecimal，避免 float/double；注意 COBOL 数组从 1 开始、隐式类型转换、REDEFINES、计算型 GO TO、ALTER、PERFORM THRU、BY REFERENCE 与 BY CONTENT 语义差异；需用生产数据样本严格测试。详细规则见 pseudocode-cobol-rules.md、transaction-handling.md、messaging-integration.md、performance-patterns.md、testing-strategy.md。