接手老项目做迭代,它成了我的"项目副驾"

一、目标 / 场景

我接手了公司内部「视***台」的前端迭代工作。这是一个跑了几年的老项目:页面多、公共组件多、文档基本没跟上,前任留下的代码注释也少。日常需求是持续加新页面、调数据看板、修线上问题。

最头疼的不是写新代码,而是理解成本——改一个看板之前,得先搞清楚这个模块的数据流从哪来、状态放在哪、公共组件能不能复用。以前这些全靠全局搜索 + 顺着 import 一层层点,半天就过去了,改完还总担心牵一发动全身。

这次的目标很明确:用 TraeCode 把「读懂老项目」和「小步迭代」这两件事的效率打下来。

二、身份 / 为什么重要

我是团队的前端开发,负责上述平台的迭代维护。对我们这种"存量项目重于新建项目"的团队来说,AI 编程工具的价值不在从零生成一个炫酷 demo——那一年碰不到几次——而在于能不能在别人写的几千个文件里快速找到该改的地方、生成符合团队风格的代码、改完自己验证一遍。

这部分提效是实打实的:需求排期不变的前提下,省下来的理解时间就是能多做一个需求的时间。

三、使用过程 / 技巧

第 1 步:先让 Agent 把项目"讲"给我听。
导入项目后第一件事不是改代码,而是让 Agent 结合 #引用 梳理整个工程:路由结构、状态管理方案、公共组件清单、请求封装在哪。它输出的项目导读我稍作修改后直接放进了仓库,顺便解决了"下一个人接手怎么办"的问题。

第 2 步:把团队规范写进 Rules。
命名风格、组件拆分粒度、样式写法、提交信息格式,这些以前靠口口相传的东西,我花十几分钟写进了项目规则。效果立竿见影:后面生成的代码风格基本不用返工,也不会出现"一个页面三种写 CSS 的方式"。

第 3 步:日常迭代,分大小两条路。

  • 单文件小改动:直接用 CUE 超级补全,顺着写,它对上下文的预测很准,尤其是"照着隔壁页面的样子再写一个"这种需求;
  • 跨文件改动:丢给 Agent,但我会先要方案再放行——让它列出打算改哪些文件、有没有风险点,确认无误再执行,最后逐条看 diff。

第 4 步:改完让它自己验证。
构建命令和 lint 直接交给 Agent 在终端里跑,报错原文丢回去,大部分小问题它能自己修掉,不需要我来回复制粘贴。

第 5 步:接上 MCP 查接口文档。
把接口文档查询配成 MCP 工具后,Agent 写请求层之前会自己去查字段定义,我不用再当"人肉接口文档翻译器"。

几条实用技巧

  1. 规则先行:Rules 花十分钟,省后面每天十分钟;
  2. 任务拆小:一次让 Agent 干一件事,成功率远高于"一次全做完";
  3. 先方案后放行:跨文件改动前一定要先看它的执行计划;
  4. 锁定上下文:用 #引用 明确告诉它相关文件,比"你自己找"稳得多;
  5. 保留人工审查:涉及权限、数据展示的逻辑,提交前自己一定过一遍。

四、结果 / 建议

用了两周下来的直观感受:老项目的上手周期比预期缩短了大半,原本"理解模块 + 动手改"两天的活,现在基本一天内能交付;常规迭代的改动质量也更稳定,因为验证环节是自动跑的。

给同样要接手老项目的同学三点建议:

  1. 先梳理,再提效——别急着让 AI 写代码,先花半天让它帮你把项目结构摸清楚,这是回报率最高的一步;
  2. 把 TraeCode 当"有人把关的结对",而不是无人值守的自动机,方案确认和 diff 审查不能省;
  3. 规则和 MCP 值得投入——前者决定代码风格上限,后者决定它获取信息的真实程度。

以上就是我这两周的实战记录,欢迎评论区交流老项目 + AI 编程的玩法。