用途:modernize-assess 是代码现代化工作流中的评估环节,用来回答“这个系统到底是什么、有多大、有多复杂、有多少债和安全风险,以及建议采用哪种现代化模式”。它不执行改造,只做事实基础的评估,便于工程负责人带着有依据的结论进入预算讨论。
主要能力:
- 单系统模式(Single-system mode)。对 legacy/<system> 目录依次进行:清单统计(SLOC、主流语言、文件数、复杂度、依赖新鲜度、文档覆盖率,并用 COCOMO 指数 2.94 × KSLOC^1.10 作为相对规模排序指标);技术指纹(语言、框架与运行时版本、构建系统与清单位置、数据存储、集成点、测试存在情况);深度分析(由三个子代理并行完成架构域梳理与 Mermaid 图、技术债前 10 项、按 CWE 标注的安全漏洞表);可选的运行时画像(有 APM、批处理日志等遥测时补充 p50/p95/p99);文档缺口对比;最后写出评估文档。
- 组合模式(--portfolio <parent-dir>)。扫描父目录下每个直接子目录,如存在 Workflow 工具则每个系统启动一个调查代理,统一公式计算复杂度指数,输出 analysis/portfolio.html 热力图(每系统一行,含语言、KSLOC、文件数、复杂度、依赖新鲜度、文档覆盖率、风险等列,并以颜色分级),并给出先做哪个系统的 2–3 句建议。
使用方式:命令形如 /code-modernization:modernize-assess <system> 或 --portfolio <parent-dir>;标志放在系统名之后,例如 <system> --show-secrets。代码须位于 legacy/<system>(常为符号链接,命令会先用 readlink 说明指向)。若目录不存在则停止并提示改用 /code-modernization:modernize $system --source <path>。统计优先用 scc,其次 cloc,再次 find + wc -l。凭据值一律掩码处理:评估文档 ASSESSMENT.md 中不出现明文,发现的凭据写入 SECRETS.local.md,只有加 --show-secrets 时才在其中附带原始值。
产出物:analysis/<system>/ASSESSMENT.md(含执行摘要、系统清单、架构概览、运行时画像、技术债前 10、安全发现、文档缺口前 5、相对规模、推荐现代化模式——Rehost、Replatform、Refactor、Rearchitect、Rebuild、Replace 之一及理由与后续命令)、analysis/<system>/ARCHITECTURE.mmd,以及刷新后的 analysis/<system>/REPORT.html。命令末尾提示下一步为 /code-modernization:modernize-map $system。
适用场景:接手历史遗留系统、需要向管理层汇报系统现状与风险、规划多年期多系统改造顺序、在重构/重写/替换方案间做取舍之前的事实摸底。
限制:依赖系统代码实际存在于约定目录;无 scc/cloc 时改用决策关键字近似统计复杂度;COCOMO 指数仅为相对规模指标,不代表工期或成本,输出中不打印人月、日期或费用;无遥测数据时运行时画像标注为不可用;不适用于无代码仓库的 VCS 之外场景下发 --show-secrets。