sandeco/reversa

解决的问题

Reversa 解决了遗留软件系统中「知识被困」的问题。当生产系统积累了多年未文档化的业务规则和架构决策时，AI 编码代理往往无法安全地对其进行演进，因为缺乏对系统实际行为的正式规范。Reversa 通过将现有代码逆向工程为可操作的规范，使 AI 代理能够将其作为契约来演进系统，而不会破坏现有逻辑。

工作原理

Reversa 作为框架安装在遗留项目中。它通过多阶段的「发现（Discovery）」流水线（侦察、挖掘、解释、生成、审查）协调一组专业 AI 代理（如侦察员、考古学家、侦探等）。这些代理分析代码库，提取业务规则和模块契约，并在专用输出文件夹中生成可追溯的规范（SDD 规范）。

一旦这些规范存在，框架就提供针对不同目标的专用工作流：

• 演进：通过 /reversa-forward 流水线从规范生成新代码。
• 迁移：使用 /reversa-migrate 规划在现代技术栈上的重建。
• 文档化：通过 /reversa-docs 将提取的知识渲染为 HTML 小站点。
• 新建项目：使用 /reversa-new 从一个原始想法启动新项目。

适用人群

希望使用 AI 代理在不因缺少文档而引入回归风险的前提下，维护、演进或迁移其遗留软件的软件工程师和架构师。

核心亮点

• 非破坏性分析：框架保证从不修改或删除现有项目文件；所有写入操作均限制在特定的 .reversa/ 和 _reversa_sdd/ 文件夹中。
• 代理编排：使用 10 个专业代理团队（发现、构思、迁移等）处理软件生命周期的不同阶段。
• 可操作契约：生成的规范专为 AI 代理设计，而非仅面向人类阅读的文档。
• 代理无关性：不存储 API 密钥；它将智能委托给用户环境中已有的 AI 代理（如 Claude Code、Cursor、Codex）。
• 因果可追溯性：包含专用的缺陷代理，可直接链接回规范，追踪并修复缺陷。