00-bkci-global-architecture
This skill documents the global architecture of BK-CI to help developers identify the correct modules for task assignment.
Install
mkdir -p .claude/skills/00-bkci-global-architecture && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/4183" && unzip -o skill.zip -d .claude/skills/00-bkci-global-architecture && rm skill.zipInstalls to .claude/skills/00-bkci-global-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 模块，或需要快速理解流水线全链路协作时使用。单模块修改时优先读取对应模块 skill，而不是停留在这里。Key capabilities
- →Map cross-module feature requirements
- →Debug execution flow across system modules
- →Identify the correct module for new feature implementation
- →Navigate the pipeline execution lifecycle
- →Determine module boundaries for development
How it works
The skill provides a high-level navigation guide that maps the BK-CI system into five layers and defines the primary execution chain from trigger to worker.
Inputs & outputs
When to use 00-bkci-global-architecture
- →Map cross-module feature requirements
- →Debug execution flow issues
- →Identify the correct module for a new feature
- →Understand the build pipeline architecture
About this skill
BK-CI 全局架构指南
适用场景
- 需求横跨多个模块，暂时不清楚该从哪里下手
- 需要理解流水线从触发到执行结束的主链路
- 需要判断某段逻辑属于
Process、Dispatch、Agent、Worker还是其他模块 - 需要先选 skill，再深入具体实现
不适用场景
- 已经明确只改单个模块内部逻辑
- 只是前端页面、数据库脚本或某个工具函数的小改动
- 已经知道目标模块，只需要其局部规范
快速指导
- 先用五层视图建立系统位置感：
- 用户层：Web、OpenAPI、Webhook、第三方系统
- 网关层：OpenResty，负责路由、认证、限流、服务发现
- 微服务层：Project、Process、Auth、Repository、Store、Dispatch 等
- 构建机层：Agent 负责进程与调度，Worker 负责任务执行
- 资源层：MySQL、Redis、RabbitMQ、ES、文件存储
- 流水线主链路按这个顺序理解：
触发 -> Process 编排 -> Dispatch 分配 -> Agent 领取 -> Worker 执行 -> 状态回传 - 先按模块边界选 skill，再深入实现：
- 流水线模型、执行链路、状态机：
process-module-architecture - 权限、RBAC、IAM：
auth-module-architecture - 代码库、Webhook、PAC 接入：
repository-module-architecture - 商店、模板、插件发布：
store-module-architecture - 调度、构建资源、BuildLess：
dispatch-module-architecture - 构建机 Agent：
agent-module-architecture - Worker 执行器：
worker-module-architecture - 后端 API 分层规范：
backend-microservice-development - API 设计：
api-interface-design - 数据库设计：
database-design
- 流水线模型、执行链路、状态机：
- 快速判断问题归属：
- “谁来编排和推进流水线状态” ->
Process - “执行资源怎么分配、容器怎么起” ->
Dispatch - “构建机怎么常驻、怎么领任务、怎么升级” ->
Agent - “插件任务怎么执行、怎么回传日志和状态” ->
Worker - “接口该怎么分层、命名和落目录” ->
backend-microservice-development - “表怎么设计、脚本怎么管理、索引怎么建” ->
database-design
- “谁来编排和推进流水线状态” ->
高信号规则
- 这个 skill 的职责是导航和归属判断，不是详细设计手册
- 对单模块问题，越快切到对应 skill，整体上下文效率越高
- 全局系统图和公共主链路以本 skill 为权威来源，不在各模块重复展开
关键陷阱
- 不要把这个 skill 当成详细设计文档。它只负责导航和主链路判断。
- 不要在每个模块 skill 中重复一遍全局系统图，公共全景以本 skill 为准。
- 对单模块修改，尽快切到对应模块 skill，避免把上下文浪费在全局说明上。
延伸阅读
- 单模块开发前，直接打开目标模块的 skill
- 需要具体实现细节时，不再继续扩展本文件，而是把内容放回对应模块 skill 或
reference/
When not to use it
- →When modifying logic internal to a single module
- →For minor changes to frontend pages or database scripts
Limitations
- →Not a detailed design manual
- →Does not contain implementation-level code details
How it compares
It acts as a central architectural map to prevent developers from wasting time on global context when they should be focusing on specific module skills.
Compared to similar skills
00-bkci-global-architecture side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| 00-bkci-global-architecture (this skill) | 1 | 3mo | No flags | Advanced |
| monorepo-architect | 3 | 4mo | No flags | Advanced |
| worker-module-architecture | 3 | 3mo | No flags | Advanced |
| turborepo | 61 | 2mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by TencentBlueKing
View all by TencentBlueKing →You might also like
monorepo-architect
sickn33
Expert in monorepo architecture, build systems, and dependency management at scale. Masters Nx, Turborepo, Bazel, and Lerna for efficient multi-project development. Use PROACTIVELY for monorepo setup,
worker-module-architecture
TencentBlueKing
Worker 构建执行器模块架构指南，涵盖插件执行引擎、任务分发、日志上报、制品上传、Worker 生命周期。当用户开发 Worker 功能、实现插件执行、处理任务分发或优化执行器性能时使用。
turborepo
vercel
Turborepo monorepo build system guidance. Triggers on: turbo.json, task pipelines, dependsOn, caching, remote cache, the "turbo" CLI, --filter, --affected, CI optimization, environment variables, internal packages, monorepo structure/best practices, and boundaries. Use when user: configures tasks/workflows/pipelines, creates packages, sets up monorepo, shares code between apps, runs changed/affected packages, debugs cache, or has apps/packages directories.
bazel-build-optimization
wshobson
Optimize Bazel builds for large-scale monorepos. Use when configuring Bazel, implementing remote execution, or optimizing build performance for enterprise codebases.
ml-pipeline-workflow
wshobson
Build end-to-end MLOps pipelines from data preparation through model training, validation, and production deployment. Use when creating ML pipelines, implementing MLOps practices, or automating model training and deployment workflows.
nx-workspace-patterns
wshobson
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.