Skip to main content
Mobile DevelopmentTencentBlueKing

store-module-architecture

处理 BK-CI 研发商店中的插件、模板、镜像等组件发布、审核、安装、统计和扩展点机制时使用。当用户提到商店组件上架、插件发布、模板分发、安装升级或市场能力时优先使用。

Stars
2,499
Source
TencentBlueKing/bk-ci
Updated
2026-05-28
Slug
TencentBlueKing--bk-ci--store-module-architecture
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/TencentBlueKing/bk-ci/HEAD/ai/skills/store-module-architecture/SKILL.md -o .claude/skills/store-module-architecture.md

Drops the SKILL.md into .claude/skills/store-module-architecture.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Store 模块架构

适用场景

  • 发布或管理插件、模板、镜像等商店组件
  • 处理审核、上架、下架、安装和升级
  • 理解商店中的组件类型、状态流转和统计逻辑
  • 处理商店扩展点、分类标签、成员和评论等能力

不适用场景

  • 只是单个插件执行逻辑,不涉及商店生命周期
  • 只是模板模块内部逻辑,不涉及商店分发
  • 只是镜像运行或制品归档,不涉及商店管理

快速指导

  1. 先判断问题属于哪条主线:
    • 商店基础与组件类型:看 reference/1-store-foundation.md
    • 发布、安装、审核与扩展:看 reference/2-release-install-extension.md
  2. Store 的重点不是组件“怎么执行”,而是组件“怎么进入市场、被审核、被安装和被统计”。
  3. 插件、模板、镜像三类组件共享商店心智,但生命周期细节不同,不要强行一套处理。
  4. 如果问题已经落到模板实例或插件执行本身,接下来切到对应模块 skill。

高信号规则

  • Store 负责组件生命周期与分发,不负责具体执行引擎
  • 组件状态流转通常比单次业务动作更关键
  • 商店能力常常叠加分类、标签、成员、评论、统计和审核
  • 安装和升级问题要同时看来源组件版本与目标项目落地状态

关键陷阱

  • 把插件、模板、镜像完全当成同一种组件处理
  • 只看发布流程,不看审核和下架回收链路
  • 商店安装成功就默认目标项目已经完全可用
  • 只排查组件元数据,不排查安装后的资源同步

延伸阅读

  • 商店基础:reference/1-store-foundation.md
  • 发布与安装:reference/2-release-install-extension.md
  • 涉及模板分发时:再看 pipeline-template-module
  • 涉及插件执行时:再看 pipeline-plugin-development