mcpField
B
backend-microservice-development

backend-microservice-development

github.com/tencentblueking开发2.5k63 次安装2 天前更新
代码仓库

关于 backend-microservice-development

面向 BK-CI Kotlin / Java 后端开发的技能,帮助判断功能归属服务并按分层约定组织代码。重点是服务边界与层次划分,而非 Spring Boot 入门。

主要功能

  1. 01判断功能的服务归属
  2. 02组织 API、业务、启动和数据层
  3. 03明确 Resource、Service、DAO 边界
  4. 04通过 API 契约进行服务间交互

适用场景

  1. 01新增或修改 Kotlin / Java 后端功能
  2. 02规划 Resource、Service 或 DAO 的代码位置
  3. 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 契约或数据库模型

快速指导

  1. 这个 skill 关注的是“BK-CI 后端功能如何组织和落位”,不是单纯 Spring Boot 入门。
  2. 开发前先做服务归属判断,再决定接口、服务和数据层放哪。
  3. 核心分层仍然是 API、业务实现、启动模块和数据模型,不要跨层乱放逻辑。
  4. 服务间交互走 API 契约,不直接碰别的服务数据库。
  5. 如果问题是接口设计细节,联动看 api-interface-design;如果是测试,联动看 unit-testing。

高信号规则

  • 功能落位比代码实现本身更容易决定后续维护成本
  • Resource、Service、DAO 的边界清楚,后续扩展才稳定
  • 微服务之间只共享契约,不共享存储实现

关键陷阱

  • 为了快,直接把逻辑塞进 Resource
  • 服务归属判断错误,导致后续跨服务耦合
  • 因为调用方便而直接访问其他服务数据

延伸阅读

  • 如果你在设计接口:再看 api-interface-design
  • 如果你在写测试:再看 unit-testing
  • 如果你在看基础设施:再看 microservice-infrastructure
  • 如果你在看 Spring Boot 框架实践:再看 springboot-backend-conventions

评论

支持 Markdown