前言

最近接手了一个基于jQuery构建的老项目,采用前后端不分离的系统架构,项目几乎没有任何说明文档,也不知道这个系统究竟具备什么功能,提供了哪些接口。为了快速解读这个系统的代码,若完全依赖人工阅读代码梳理逻辑,时间成本极高,必须得借用AI工具来完成。

我的目标:借助AI工具“解读”并生成系统说明文档

图片

AI工具介绍

为了解读老项目代码,我使用到了以下AI工具和大语言模型,以便于多工具运用形成差异对比。

图片

IDE类

  1. IntelliJ IDEA:开发IDE,也是大家常用的开发工具

  2. Lingma:阿里巴巴新出的带AI辅助的IDE

  3. Cursor:带AI辅助功能的代码IDE,定位专业级 AI 编辑器

  4. Trae 国内版:专为中国开发者设计,首个“国产AI原生IDE”

  5. Trae 国际版:面向全球开发者,支持多语言及国际化项目需求

  6. Windsurf:定位为 代理式 IDE,强调 AI 与开发者实时协作

LLM类:

GPT-4、Claude 3.7、Claude 4、Qwen3、DeepSeek R1

图片

我给AI的输入

为了让LLM能够理解和输出我想要的系统说明书文档,我给大模型的输入是这样的:

全面解析下这个java项目,核心要总结以下内容,并输出一份详细的系统说明文档

1、使用到了哪些技术栈,需要详细列出,包括前端、后端、中间件、数据库等

2、系统都有哪些功能,需要详细说明每个功能清单以及具体做什么的

3、具体有哪些接口、页面、数据表等,需要分别列出具体的清单

4、分析该项目潜在的问题都有哪些,针对每个问题分别有什么修改建议和方案

5、因不是前后端分离的项目,判断是否可以直接修改成前后端分离的

6、如果要修改成前后端分离的项目,需要什么技术栈选型,改造工作量预估需要多少人天,列出详细的工作量评估清单

图片

差异结果对比

过程就不跟大家展示了,直接上AI工具输出结果的差异对比吧,供大家做个参考:

图片

总结

根据测试结果,Claude 4的表现最为突出,其解读并输出的内容明显优于其他LLM。借助AI工具解读老项目代码的速度大幅提升,整体的工作效率也得到显著提高。因此,我强烈推荐大家多尝试不同的AI工具组合,探索更多的应用场景,真正让AI工具成为你的得力助手!

你在解析老项目时踩过什么坑或者好的经验?欢迎留言分享~

更多最新文章可关注:

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐