Agent-Skills.md

Agent Skills: Store 模块架构

Store 研发商店模块架构指南，涵盖插件/模板/镜像管理、版本发布、审核流程、商店市场、扩展点机制。当用户开发研发商店功能、发布插件、管理模板或实现扩展点时使用。

UncategorizedID: tencentblueking/bk-ci/store-module-architecture

Repository

tencentblueking/bk-ci
TencentBlueKingLicense: NOASSERTION
2,498520

Install this agent skill to your local

pnpm dlx add-skill https://github.com/TencentBlueKing/bk-ci/tree/HEAD/ai/skills/store-module-architecture

Skill Files

Browse the full folder contents for store-module-architecture.

Download Skill

Loading file tree…

ai/skills/store-module-architecture/SKILL.md

Skill Metadata

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

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