第1节:老项目改造的真实链路

📅 发布时间:2026/7/6 1:49:40 👁️ 浏览次数:
第1节:老项目改造的真实链路
需求背景现在我们去新公司入职面对公司里那个跑了几年的老项目怎么使用Codex等AI编辑器改它遇到问题打开README几行部署命令一张架构图看了几遍代码看似懂了但是又好像没有懂技术栈JavaSpring BootMyBatis每个类都很长散落着各种注释有的写着2020-08临时解决方案等下个版本重构但是没有指定下个版本是那个有一段业务写着”不要删除XXX对接方需要“但是没有说对接方是谁删了会出现什么问题2021-11回滚原因影响某个对接方的PR流程去问leader文档没有老项目改造最难的不是代码本身而是代码之外的那些东西图1老项目改造的难点没有AI的时候会怎么做找人聊把项目中的疑难点列举一个清单去问身边在这个项目中工作的同事产品架构师。把资料都翻找一遍README参考docs目录wiki企微的聊天记录clone项目浏览一遍代码看有哪些模块哪些是核心功能哪些是工具类哪些是看起来很久没有人动过的老代码哪些是最近还在改动的搭建环境把项目跑起来使用debug模式断点看真实数据流向观察请求进来之后的完整链路用curl访问几个核心接口验证项目确实跑通了能看到事件的输入输出带着疑问深挖代码梳理前面留下来的未知标记待着具体问题去查代码画出核心链路几张手绘图主流程从出入口核心数据表之间的关系依赖的外部服务开始改手中的任务先改小处跑通看结果确认没有副作用再改下处改完了做验收curl接口看主流程没有被破坏跑了几个相关的业务场景找人review图2工程师在没有AI是怎么从0开始接手项目的这样才是一个企业级项目的真实处理流程可能顺序会微调但是9个事情一个也不可以少我们发现前6步都是了解项目后3步才是改造把70%时间画在理解上30%才是动手真正稳定的工程师反而是在了解上划分更多的时间AI出现AI没有改变上述的9步法但它把里面的每一步里人和AI的分工打乱了在传统流程中都是人在做步骤慢画核心链路步骤繁琐梳理接口步骤耐心读一个陌生业务分支AI编辑器重新将这些给分配读README,AI可以一次性生成漂亮摘要画架构图AI快速扫码仓库给出一份Mermaid梳理清单AI动手比我们快10倍”XXX对接方是谁“”这段逻辑删除会出现什么事情“”AI改造要不要上线“这些都是人的事情不是AI的AI时代下的工程师真正的工程师就是在9步链路上把人和AI的分工搞清楚的工程师知道哪一步让AI冲在前面哪一步自己必须守住哪一步需要和AI来回确认❌错误做法跳过前6步拿到项目第一个事情就是打开Codex”问这个项目是做什么的“。虽然AI可以回答但是回答的很浅使用这个浅认知改代码改完后跑不通没有到预期看起来成功但上线就炸都有可能发生不知道项目有什么坑哪段代码不可以碰哪些历史约定存在这些东西不告诉它它永远不会知道✅正确做法扎扎实实做完前6步把了解到的东西落地为文档再交给Codex它会基于你提供的上下文做判断它给的方案会贴合这个项目的实际情况它改代码的时候知道哪些地方需要绕开AI时代这些步骤一步不能少只是每一步人和AI的分工变了图3AI时代下的工程师怎么从0接手一个项目冷启动慢飞轮转起来快先找人聊、翻资料、读代码、搭环境、跑起来、摸接口、画链路。这一通操作下来可能要一两天甚至一两周。这段时间你感觉什么都没产出心里容易焦虑这种焦虑很正常但你要知道这不是浪费时间是投资。做完冷启动之后你会进入一个飞轮你对项目的理解越深后续的改造越轻松。你积累的文档越厚下次打开代码时的心智成本越低你和 AI 协作时提供的上下文越准AI 给的方案越贴合