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 审查共同组成可靠交付闭环。
- 多文件任务的质量取决于上下文管理,而不是单次代码生成能力。
下一课预告
下一课将介绍如何建立智能体评估体系,通过任务成功率、成本和速度指标持续优化系统表现。
按自己的节奏,确认真正理解。