process-module-architecture
Provides deep-dive architectural insights into the BK-CI Process module, covering pipeline execution, state management, and events.
Install
mkdir -p .claude/skills/process-module-architecture && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/2687" && unzip -o skill.zip -d .claude/skills/process-module-architecture && rm skill.zipInstalls to .claude/skills/process-module-architecture
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
处理 BK-CI Process 流水线核心模块时使用，例如流水线 CRUD、构建启动、运行时状态、引擎控制、事件驱动和数据库持久化。当用户要改流水线主链路而不是外围支撑模块时优先使用。Key capabilities
- →Modify pipeline creation, update, deletion, and version management
- →Handle build initiation, runtime status, and execution progression
- →Modify engine control, event-driven, or database persistence logic
- →Troubleshoot core behaviors in the pipeline's main process
How it works
This skill guides users through the core architecture of the BK-CI Process module, detailing how pipelines are saved, triggered, advanced, and terminated across different layers.
Inputs & outputs
When to use process-module-architecture
- →Understanding the pipeline lifecycle, from creation to execution
- →Debugging issues in pipeline state transitions
- →Developing core features within the Process module
About this skill
Process 模块架构
适用场景
- 修改流水线创建、更新、删除和版本管理
- 处理构建启动、运行时状态和执行推进
- 修改引擎 Control、事件驱动或数据库持久化逻辑
- 排查流水线主链路中的核心行为
不适用场景
- 只是修改模板、YAML 转换或插件定义
- 只是修改调度、Agent、Worker 执行器
- 只是修改权限平台或支撑模块
- 只是修改某个外围服务的集成点
快速指导
- 这个 skill 关注的是“流水线主链路如何被保存、触发、推进和结束”。
- Process 是 BK-CI 的核心编排模块，读它时先分成入口层、服务层、引擎层、数据层。
- 主入口只做模块路由，深入时直接进入现有参考文档：
- API 层：
reference/1-api-layer.md - Service 层：
reference/2-service-layer.md - 引擎控制：
reference/3-engine-control.md - DAO 与数据库：
reference/4-dao-database.md - 事件驱动：
reference/5-event-driven.md
- API 层：
- 如果你改的是模型结构本身，联动看
pipeline-model-architecture。 - 如果你改的是模板或 YAML 输入输出，联动看
pipeline-template-module或yaml-pipeline-transfer。 - 如果你改的是执行资源派发或构建机侧执行，切到
dispatch-module-architecture、agent-module-architecture、worker-module-architecture。
高信号规则
- Process 的核心不是单个接口，而是“流水线数据 + 运行时状态 + 推进控制”的组合
- CRUD、构建启动、控制器、事件、持久化必须按一条主链去理解
- 主链路改动往往会联动权限、模型、模板、调度和日志
- 排查问题时先分清是定义期问题还是运行期问题
关键陷阱
- 只看某个 Resource 或 Service，不看整条主链
- 把模型问题、执行问题、事件问题混在一起
- 改了运行时状态流转，但没同步事件或持久化
- 把外围集成点的问题误判成 Process 内核问题
延伸阅读
- API 层：
reference/1-api-layer.md - Service 层：
reference/2-service-layer.md - 引擎控制：
reference/3-engine-control.md - DAO 与数据库：
reference/4-dao-database.md - 事件驱动：
reference/5-event-driven.md - 如果你在改流水线模型：再看
pipeline-model-architecture
When not to use it
- →Modifying only templates, YAML conversion, or plugin definitions
- →Modifying only scheduler, Agent, or Worker executors
- →Modifying only permission platforms or supporting modules
Limitations
- →This skill does not apply to modifying templates, YAML conversion, or plugin definitions.
- →This skill does not apply to modifying scheduler, Agent, or Worker executors.
- →This skill does not apply to modifying permission platforms or supporting modules.
How it compares
This skill focuses on the internal architecture of the BK-CI Process module's main pipeline flow, providing specific guidance for core modifications, unlike general development tasks.
Compared to similar skills
process-module-architecture side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| process-module-architecture (this skill) | 2 | 3mo | No flags | Advanced |
| workflow-orchestration-patterns | 10 | 2mo | No flags | Advanced |
| java-pro | 34 | 4mo | No flags | Advanced |
| springboot-patterns | 11 | 5mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by TencentBlueKing
View all by TencentBlueKing →You might also like
workflow-orchestration-patterns
wshobson
Design durable workflows with Temporal for distributed systems. Covers workflow vs activity separation, saga patterns, state management, and determinism constraints. Use when building long-running processes, distributed transactions, or microservice orchestration.
java-pro
sickn33
Master Java 21+ with modern features like virtual threads, pattern matching, and Spring Boot 3.x. Expert in the latest Java ecosystem including GraalVM, Project Loom, and cloud-native patterns. Use PROACTIVELY for Java development, microservices architecture, or performance optimization.
springboot-patterns
affaan-m
Spring Boot 架构模式、REST API 设计、分层服务、数据访问、缓存、异步处理和日志记录。适用于 Java Spring Boot 后端工作。
unit-testing
TencentBlueKing
单元测试编写指南，涵盖 JUnit5/MockK 使用、测试命名规范、Mock 技巧、测试覆盖率要求、TDD 实践。当用户编写单元测试、Mock 依赖、提高测试覆盖率或进行测试驱动开发时使用。
backend-microservice-development
TencentBlueKing
后端微服务开发规范，涵盖目录结构、分层架构（API/Service/DAO）、依赖注入、配置管理、Spring Boot 最佳实践。当用户进行后端开发、创建新微服务、编写 Kotlin/Java 代码或设计服务架构时使用。
microservice-infrastructure
TencentBlueKing
微服务基础设施指南，涵盖条件配置、事件驱动架构、服务间通信、国际化与日志等微服务架构的核心基础设施。当用户实现服务间调用、配置多环境、实现异步通信、处理国际化或规范日志输出时使用。