AI Agent / 系统课时

复用现有模块与公共能力

复用现有模块与公共能力

本篇解决 AI 生成代码时重复造轮子的问题,通过建立模块复用意识,让 AI 优先理解已有组件、工具函数和基础设施,最终生成更稳定、更符合项目约束的实现。

学习目标

  • 理解为什么增量开发中应优先复用已有能力。
  • 掌握向 AI 描述现有模块并约束代码生成的方法。
  • 能够检查生成结果是否真正复用了项目公共能力。

识别可复用能力

在 Vibe Coding 场景中,AI 并不知道项目中已经存在什么能力。如果直接提出“实现用户登录”“生成数据处理逻辑”等需求,模型可能创建新的工具类、重复封装接口,导致代码分裂。

复用的第一步是明确项目已有资源,包括公共组件、服务层、工具函数、基础类、配置模块和第三方封装。开发者需要先告诉 AI 当前系统有哪些边界,再要求它基于已有能力完成增量修改。

现有模块与新增代码复用关系图

引导 AI 使用已有实现

与 AI 协作时,应提供已有代码位置、接口职责和不可改变的约束。例如,不要只说“实现缓存功能”,而应说明“项目已有 CacheService,请调用它,不新增缓存客户端”。

一个有效的需求描述通常包含三个部分:已有能力是什么、当前任务需要什么、禁止生成什么。例如:

text
已有模块:UserRepository,负责用户数据访问。
当前任务:增加用户资料查询接口。
约束:必须调用 UserRepository,不允许直接操作数据库。

这样可以减少 AI 自行设计新方案的概率,让生成结果贴近当前架构。

验证复用结果

生成代码后,需要检查实现是否满足复用目标。重点关注是否出现重复逻辑、新增相似工具类、绕过公共接口访问底层资源等问题。

可以通过简单搜索确认是否存在重复实现,例如检查项目中是否出现多个日期处理、权限判断、请求封装方法。如果发现重复,应要求 AI 重构为调用已有能力。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

复用现有模块与公共能力

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通