关于 backend-microservice-development
面向 BK-CI Kotlin / Java 后端开发的技能,帮助判断功能归属服务并按分层约定组织代码。重点是服务边界与层次划分,而非 Spring Boot 入门。
主要功能
- 01判断功能的服务归属
- 02组织 API、业务、启动和数据层
- 03明确 Resource、Service、DAO 边界
- 04通过 API 契约进行服务间交互
适用场景
- 01新增或修改 Kotlin / Java 后端功能
- 02规划 Resource、Service 或 DAO 的代码位置
- 03评估功能应放入哪个微服务
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ tencentblueking/ bk-ci --skill backend-microservice-development安装后在 Claude Code 中输入/backend-microservice-development确认已加载。
详细介绍
来自项目 README后端微服务开发
适用场景
- 新增或修改 Kotlin / Java 后端功能
- 新增 Resource、Service、DAO 或微服务模块
- 判断功能应该落到哪个服务
- 按项目分层约定组织代码
不适用场景
- 前端 Vue 页面开发
- Go Agent 开发
- 单纯设计 API 契约或数据库模型
快速指导
- 这个 skill 关注的是“BK-CI 后端功能如何组织和落位”,不是单纯 Spring Boot 入门。
- 开发前先做服务归属判断,再决定接口、服务和数据层放哪。
- 核心分层仍然是 API、业务实现、启动模块和数据模型,不要跨层乱放逻辑。
- 服务间交互走 API 契约,不直接碰别的服务数据库。
- 如果问题是接口设计细节,联动看
api-interface-design;如果是测试,联动看unit-testing。
高信号规则
- 功能落位比代码实现本身更容易决定后续维护成本
- Resource、Service、DAO 的边界清楚,后续扩展才稳定
- 微服务之间只共享契约,不共享存储实现
关键陷阱
- 为了快,直接把逻辑塞进 Resource
- 服务归属判断错误,导致后续跨服务耦合
- 因为调用方便而直接访问其他服务数据
延伸阅读
- 如果你在设计接口:再看
api-interface-design - 如果你在写测试:再看
unit-testing - 如果你在看基础设施:再看
microservice-infrastructure - 如果你在看 Spring Boot 框架实践:再看
springboot-backend-conventions
评论
支持 Markdown