使用Claude Code Agent 开发独立业务功能,文档代码全搞定

文章目录前言业务需求编码准备规范项目标准和限制Agent提示词实战演示创建CLAUDE.mdAgent生成PRD和TSDAgent自动编码Agent生成单元测试及其mdAgent运行单元测试总结前言当下很多同学都在使用claude code实现自己的需求有的用来整理文档有的用来搜索知识库有的用来实现自己的小工具。今天我们就分享一期用claude code开发一个业务功能小试牛刀。在本文中我们会从初始化CLAUDE.md到项目文档编写再到代码生成最后到单元测试完成整个流程希望对你有所帮助与启发。业务需求1、腾讯广告上报业务服务端需要记录用户的clickId,需要提供一个新增用户clickId接口一个查询用户最新clickId接口2、业务数据包含unionid、type、clickIdstatus用作备用字段3、用户unionid可以从token中获取4、从表结构设计、do、mapper、service、controller都需要独立开发并提供接口文档编码准备为保证项目不受agent污染我们手动拉取新的分支并要求agent不得随意修改之前的业务代码不得提交GIT。规范项目标准和限制首先我们在目标项目目录初始化CLAUDE.md并设置项目规范1、项目从表结构设计、do、mapper、service、controller、test case以及接口文档都必须满足已有项目规范2、由于你是独立的功能模块不能私自修改其他业务代码禁止提交GIT命令3、业务功能创建完成后必须单元测试通过并形成接口md接口文档规范使用标准规范即可Agent提示词验证按照当前项目规范完成一个独立功能开发你需要先输出PRD\TSD\TEST CASE等文档的md,得到我的确认后才能开始编码。我的需求是1、记录用户的clickId,需要提供一个新增用户clickId接口一个查询用户最新clickId接口业务数据包含unionid、type、clickIdstatus用作备用字段2、用户unionid可以从token中获取你可参考其他页面怎么限制接口必须传入token的怎么从request获取token的3、从表结构设计、do、mapper、service、controller都需要独立开发与其他功能风格一致并提供接口文档md以及sql语句md4、当前功能产生的md用单独的目录统一起来并使用业务命名实战演示创建CLAUDE.md在目标文件夹下我们调出claude code cli输入命令初始化项目规范命令/init 1、项目从表结构设计、do、mapper、service、controller、test case以及接口文档都必须满足已有项目规范2、由于你是独立的功能模块不能私自修改其他业务代码禁止提交GIT命令3、业务功能创建完成后必须单元测试通过并形成接口md接口文档规范使用标准规范即可如下图所示agent会将我们的指令发给大模型大模型会要求扫描项目并整理输出规范agent会将规范写入CLAUDE.md我们可以看到agent已经帮我们生成了CLAUDE.mdAgent生成PRD和TSD由于我们刚刚生成了CLAUDE.md我们可以clear清理一下上下文减少token使用量我们切换到 plan mode 让给agent先生成计划以及prd然后再执行命令验证按照当前项目规范完成一个独立功能开发你需要先输出PRD\TSD\TEST CASE等文档的md,得到我的确认后才能开始编码。我的需求是1、记录用户的clickId,需要提供一个新增用户clickId接口一个查询用户最新clickId接口业务数据包含unionid、type、clickIdstatus用作备用字段2、用户unionid可以从token中获取你可参考其他页面怎么限制接口必须传入token的怎么从request获取token的3、从表结构设计、do、mapper、service、controller都需要独立开发与其他功能风格一致并提供接口文档md以及sql语句md4、当前功能产生的md用单独的目录统一起来并使用业务命名Agent会去扫描代码来为后续的工作做准备几分钟后agent了解完毕开始创建我们要求的文档几分钟后agent文档已经全部创建好了他询问我们是否继续编码这里我们可以先去文件夹看看效果如何再进行定夺我觉得还不错Agent自动编码上面我们已经让claude agent帮助生成了各种项目文档并且等待我们确认是否继续执行编码。看了上面五个文档我觉得 YYDS可以开始编码了所以我们选择1即可选择后agent会先清理上下文然后开始根据我们的设计文档进行编码几分钟后agent编码完成请求执行编译命令验证是否异常这里我们允许执行即可但是自动编译失败但是agent提示已经编码完成我们查看代码确实已经编码完成可能由于依赖关系他不能启动我们暂时不管他。Agent生成单元测试及其md我发现没有单元测试呢我们刚刚也没有要求他生成所以我们先让他生成单元测试。直接命令我发现生成的功能并没有单元测试呢增加单元测试不多时agent帮我生成了测试单元测试代码由于我比较懒我让他继续生产单元测试md还不错一会就生成好了Agent运行单元测试但是我发现生成的单元测试爆红呢很多依赖都没有肯定agent没有运行过我让agent运行单元测试。命令运行单元测试发现问题agent说找不到项目依赖因为我们idea单独配置了maven 本地库地址那我们显示让agent去我们的本地库找吧命令项目的maven配置在D:\maven.m2,使用这个你应该可以找到本地库然后我们允许他执行即可哈哈这下编译的时候发现了自己写的测试用例依赖不够我们允许他操作检查依赖配置然后发现父项目没有就在自己的pom中加我发现他增加了一个mvn依赖cn.cce.boot cce-spring-boot-starter-test test好吧我们继续允许他二次测试经过了九九 3m27s完成了单元测试okay,算你厉害为了保证代码质量用IDEAE运行测试用例再次检查15个用例全部通过总结经过对这个业务功能的编码我们应该可以体会到claude code agent对于我们开发的助力是非常大的不仅仅可以生成比较完善的项目开发文档对代码质量的把控和效率也是比较高的。但是值得注意的是agent以及大模型的好用程度以及对项目有多大的助力取决于开发者的提示词。所谓差之毫厘谬以千里这句话在AI领略可谓真谛也