SuperAPI AI 工具集

modernize-review

编程与开发

查看项目

更新于 11-10 16:23

技能介绍

用途

该技能用于代码现代化工作中的人工业务规则确认环节。自动代理会从代码中挖掘业务规则并逐条引用代码行,但规则是否符合业务意图、截断是设计还是缺陷、阈值是否仍为现行策略,这类判断只有熟悉业务的人才能给出。本技能负责把这些需要判断的规则以问答方式交给人工逐条确认,并将答案记录下来,供后续规划与构建阶段使用。

主要能力

  1. 选择待确认规则:读取 BUSINESS_RULES.md(每条规则以 ### RULE-NNN 标记,含优先级、置信度,有时带疑似缺陷或专家问题),并读取已存在的 RULE_REVIEWS.json,跳过已经作出判定的规则,并告知将询问多少条。支持三种范围:默认 flagged 询问带疑似缺陷、专家问题或置信度低于 High 的 P0 规则以及任务说明中开放问题点名的规则;p0 询问全部 P0 规则;all 询问全部规则。

  2. 逐条询问:使用 ask_question 工具(而非聊天文本),每次最多四条规则。每条规则给出编号作为标题,包含规则标题、通俗陈述、单行 Given/When/Then、引用行(file:line)以及疑似缺陷或专家问题,并提供三个选项:正确(规则正确且需要)、错误/不想要(描述与代码不符,或代码当前如此但不该如此)、不确定(需要讨论)。用户也可以不选选项而直接键入备注,内容按其原话保留。用户可随时叫停。若用户在请求中已直接键入判定(如 RULE-004 wrong: it truncates on purpose),则按所给内容记录,不再弹窗询问该规则。若无该工具且无键入判定(无头运行),不进行猜测,所有规则保持未审查状态并明确说明。

  3. 记录结果:将答案合并写入 analysis/$system/RULE_REVIEWS.json(与实时进度面板的审查卡写入同一文件),结构包含系统名、版本号和 reviews 映射;每条记录的 verdict 为 confirmed(正确)、wrong(错误/不想要)或 discuss(不确定),并记录时间、规则标题及可选的用户原话备注。仅在新答案替换旧答案时修改已有条目。随后由该 JSON 生成 analysis/$system/RULE_REVIEWS.md:一段简短说明加一张按规则编号排序的表(Rule | Verdict | When | Title | Note)。可选刷新报告:运行 python3 "${ANTIGRAVITY_PLUGIN_ROOT}/scripts/build_report.py" $system;若失败或缺少 python3,则说明一行并继续。

  4. 说明后续影响:向用户说明三点——标记为错误或需讨论的规则尚未确定;任务说明会将其列为开放问题,且不会据此构建 Behavior Contract;transform 与 reimagine 不会把错误规则当作基准,并会在 P0 规则仍处于讨论状态时停止。最后给出下一命令:/code-modernization:modernize-brief $system(若任务说明已存在且规则有变动则重新运行),或任务说明中计划已批准时的下一构建命令。

使用方式

在代码现代化流程中调用本技能,指定系统名与规则范围;技能会读取分析文件与已有审查记录,通过问答工具逐条向业务知情者提问,并将答案写入 JSON 与 Markdown 文件。无图形问答工具且无预输判定时,技能不会自行猜测,需人工提供判定或改用可交互环境。

适用场景

适用于代码现代化或系统重写项目中,自动挖掘出的业务规则需要业务人员逐条确认真伪与意图的环节;尤其适合存在疑似缺陷、专家疑问或置信度不高的 P0 规则需要人工裁决的情况。

限制

技能不会自动修改 BUSINESS_RULES.md;不依赖 ask_question 工具则无法完成交互式询问,无头运行且无预输判定时不会产生任何审查结论;每条规则约需一分钟(每十条约十分钟);Python 报告刷新为可选项,失败不影响主流程。