reversa

Reversa 是一个从遗留系统中逆向工程规范的框架，使 AI 编码代理能够安全地与其协作。通过在项目根目录运行 `npx reversa install` 安装，它会将一组专门的 AI 代理部署到工作区中。 核心流水线是 Discovery 阶段（`/reversa`），由 Reversa 代理通过五个步骤编排：Scout 绘制项目表面，Archaeologist 分析模块和控制流，Detective 提取隐式业务规则和架构决策，Architect 综合 C4 图和 ERD，Writer 生成具有代码可追溯性的可执行操作契约。可选代理包括 Visor（从截图生成 UI 文档）、Data Master（数据库分析）、Design System（设计令牌提取）和 Soul Extractor（执行摘要规范）。 除发现之外，Reversa 还支持多种工作流： - `/reversa-new` — 从一行想法到完整规范的全新项目 - `/reversa-forward` — 从规范到代码逐步演进系统，一次一个功能 - `/reversa-migrate` — 在现代技术栈上重建遗留系统 - `/reversa-docs` — 将提取的知识渲染为静态 HTML 迷你站点 - `/reversa-debugger` — 追踪缺陷，并具备回溯到规范的因果可追溯性 - `/reversa-refactor` — 在不改变行为的情况下提升代码质量 - `/reversa-pricing-*` — 根据规范估算工作量和成本 自主变体（`/reversa-autonomous`、`/reversa-new expresso`、`/reversa-forward-autonomous`）在仅进行一次初始访谈后即可端到端运行流水线。所有写入都限制在 `.reversa/` 和输出文件夹中，绝不触碰现有项目文件。检查点会保存到 `.reversa/state.json`，以便恢复中断的会话。 该框架生成结构化产物，包括 SDD 规范、需求文档、路线图、行动计划和可追溯性矩阵。输出位于 `_reversa_sdd/`（用于规范）和 `_reversa_bugs/`（用于缺陷跟踪），两者均纳入版本控制。