Java 研发｜AI Agent 落地研发全流程指南
一、AI Agent详解
核心目标：把需求→设计→编码→联调→自测→文档→Bug 修复全环节，用 AI Agent 自动化提效，告别单纯复制粘贴，让 Agent 理解你的项目技术栈、代码规范、业务逻辑。
一、先搞懂：适合程序员的 3 类 AI Agent
1. 代码专属 Agent（最常用，日常开发）
- 代表：Claude Code、GitHub Copilot Agent、CodeGeeX 智能体、豆包编程助手
- 核心能力：读取本地工程、理解项目结构、遵守你的代码规范、多文件联动修改、补全接口 / 实体 / 工具类
2. 通用长上下文 Agent（需求拆解、架构设计）
- 代表：Claude 3.5/4、Kimi、DeepSeek 长文本
- 核心能力：读需求文档、PRD、流程图、拆解模块、输出架构图、数据库设计、接口文档
3. 自主执行 Agent（进阶，自动化任务）
- 代表：Devin、Cursor Agent
- 核心能力：自动执行命令、启动本地服务、运行单元测试、分析报错、自主迭代修复
二、Java 研发 完整研发流程 + Agent 使用话术（直接照搬）
阶段 1：需求理解 & 需求拆解（通用 Agent）
场景：产品给 PRD、口头需求、简单文档
你给 Agent 的指令模板
你是资深Java后端研发，熟悉SpringBoot、MyBatis、MySQL、Redis、微服务。
请阅读我提供的需求文档：
【粘贴PRD/需求描述】
完成以下工作：
1. 拆解业务模块、核心功能、边界场景、异常场景
2. 输出数据库表设计（字段、类型、索引、备注）
3. 定义RESTful接口清单（请求方式、路径、入参、出参）
4. 标记需要考虑的分布式/并发/安全风险点
阶段 2：架构 & 方案设计（通用 Agent + 代码 Agent）
适合：新增功能、改造旧代码、接入第三方（支付、OSS、消息队列）
指令模板：
基于上面拆解的需求，结合我司技术栈：SpringBoot3 + Mysql8 + Redis + MQ
请输出：
1. 整体代码分层架构（controller/service/domain/mapper/dto）
2. 核心业务流程时序描述
3. 技术方案选型、优缺点对比
4. 可复用工具类、常量、枚举设计建议
阶段 3：编码开发（核心！代码 Agent 主战场）
3.1 单文件快速开发（接口、Service、实体类）
直接在 IDE 内唤醒 Agent（Claude Code/Copilot），指令：
根据如下接口定义，编写完整Java代码：
1. 使用SpringBoot标准分层
2. 加入参数校验、全局异常捕获
3. 增加注释、日志打印
4. 补充基础单元测试
【粘贴接口/字段要求】
3.2 多文件联动开发（复杂业务）
关键：让 Agent读取整个项目上下文，避免代码风格割裂
读取当前项目代码规范、包结构、统一返回结果类Result、分页工具类。
一次性完成以下开发：
1. 新增数据库实体、Mapper、XML
2. 新增DTO/VO转换
3. 编写Service业务逻辑（包含事务、幂等性处理）
4. 编写Controller接口
5. 处理入参校验、枚举统一管理
3.3 老项目迭代 / 改 Bug
分析当前代码问题，结合业务场景：
1. 定位Bug根因
2. 给出最小改动修复方案
3. 修复后保证原有逻辑不受影响
4. 增加边界条件判断，防止重复踩坑
阶段 4：联调、自测、优化
生成 Postman/OpenAPI 接口文档
根据当前所有Controller接口，自动生成OpenAPI规范文档，输出结构化请求示例、错误码说明
SQL 优化、索引优化
分析这条MySQL慢SQL，优化执行计划，推荐合适索引，避免全表扫描、锁等待问题
代码评审 & 规范整改
帮我做一次代码评审，检查：魔法值、未关闭流、事务失效、线程安全、Redis缓存穿透问题，并给出整改后代码
三、Java 开发者必用：Agent 专属约束（避免垃圾代码）
每次使用前加这段全局约束，统一代码质量：
强制约束：
1. 严格遵循Java阿里开发手册
2. 禁止魔法值，统一使用常量/枚举
3. 业务方法必须加事务注解，复杂场景给出手动事务方案
4. 所有外部入参非空、长度、格式校验
5. 关键节点打印info日志，异常捕获打印error堆栈
6. 命名规范，注释清晰，适配Lombok
四、入门落地路线（0 基础快速上手，1 天就能用起来）
- 第一步：IDE 安装插件
- IDEA：安装
Claude Code/GitHub Copilot/CodeGeeX
- IDEA：安装
- 第二步：固定提示词
- 保存上面的「Java 全局约束 + 需求拆解模板」，每次对话开头直接粘贴
- 第三步：从小需求练手
- 先做：简单 CRUD、新增接口、字典管理、定时任务
- 第四步：进阶复杂场景
- 分布式锁、消息队列异步、定时任务、第三方接口对接
结合你的情况：IDEA + SpringBoot2 单体架构 + CRUD / 中间件 / 架构都做，给你一套开箱即用、直接复制的 AI Agent 完整工作流 + 专属固定提示词，立刻就能落地提升研发效率。
二、AI Agent 完整工作流 + 专属固定提示词
一、你最优 AI 工具组合（适配你的环境）
-
1、IDE 内主力（写代码、改 bug、多文件联动）IDEA 插件：Claude Code + CodeGeeX
适配 SpringBoot2 旧版本语法
读懂你整个单体项目包结构、全局统一返回、异常处理、工具类
多文件批量生成：Entity、Mapper、Service、Controller、DTO
-
2、需求拆解、架构设计、方案选型
网页端：Kimi / Claude 3.5
读长文档、拆解 PRD、画业务流程、设计表结构、中间件方案对比（Redis/MQ/ 定时任务等）
二、专属固定全局人设提示词（每次 Agent 对话开头直接粘）
适配：SpringBoot2 + 单体 + 阿里 Java 规范 + 兼顾 CRUD & 架构 & 中间件
你是资深Java后端开发，专注SpringBoot2.x单体项目开发，严格遵守阿里巴巴Java开发手册。
项目环境：SpringBoot2 + MySQL8 + Redis + Maven，单体架构。
编码强制要求：
1. 分层规范：Controller / Service / Mapper / Entity / DTO / VO / util 严格区分
2. 入参必做：非空校验、长度校验、格式校验，使用JSR303
3. 异常处理：全局统一异常捕获，不裸抛异常，业务异常自定义枚举错误码
4. 事务：核心业务方法加@Transactional，查询方法不加事务
5. 日志：关键业务节点打印info日志，异常打印error完整堆栈
6. 禁止魔法值，状态、类型统一用枚举/常量类
7. 代码必须带完整注释、可读性强，可直接投入生产使用
8. 涉及Redis、定时任务、MQ、文件、第三方接口时，提供健壮方案+异常处理
三、完整研发全流程 Agent 指令（直接复制使用）
1、需求阶段｜PRD 转设计
根据以下需求，基于SpringBoot2单体架构，帮我完成：
1. 业务功能拆解、核心流程、边界异常场景
2. MySQL表结构设计（字段、类型、注释、索引、主键）
3. 完整RESTful接口清单（请求方式、路径、入参、出参）
4. 指出需要注意的技术点：缓存、定时任务、数据唯一性、并发问题
需求内容：
【这里粘贴你的需求】
2、建表 & 基础 CRUD 一键生成
根据下面表结构，基于我当前SpringBoot2项目规范，一次性生成全套代码：
Entity实体类、Mapper接口、MapperXML、Service接口&实现类、Controller、DTO、VO
包含：新增、修改、删除、分页查询、详情查询完整CRUD，参数校验+日志+基础异常处理
表结构：
【粘贴建表语句/字段】
3、复杂业务 / 中间件开发（Redis / 定时任务 / 异步）
帮我实现以下功能，适配SpringBoot2单体项目：
1. 给出完整实现思路和架构说明
2. 完整可运行代码，包含配置类、工具类、业务代码
3. 增加异常捕获、降级处理、参数容错
4. 说明使用注意事项、坑点、优化建议
功能需求：
【例如：Redis缓存字典、定时任务定时清理数据、异步通知等】
4、代码优化 / 重构 / 代码评审
帮我评审并优化这段SpringBoot2代码：
1. 找出代码隐患：事务失效、空指针、并发问题、资源未释放、SQL隐患
2. 简化冗余代码、统一规范、替换魔法值
3. 给出优化后完整可直接替换的代码
4. 标注修改点和优化理由
代码如下：
【粘贴代码】
5、Bug 排查 & 报错解决
我这边SpringBoot2单体项目出现以下报错，帮我：
1. 分析报错根本原因
2. 给出低成本最小改动修复方案
3. 提供修复后完整代码
4. 给出后续规避方案
报错信息+业务场景：
【粘贴异常堆栈+场景】
四、IDEA 内实操极简使用方法
安装插件：Claude Code、CodeGeeX 并登录
打开项目，选中任意代码文件，让 AI读取项目整体结构
每次提问先粘贴上面【全局人设提示词】
按需复制上面对应场景指令，直接开发
三、IDEA AI Agent 最终版全套提示词
全局固定前缀（每次对话第一句）
你现在是资深Java后端工程师，适配 SpringBoot2.x 单体项目，技术栈：SpringBoot2 + Maven + MySQL + Redis。
严格遵循阿里巴巴Java开发规范，代码必须可直接用于生产。
编码要求：
1. 分层清晰：Controller、Service、Mapper、Entity、DTO、VO、util
2. 入参使用JSR303校验，非空、长度、格式校验齐全
3. 统一使用全局异常处理，自定义业务异常，错误码清晰
4. 写业务方法增加日志，关键节点info，异常打印完整堆栈
5. 增删改核心业务添加事务，rollbackFor = Exception.class
6. 禁止魔法值，固定状态使用枚举/常量
7. 代码完整、带注释、具备健壮性，包含异常捕获与容错
8. 涉及Redis、定时任务、第三方接口，必须增加失败降级处理
场景 1：根据需求生成表 + 全套 CRUD
基于以下需求，先设计MySQL表结构，包含字段、注释、索引。
再完整生成：Entity、Mapper、MapperXML、Service、Controller、DTO、VO，
实现新增、编辑、删除、分页列表、详情接口，
结合我SpringBoot2单体项目，参数校验+日志+异常处理+事务。
需求：
场景 2：中间件 / 复杂功能开发
基于SpringBoot2单体，帮我实现该功能，提供：
1. 配置类
2. 工具类/核心业务代码
3. 使用示例
4. 异常捕获、重试、降级方案
5. 说明注意事项与线上坑点
功能：
场景 3：代码优化 & 代码评审
帮我审查下面这段SpringBoot2代码，找出：空指针、事务问题、并发隐患、SQL问题、资源未释放、不规范写法。
给出优化后的完整可替换代码，并逐条说明优化点。
代码：
Java + AI Agent 高效研发日常流程
- 产品给需求 → 粘贴需求 + 全局提示词 → AI 输出表设计 + 接口清单
- 确认表结构 → AI 一键生成全套 CRUD
- 复杂逻辑 / 缓存 / 定时 → 专用提示词生成健壮代码
- 写完直接 AI 代码评审、优化、补日志、补异常
- 报错直接贴堆栈，AI 定位根因 + 最小修复方案
