SuperAPI AI 工具集

modernize-brief

编程与开发

查看项目

更新于 11-10 16:23

技能介绍

用途 本技能用于在代码现代化(重构、升级或重建)的规划阶段,将前期分析结果整合为一份可供审批的《Modernization Brief》。该文档既是指导委员会审批的对象,也是后续构建命令执行时依据的计划。

主要能力

  • 汇总分析目录(analysis/$system/)中的 ASSESSMENT.md、topology.json(及其旁的 .mmd 文件,但从不读取 TOPOLOGY.html)、BUSINESS_RULES.md 等输入;若缺少必需文件则说明并停止。
  • 条件读取更多输入:RULE_REVIEWS.json / RULE_REVIEWS.md(人工对各规则的判定)、INTENT.md(目标、目标栈、必须保持不变的要求)、PREFLIGHT.md(Check 0 范围回答与 Check 6 范围边界)、DELTA_CATALOG.md(同一技术栈升级到新版本时必需)。
  • 依据 INTENT.md 的目标决定每个阶段的构建命令类型:同技术更新版为 uplift,换技术重写为 transform,新架构重建为 reimagine;无 INTENT.md 时依据评估中的模式判断。
  • 处理输入新鲜度:若输入比已有简报更新则重新生成;若简报比所有输入都新而用户仍重跑,则询问变更内容;在简报头部记录输入时间戳。
  • 生成简报,包含:目标、目标架构(Mermaid C4 容器图与旧组件到目标组件的映射表)、分阶段序列(3–6 个阶段,跨栈重写按绞杀者模式排序,升级按构建图叶子优先排序)、业务走查、行为契约、验证策略、待决问题与批准块。
  • 每个阶段以固定格式输出(阶段名、命令、模块、规模、风险、入口与出口准则),阶段用 Mermaid flowchart LR 表示依赖关系而非甘特图。规模仅为 T 恤尺寸的相对排序,不给出人月、周数、日期或交付估算。入口/出口准则写成可检查的条件,构建命令只可勾选或加注,不得改写;变更须作为 Proposed revision 行提交审批人。
  • 第一阶段作为试点,并说明试点可能揭示分析遗漏的差异、前置条件或环境事实,据此重新生成简报属正常路径。
  • 对 P0 规则要求证明等价后才能发布阶段;置信度低于 High 的 P0 规则标记为阻塞项,需领域专家确认。
  • 可为升级场景在缺少 DELTA_CATALOG.md 时先产出该目录并等待结果,不在代理运行中结束回合,也不猜测差异。
  • 完成后可选运行 python3 "${ANTIGRAVITY_PLUGIN_ROOT}/scripts/build_report.py" $system 刷新报告;失败或缺少 python3 时说明并继续。

使用方式 在会话中调用该技能,它会按上述输入要求生成 analysis/$system/MODERNIZATION_BRIEF.md,随后呈现简报摘要并停止,等待用户明确批准(若会话支持可用计划模式)。'无异议'不视为批准;批准后下一步执行第一阶段的命令。

适用场景 适用于需要对遗留系统进行同技术栈版本升级、跨技术改造或基于新架构重建,并需要一份供审批与执行共用的分阶段计划的项目;尤其适合已有评估、拓扑与业务规则分析结果的现代化工程。

限制 依赖前置分析产物,缺失必需文件时会停止;不猜测版本差异;不提供工期或工作量估算;批准前不继续执行;人工预检回答与意图不可被猜测覆盖。