AI Agent / 系统课时

完成综合需求实战

完成综合需求实战

本篇通过一个真实多文件开发需求,演练编程智能体从理解目标到提交修改的完整闭环,最终让智能体能够完成代码搜索、计划制定、修改执行、测试验证和 Diff 审查。

学习目标

  • 掌握智能体处理复杂代码需求时的完整工作流程。
  • 学会让智能体在修改前分析项目结构并制定执行计划。
  • 能够通过测试和 Diff 审查验证智能体输出质量。

从需求到执行的完整闭环

综合需求通常不是修改一个文件,而是涉及多个模块、配置和测试。智能体需要先理解任务目标,再建立代码上下文,避免直接搜索关键词后盲目修改。

典型闭环可以分为需求解析、项目探索、方案规划、代码修改、自动验证和结果审查六个阶段。

编程智能体处理多文件需求闭环流程图

分析项目与制定修改计划

智能体首先需要获取项目结构、入口文件、相关模块和已有测试。好的计划不是列出文件名称,而是说明修改原因、影响范围和验证方式。

例如面对一个新增接口需求,智能体应该先定位路由、服务层、数据访问层和测试目录,再决定修改顺序。

bash
find src -maxdepth 3 -type f | head -20

预期输出

text
src/main/App.java
src/service/UserService.java
src/controller/UserController.java
src/test/UserServiceTest.java

执行修改并保持上下文一致

多文件修改的关键是保持前后关系一致。智能体需要根据计划逐步修改,而不是一次生成大量补丁。

修改过程中应关注接口契约、变量命名、异常处理和已有代码风格,避免引入局部正确但整体冲突的代码。

text
任务:增加用户查询接口
执行:
1. 修改 Controller 暴露接口
2. 调整 Service 查询逻辑
3. 补充测试用例
4. 运行验证命令

测试通过与 Diff 审查

测试通过只能证明当前用例没有失败,不能完全证明修改正确。最后还需要查看 Diff,确认变更范围符合需求。

bash
git diff --stat

预期输出

text
 src/controller/UserController.java | 12 ++++++++++++
 src/service/UserService.java       |  8 ++++++++
 2 files changed, 20 insertions(+)

审查重点包括新增代码是否必要、是否修改了无关文件、测试是否覆盖核心路径。

本课总结

  • 复杂开发任务需要让智能体先理解项目,再执行修改。
  • 计划、修改、测试和 Diff 审查共同组成可靠交付闭环。
  • 多文件任务的质量取决于上下文管理,而不是单次代码生成能力。

下一课预告

下一课将介绍如何建立智能体评估体系,通过任务成功率、成本和速度指标持续优化系统表现。

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

目录与阅读设置

阅读设置

17

记录一个想法

完成综合需求实战

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

登录哪都通