sandeco/reversa

解决的问题

Reversa 解决了遗留软件系统中的「知识困局」问题。通过将现有代码转换为可执行、可追溯的规范（操作契约），防止 AI 编码代理破坏关键的、未文档化的业务规则和架构决策，使代理能够安全地演化系统。

工作原理

Reversa 作为框架安装在遗留项目中。它协调一组专业 AI 代理分析代码库并生成规范。该过程遵循多个明确的管道流程：

• 发现管道： 五阶段序列（侦察、挖掘、解释、生成、审查），用于映射系统、分析模块、提取业务规则、合成架构并编写规范。
• 正向循环： 一个桥梁，将这些规范转化为运行代码，通过需求、规划和审计的顺序演化系统。
• 迁移管道： 将遗留规范转换为现代技术栈的重建计划。
• 新建项目管道： 针对新项目，从原始想法直接推进到完整的软件设计文档（SDD）规范。

所有代理均遵循严格的不可变性规则：从不修改或删除现有项目文件，仅将输出写入特定文件夹（.reversa/ 和 _reversa_sdd/）。

适用人群

希望使用 AI 代理在不破坏未文档化逻辑的前提下维护、演化或迁移遗留软件的软件工程师和架构师。

核心亮点

• 非破坏性分析： 原始源代码绝对不可变，确保安全。
• 多代理编排： 使用专业团队进行发现、构思、缺陷追踪和迁移。
• 因果可追溯性： 将缺陷和变更与原始规范关联，实现可追溯。
• 操作契约： 生成专为 AI 代理设计的规范，而非仅人类可读的文档。
• 静态文档站点： 可将提取的知识渲染为包含 3D 架构图和定量指标的自包含 HTML 小型站点。