23
// 项目简介
Reversa 是一个协调专业 AI 代理的框架，旨在分析遗留代码库并生成全面且可追溯的技术规范。它通过创建操作契约作为现有系统与现代编码代理之间的桥梁，从而确保开发过程的安全与信息透明。该工具在运行过程中严格遵守不可变性保证，确保在分析过程中不会修改或删除任何现有的项目文件。
// 技术分析
Reversa 是一个规范逆向工程框架，旨在将遗留代码库转换为 AI Agent 可执行的结构化规范。通过编排一个由专业 Agent 组成的五阶段流水线，它能够提取出原本隐藏在无文档代码中的隐式业务规则、架构决策和技术契约。这种方法通过为 AI Agent 提供必要的运行上下文，解决了“vibe coding”问题，从而在不破坏现有逻辑的前提下安全地演进遗留系统。
// 核心亮点
01
编排包含 Scout、Archaeologist 和 Architect 等角色的多 Agent 流水线，以执行全面的代码分析。
02
生成广泛的技术文档，包括 C4 图、ERD、状态机和 API 规范。
03
通过严格将所有 AI 生成的输出限制在专用文件夹中，确保项目不可变性，从而保持原始遗留源代码不受影响。
04
实施置信度量表（Confirmed、Inferred、Gap），帮助用户区分已验证的代码逻辑和需要人工验证的区域。
05
支持广泛的 AI 引擎和编码助手，包括 Claude Code、Cursor、Aider 和 GitHub Copilot，无需外部 API keys。
06
提供持久化状态管理，允许分析会话在中断后恢复，而不会丢失进度。
// 典型使用场景
01
将遗留代码逆向工程为 AI 代理可执行的规范
02
自动提取业务规则、架构决策和数据结构
03
生成包括 C4 图、ERD 和 API 契约在内的可追溯文档
// 快速开始
若要开始，请在遗留项目的根目录下运行 'npx reversa install' 以检测您的 AI 环境并设置必要的 Agent 技能。安装完成后，在您首选的 AI Agent 中打开项目，并通过输入 '/reversa' 或 'reversa' 触发分析。该框架随后将创建探索计划，并开始在 '_reversa_sdd/' 目录中生成文档。