用途
modernize-status 是一个只读式的进度查询命令,用于回答“我现在在代码现代化流程的哪一步”。它在一个屏幕内汇报 $system 的现代化状态。该命令只做检查,不修改任何内容,唯一例外是会刷新分析目录下的 REPORT.html 报告文件(通过运行 build_report.py 生成;如果失败或缺少 python3,只提示一行并继续)。
如果分析目录中还没有任何产物,它给出的答案是运行 /code-modernization:modernize $system --source <代码路径>,该命令会询问用户想要什么并启动 preflight 阶段。
主要能力
1. 产物清点
检查 analysis/$system/、modernized/$system*/ 等位置,按阶段生成一张表,逐行列出每个产物的存在情况与修改时间:
- intent:INTENT.md,即用户想要什么,由 modernize 命令写入。
- preflight:PREFLIGHT.md,检查 Check 0 的人工回答与 Check 6 的范围边界发现是否就位,以及 legacy/$system 指向的目录是否存在。
- assess:ASSESSMENT.md、ARCHITECTURE.mmd。
- map:topology.json、TOPOLOGY.html、.mmd、extract_topology.。
- extract-rules:BUSINESS_RULES.md、DATA_OBJECTS.md。
- review:RULE_REVIEWS.json,统计已由人工决定(确认、错误、需讨论)的标记规则数量,以及仍待处理的数量。
- brief:MODERNIZATION_BRIEF.md,检查批准区块是否已签署。
- harden:SECURITY_FINDINGS.md、security_remediation.patch。
- uplift:DELTA_CATALOG.md、BASELINE.md、PLAYBOOK.md(没有 playbook 说明试点尚未进行,不能展开批量执行),以及 modernized/$system-uplifted/UPLIFT_NOTES.md(按单元记录:在目标上构建成功?基线可复现?)。
- transform:modernized/$system/<module>/ 下每个模块是否有测试、是否有 TRANSFORMATION_NOTES.md(完成标记)。
- reimagine:modernized/$system-reimagined/ 下每个服务的验收测试,以及 AGENTS.md 交接文件(完成标记;该阶段不写 TRANSFORMATION_NOTES.md)。
- equivalence:EQUIVALENCE.json,记录执行用例数、相同数、有差异数;任何有差异或缺失的用例,或执行数为零,均视为失败。
- verify:VERIFICATION.md,由 modernize-verify 写入,记录每个已构建模块的判定(PROVEN、PARTLY PROVEN 或 NOT PROVEN)及是否有人工签署。没有 VERIFICATION.md,或文件早于模块代码或测试的,视为尚未证明。
2. 过期检测
标记任何早于其上游依据的产物,例如:
- 简报早于 ASSESSMENT.md、topology.json 或 BUSINESS_RULES.md,说明不再反映最新发现,需重跑 brief。
- uplift 的简报早于 DELTA_CATALOG.md,或没有目录,说明阶段顺序未参考版本差异就确定了,需重跑 brief。
- TOPOLOGY.html 早于 topology.json,需重跑 map 的渲染步骤。
- TRANSFORMATION_NOTES.md 早于 BUSINESS_RULES.md,说明模块可能未实现最新规则,需列出具体模块。
3. 密钥卫生检查
检查 analysis/.gitignore 是否存在并覆盖 SECRETS.local.md 与 *.local.patch(在 git 仓库中通过 git check-ignore 验证)。若 SECRETS.local.md 存在,确认它未被跟踪(git ls-files --error-unmatch 应失败)且从未被提交(git log --all --oneline -- <路径> 应为空)。任一检查失败都会醒目提示,并建议轮换密钥与清理历史记录。
使用方式
该技能通过一条状态命令触发,执行后输出产物清点表、过期项、密钥卫生结论,并以三行结论收尾:
- 当前位置:最远的已完成阶段及其覆盖程度,例如“映射 100%,14 个模块中 2 个已转换、1 个已证明”。
- 过期项:列出过期产物,没有则写“nothing”。
- 下一条命令:以可直接粘贴的完整命令行给出唯一最有用的下一步及一行理由。
推荐的阶段顺序为:preflight、assess、map、extract-rules、review(当规则被标记待人工处理时)、brief(需要批准),然后是简报中的第一阶段命令(transform、uplift 或 reimagine),再对已构建内容运行 verify,最后 harden。在 verify 判定为 PROVEN 且有人工签署前,不得将已构建模块视为完成;应将 verify 排在构建下一个模块之前。
适用场景
- 在代码现代化流程中随时确认当前进度与覆盖范围。
- 判断哪些产物已过期、需要重跑哪个阶段。
- 在继续构建前检查密钥文件是否被误提交。
- 不确定下一步该运行什么命令时,作为起点查询。
限制
该命令以检查为主,不执行现代化修改;除刷新 REPORT.html 外的写入均不发生。它的判断依赖分析目录与 git 仓库中的既有产物,缺少对应产物时会报告缺失而非推断内容。python3 不可用或报告生成失败时仅提示并继续,不影响其余检查。