很多人使用 Agent 编程时会有一个期待AI 写代码更快项目维护成本是不是也会更低不一定。现在也常听到一些说法某些项目的代码几乎全部由 AI 生成甚至“100% 由 AI 写代码”。但这里要区分两件事AI 生成代码文本和AI 完成软件工程不是一回事。AI 可以生成一行代码、一个函数、一个页面甚至一组补丁。但真正的软件工程还包括需求澄清、架构设计、数据模型、模块边界、关系分析、测试验收、部署维护和技术债清理。把“AI 生成代码”说成“AI 完成项目”就像把“机器搬砖”说成“机器设计并建成了一栋楼”。Agent 确实可以降低代码生成成本但不会自动降低工程复杂度。如果缺少架构约束、关系分析、验收机制和清理动作Agent 也会制造技术债而且可能制造得更快。一、Agent 提高的是速度不是工程判断Agent 很擅长生成代码。它可以快速增加接口修改页面补充函数生成测试批量处理文件。但软件项目的难点不只是“代码怎么写出来”。更难的是数据模型是否合理模块边界是否清楚接口是否稳定修改会不会影响其他功能当前方案会不会限制未来维护。这些问题属于工程判断。Agent 可以参与分析但不能自动替代判断。二、关系债AI 看到关键词却看不见关系项目变大以后代码之间的关系不再只靠文件名和关键词决定。一个函数可能被多个模块调用。一个字段可能影响数据库、接口和前端展示。一个 CSS 类可能同时作用于多个页面。一个配置项可能改变测试、部署和权限。但 Agent 常常会根据关键词定位文件。它看到login就修改登录文件看到cart就修改购物车文件看到button就修改按钮样式。问题在于真实影响关系不一定写在关键词里。很多关系藏在调用链里数据流里组件依赖里配置关系里历史兼容逻辑里。于是就会出现当前问题修好了相关功能却坏了。这就是关系债。它不是简单的代码错误而是 Agent 对项目关系理解不足造成的长期成本。三、残留债AI 喜欢追加不喜欢清理Agent 还有一个常见倾向为了避免删错先保留旧代码再新增一套逻辑。短期看这样比较安全。长期看项目会越来越臃肿。常见现象包括旧函数没有删除旧样式继续存在旧注释没有同步备份文件留在项目里临时代码变成永久代码重复逻辑同时存在新旧命名混在一起。代码不是只要能跑就行。代码还要能读、能删、能维护。如果 Agent 只会追加不会清理项目就会一层一层沉积下去。四、为什么这两类债特别危险关系债和残留债一开始都不明显。关系债的表现是本轮任务通过了但别的地方悄悄坏了。残留债的表现是当前代码还能运行但项目越来越难读。它们不会立刻爆炸而是慢慢积累。等到下一轮修改时人和 Agent 都会面对一个更混乱的项目不知道哪个函数还在用不知道哪个文件是旧版本不知道哪段注释还可信不知道哪个样式会影响哪个页面。这时AI 不但没有降低维护成本反而增加了维护难度。五、修改前先做关系分析避免关系债不能只让 Agent 搜关键词。在修改前应该要求它先回答这个函数被谁调用这个组件在哪些页面使用这个字段从哪里来、到哪里去这个样式是不是全局样式修改后可能影响哪些测试可以把这一步写进current_task.md修改前必须说明 1. 本次涉及哪些函数、组件、接口或样式 2. 它们被哪些地方调用或引用 3. 可能影响哪些功能 4. 用哪些测试或截图验证影响范围。这一步不是形式主义。它是在强迫 Agent 从关键词定位转向关系分析。六、修改后必须清理残留避免残留债不能只验收“功能是否可用”。还要检查是否留下旧函数是否留下重复逻辑是否有废弃注释是否有备份文件是否有临时代码是否有应该删除但没有删除的内容。可以在验收标准里加入本轮修改不允许保留无用旧版本代码。 如果确实需要保留必须在 revision_log.md 中说明原因和清理时间。这样Agent 就不能把“为了安全先保留”当成默认策略。七、真正的 Agent 工程也包括删除很多人使用 AI 编程只关注生成生成代码生成页面生成接口生成测试。但长期项目里删除同样重要。要删除旧代码错误注释重复逻辑临时方案失效状态过期文档。没有删除项目只会越来越厚。Agent 的任务不应该只是完成本轮功能。还应该包括保持项目结构干净。
