00 Bkci Global Architecture logo

00 Bkci Global Architecture

OrganizationPopular
TencentBlueKing
00-bkci-global-architecture

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

Overview

PublisherTencentBlueKing
Repositorybk-ci
Skill name00-bkci-global-architecture
Stars
2.5K
Forks
524
Bundled files
Instructions only
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • Self-contained

    Everything the model needs lives in the instructions — no extra files to sync.

  • Open source

    Published by TencentBlueKing on GitHub. Read the source before you install it.

Installation

Install the 00 Bkci Global Architecture AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/TencentBlueKing/bk-ci.git /tmp/bk-ci
mkdir -p .claude/skills
cp -r /tmp/bk-ci/ai/skills/00-bkci-global-architecture .claude/skills/00-bkci-global-architecture
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable 00 Bkci Global Architecture in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads 00 Bkci Global Architecture on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so 00 Bkci Global Architecture is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

BK-CI 全局架构指南

适用场景

  • 需求横跨多个模块,暂时不清楚该从哪里下手
  • 需要理解流水线从触发到执行结束的主链路
  • 需要判断某段逻辑属于 ProcessDispatchAgentWorker 还是其他模块
  • 需要先选 skill,再深入具体实现

不适用场景

  • 已经明确只改单个模块内部逻辑
  • 只是前端页面、数据库脚本或某个工具函数的小改动
  • 已经知道目标模块,只需要其局部规范

快速指导

  1. 先用五层视图建立系统位置感:
    • 用户层:Web、OpenAPI、Webhook、第三方系统
    • 网关层:OpenResty,负责路由、认证、限流、服务发现
    • 微服务层:Project、Process、Auth、Repository、Store、Dispatch 等
    • 构建机层:Agent 负责进程与调度,Worker 负责任务执行
    • 资源层:MySQL、Redis、RabbitMQ、ES、文件存储
  2. 流水线主链路按这个顺序理解:触发 -> Process 编排 -> Dispatch 分配 -> Agent 领取 -> Worker 执行 -> 状态回传
  3. 先按模块边界选 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
  4. 快速判断问题归属:
    • “谁来编排和推进流水线状态” -> Process
    • “执行资源怎么分配、容器怎么起” -> Dispatch
    • “构建机怎么常驻、怎么领任务、怎么升级” -> Agent
    • “插件任务怎么执行、怎么回传日志和状态” -> Worker
    • “接口该怎么分层、命名和落目录” -> backend-microservice-development
    • “表怎么设计、脚本怎么管理、索引怎么建” -> database-design

高信号规则

  • 这个 skill 的职责是导航和归属判断,不是详细设计手册
  • 对单模块问题,越快切到对应 skill,整体上下文效率越高
  • 全局系统图和公共主链路以本 skill 为权威来源,不在各模块重复展开

关键陷阱

  • 不要把这个 skill 当成详细设计文档。它只负责导航和主链路判断。
  • 不要在每个模块 skill 中重复一遍全局系统图,公共全景以本 skill 为准。
  • 对单模块修改,尽快切到对应模块 skill,避免把上下文浪费在全局说明上。

延伸阅读

  • 单模块开发前,直接打开目标模块的 skill
  • 需要具体实现细节时,不再继续扩展本文件,而是把内容放回对应模块 skill 或 reference/

Frequently asked questions

What does the 00 Bkci Global Architecture AI skill do?

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

Why use 00 Bkci Global Architecture on TypingMind?

Because you install it once and use it with any model. 00 Bkci Global Architecture is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install 00 Bkci Global Architecture in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/TencentBlueKing/bk-ci/tree/master/ai/skills/00-bkci-global-architecture. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use 00 Bkci Global Architecture?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with 00 Bkci Global Architecture?

As many as you like. As long as a model supports skills, you can use 00 Bkci Global Architecture with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the 00 Bkci Global Architecture AI skill free?

It is published on GitHub by TencentBlueKing. Check the repository for licensing terms. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇