Agent 欠的技术债，怎么还：vibe 项目的还债路线图

先承认：你的 vibe 项目已经欠债了

AI 写代码的速度是你的 10 倍，技术债的累积速度也是。vibe 项目的典型债单：三个功能相似的工具函数散落在不同文件（agent 每次都「新建一个更顺手」）、一个 800 行的组件没人敢动（包括写它的 agent）、核心流程测试覆盖率 0%（「先跑起来再说」之后就再也没说）。

好消息：还债也可以让 agent 当主力。它欠的债，它最清楚是怎么欠的——只要你给它正确的还债顺序和方法。

第一步：量化——让债看得见

还债从「数债」开始。让 agent 跑一遍代码库，输出一份《技术债清单》，每条包含四项：位置（文件+行号）、类型（重复/过长/无测试/硬编码/依赖冗余）、影响范围（几个功能依赖它）、修复成本估算（小/中/大）。

工具上别手写脚本：让 agent 用现成的静态分析（lint 规则、复杂度检测、重复代码检测）跑一遍，再人工过一遍清单，删掉误报。这份清单就是你的「资产负债表」——看不见的债最贵，因为利息一直在涨。

第二步：分类——不是所有债都要还

技术债分四类，处理方式完全不同：

1）高利息债（先还）：每次改功能都要绕开它的——比如那个 800 行组件。利息 = 每次开发多花的时间 × 改动频率。这类债越早还越赚。

2）低利息债（排队）：难看但不挡路的——比如命名不规范、注释缺失。记下来，等顺手时还。

3）死债（别还了）：即将被重写/下线的模块。还它的每一分钟都是浪费，直接在清单里标记「等重写」。

4）策略债（故意的）：为了赶时间有意走的捷径。关键是把「当时为什么这么写」记下来，否则三个月后你会以为是失误。

第三步：还债——让 agent 当施工队，你当监理

还债任务是指派给 agent 的最佳任务类型：目标明确、验收标准清晰、风险可控。 workflow：一次还一条，按「利息最高」排序；每条还债任务必须带测试——重构没有测试兜底就是赌博；还完跑全量测试 + 人工 review diff。

特别有效的三招：「提取」招——让 agent 把重复代码提取成公共函数，它找重复比人快；「切分」招——800 行组件按职责拆成小组件，一次拆一块，每拆完跑测试；「补测试」招——对核心流程先补测试再重构，测试是还债的安全带。

红线：还债和加功能不要在同一个 PR 里。混在一起，出问题你分不清是债没还好还是新功能写崩了。

第四步：防新增——让以后的 agent 不再欠新债

还旧债的同时要堵住新债。三个机制：1）Debt budget：每个新功能 PR 里，重构债不得超过功能代码的一定比例（比如还债行数 ≥ 新增行数的 20%）；2）用 Ponytail 这类 skill：让 agent 写代码前先问「能不能不写」，从源头减少债的产生；3）定期「还债日」：每月抽半天，只还债不加功能，雷打不动。

一句话

vibe 项目死掉的原因，很少是「做不出来」，多是「欠太多，还不起，不敢动了」。债不可怕，可怕的是没有账本、没有顺序、没有还款计划——而这三样，今晚让 agent 花一小时就能给你建起来。