项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
技术标签
使用教程
—
环境要求
- Node.js 18+
- 一个已存在的遗留项目（在项目根目录执行安装）
- 环境中已安装 AI 编码代理（Claude Code、Codex、Cursor 等）
- 建议项目已用 Git 版本控制并推送到远程仓库
安装与启动步骤
-
1备份遗留项目
安装前先把全部文件提交到 Git，并额外做一份本地拷贝，出问题可用 git restore 或备份还原。
git add -A && git commit -m "backup before reversa" cp -r my-project my-project-backup -
2在项目根目录安装
进入遗留项目根目录后执行 npx 安装，安装器会检测环境中的 AI 引擎并询问要安装哪些代理。
npx reversa install -
3按提示完成配置
安装器收集项目名、语言和偏好，生成 .agents/skills/、引擎入口文件和 .reversa/ 目录及 SHA-256 清单。
-
4在 AI 代理中激活
用 AI 代理打开项目，输入 /reversa 启动分析；Codex 等不支持斜杠命令的引擎直接输入 reversa。
/reversa -
5中断后继续分析
进度保存在 .reversa/state.json，会话中断后再次输入 reversa 即可从断点继续。
reversa
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
.reversa/reversa-config.json | 否 | 控制自动流程可写入项目代码的范围，策略为 blocked 时任务开始前即停止 | blocked |
_reversa_sdd/ | 否 | 规格输出目录，代理的所有写入仅限该目录与 .reversa/ | _reversa_sdd/ |
如何确认成功
安装后确认项目内新增 .reversa/、.agents/skills/ 及 CLAUDE.md 或 AGENTS.md；激活 reversa 后出现自我介绍与探索计划。
常见问题
Q：Reversa 会修改或删除我原有的代码吗？
A：不会。安装器只创建新文件，分析期间代理的所有写入都被限制在 .reversa/ 和输出目录内，不触碰其他文件。
Q：需要提供 LLM 的 API Key 吗？
A：不需要。Reversa 不请求、不存储、不传输任何 LLM 服务的 API Key，全部智能由你环境中已有的 AI 代理提供。
Q：分析中途会话断了怎么办？
A：每个检查点都会把进度写入 .reversa/state.json，重新输入 reversa 即可从上次中断处继续。
Q：用的是 Codex 这类不支持斜杠命令的引擎怎么办？
A：直接输入不带斜杠的 reversa 命令即可启动同一条流程。
Q：有哪些不同的使用流程？
A：/reversa 做逆向分析出规格，/reversa-autonomous 无中断跑完，/reversa-migrate 迁移到新栈，/reversa-docs 生成 HTML 站点。
注意事项
- 强烈建议先做 Git 提交并保留远程仓库备份，AI 代理仍可能出错。
- 除 /reversa-forward-autonomous 的编码阶段外，代理不会执行删除、git push、发布、安装等破坏性或对外命令。
- /reversa-forward-autonomous 会按 .reversa/reversa-config.json 的许可范围修改项目代码并执行构建、测试与安装。
核心亮点
- 把隐式业务规则显式化为可执行规格，AI 代理重构时有据可依
- 输出可纳入版本控制，规格随代码同步演进，不是一次性文档
- 面向 AI 编码代理设计，与 Claude Code、Cursor 等工具链直接衔接
不足之处
- 对高度动态或元编程密集的代码，静态分析覆盖度可能不足
- 项目处于成长早期，复杂语言生态和大型仓库的实测案例待观察
适用场景
- 接手无文档的老系统，先用 reversa 生成规格再让 AI 代理重构
- 给遗留模块补单元测试前，用规格明确输入输出和边界条件
- 把单体老应用迁移到新架构时，用规格作为行为对照基准
替代项目
Sourcegraph、CodeQL
下一篇：skills
同类项目推荐
bolt.new
开源
想到啥说啥，网页应用当场生成直接能用
Prompt, run, edit, and deploy full-stack web applications. -- bolt.new -- Help Cente···
fuzz4all
开源
用大模型自动生成测试输入，发现各种软件漏洞
️Fuzz4All: Universal Fuzzing with Large Language Models
ponytail
开源
教 AI 学会偷懒，不写代码反而更快交付
Makes your AI agent think like the laziest senior dev in the room. The best code is ···
pi-agent-desktop
开源
下载即用的桌面 AI 编程助手，免配置免命令行
Pi — A cross-platform AI coding agent, bringing the Claude Code experience to your ···