Skip to content
CI/CD
Skill

/backend-microservice-development

编写 BK-CI 后端微服务代码时使用,例如新增 Resource、组织 API/Service/DAO 分层、依赖注入、服务归属判断和 Spring Boot 开发约定。当用户要做 Kotlin/Java 后端开发时优先使用。

BOOST
From plugin
bk-ci
2.5k42 skills
Install
$ npx -y skills add tencentblueking/bk-ci --skill backend-microservice-development --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/backend-microservice-development

Context preview

The summary Claude sees to decide when to auto-load this skill.

编写 BK-CI 后端微服务代码时使用,例如新增 Resource、组织 API/Service/DAO 分层、依赖注入、服务归属判断和 Spring Boot 开发约定。当用户要做 Kotlin/Java 后端开发时优先使用。

SKILL.md

backend-microservice-development.SKILL.md
name: backend-microservice-development
description: 编写 BK-CI 后端微服务代码时使用,例如新增 Resource、组织 API/Service/DAO 分层、依赖注入、服务归属判断和 Spring Boot 开发约定。当用户要做 Kotlin/Java 后端开发时优先使用。

后端微服务开发

适用场景

  • 新增或修改 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`
Ships withbk-ci

蓝鲸持续集成平台(蓝盾)

Get the whole plugin

Other skills on bk-ci.

00-bkci-global-architecture
Skill

00-bkci-global-archite…

用于跨模块开发、排查链路归属、判断某个需求应该落在哪个 BK-CI 模块,或需要快速理解流水线全链路协作时使用。单模块修改时优先读取对应模块 skill,而不是停留在这里。

agent-module-architecture
Skill

agent-module-architect…

处理 BK-CI Agent 构建机侧能力时使用,例如守护进程、心跳、Ask 轮询、任务拉起、升级更新和与 Dispatch/Worker 的协作。当用户要改构建机宿主侧行为而不是…

api-interface-design
Skill

api-interface-design

设计 BK-CI API 契约时使用,例如 Resource 路径设计、HTTP 方法选择、请求响应对象、错误码和版本策略。当用户要定义接口而不是实现业务逻辑时优先使用。

auth-module-architecture
Skill

auth-module-architectu…

处理 BK-CI Auth 模块时使用,例如 RBAC 权限校验、用户组与资源管理、IAM 集成、授权迁移和 OAuth2 认证。当用户要改权限平台实现而不是单次权限模型变更时优先使用。

business-knowledge-workflow
Skill

business-knowledge-wor…

获取陌生业务知识并沉淀为 BK-CI skill 或架构文档时使用,例如阅读 iWiki、结合代码交叉验证、提炼模块边界和重写知识文档。当用户要先理解业务再写文档时优先使用。