论文
Reversa:一种逆向文档工程框架,用于将遗留软件转换为人工智能代理的操作规范
Reversa: A Reverse Documentation Engineering Framework for Converting Legacy Software into Operational Specifications for AI Agents
摘要
遗留系统集中了业务规则、架构决策和操作异常,这些规则通常隐含在代码、数据、配置和维护实践中。同时,基于语言模型的 编码智能体 依赖于可靠的上下文、正确性标准和行为契约来以较低的风险修改真实系统。本文介绍了 Reversa,这是一种逆向文档工程框架,用于将遗留软件转换为人工智能代理的可追踪操作规范。 Reversa 将此过程组织为多代理管道:专门的代理绘制项目表面、分析模块、提取隐式规则、综合架构、编写单元级规范并审查生成的索赔。该提案强调了三种机制:代码和规范之间的可追溯性、明确的置信度标记以及保留人工验证的差距。该框架作为 Node.js CLI 进行分发,跨多个代理引擎安装技能,并使用 SHA-256 清单在更新或卸载操作期间保留修改的文件。除了架构描述之外,我们还报告了一个关于将 ATM 从 COBOL 迁移到 Go 的探索性案例研究,其中管道产生了按内部置信指数分类的 517 项声明、10 个已记录的差距、53 个 Gherkin 奇偶校验场景以及一个重建计划,其中 11 项任务中的 9 项在盘点时完成。本研究尚未完成最终奇偶校验和切换。我们并不声称拥有广泛的经验优势;我们将贡献定位于逆向工程文献、基于 LLM 的文档和软件代理,并提出了一个评估协议,其中包含覆盖范围、可追溯性、置信度、效用和成本指标。