SuperAPI AI 工具集

modernize-status

编程与开发

查看项目

更新于 11-10 17:24

技能介绍

用途

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 -- <路径> 应为空)。任一检查失败都会醒目提示,并建议轮换密钥与清理历史记录。

使用方式

该技能通过一条状态命令触发,执行后输出产物清点表、过期项、密钥卫生结论,并以三行结论收尾:

  1. 当前位置:最远的已完成阶段及其覆盖程度,例如“映射 100%,14 个模块中 2 个已转换、1 个已证明”。
  2. 过期项:列出过期产物,没有则写“nothing”。
  3. 下一条命令:以可直接粘贴的完整命令行给出唯一最有用的下一步及一行理由。

推荐的阶段顺序为:preflight、assess、map、extract-rules、review(当规则被标记待人工处理时)、brief(需要批准),然后是简报中的第一阶段命令(transform、uplift 或 reimagine),再对已构建内容运行 verify,最后 harden。在 verify 判定为 PROVEN 且有人工签署前,不得将已构建模块视为完成;应将 verify 排在构建下一个模块之前。

适用场景

  • 在代码现代化流程中随时确认当前进度与覆盖范围。
  • 判断哪些产物已过期、需要重跑哪个阶段。
  • 在继续构建前检查密钥文件是否被误提交。
  • 不确定下一步该运行什么命令时,作为起点查询。

限制

该命令以检查为主,不执行现代化修改;除刷新 REPORT.html 外的写入均不发生。它的判断依赖分析目录与 git 仓库中的既有产物,缺少对应产物时会报告缺失而非推断内容。python3 不可用或报告生成失败时仅提示并继续,不影响其余检查。