Store Module Architecture
Developmentstore-module-architectureStore Module Architecture is an Agent Skill for development published in the TencentBlueKing/bk-ci repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
处理 BK-CI 研发商店中的插件、模板、镜像等组件发布、审核、安装、统计和扩展点机制时使用。当用户提到商店组件上架、插件发布、模板分发、安装升级或市场能力时优先使用。
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/TencentBlueKing/bk-ci/blob/HEAD/ai/skills/store-module-architecture/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/store-module-architecture, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Store 模块架构
适用场景
- 发布或管理插件、模板、镜像等商店组件
- 处理审核、上架、下架、安装和升级
- 理解商店中的组件类型、状态流转和统计逻辑
- 处理商店扩展点、分类标签、成员和评论等能力
不适用场景
- 只是单个插件执行逻辑,不涉及商店生命周期
- 只是模板模块内部逻辑,不涉及商店分发
- 只是镜像运行或制品归档,不涉及商店管理
快速指导
- 先判断问题属于哪条主线:
- 商店基础与组件类型:看
reference/1-store-foundation.md - 发布、安装、审核与扩展:看
reference/2-release-install-extension.md
- 商店基础与组件类型:看
Store的重点不是组件“怎么执行”,而是组件“怎么进入市场、被审核、被安装和被统计”。- 插件、模板、镜像三类组件共享商店心智,但生命周期细节不同,不要强行一套处理。
- 如果问题已经落到模板实例或插件执行本身,接下来切到对应模块 skill。
高信号规则
Store负责组件生命周期与分发,不负责具体执行引擎- 组件状态流转通常比单次业务动作更关键
- 商店能力常常叠加分类、标签、成员、评论、统计和审核
- 安装和升级问题要同时看来源组件版本与目标项目落地状态
关键陷阱
- 把插件、模板、镜像完全当成同一种组件处理
- 只看发布流程,不看审核和下架回收链路
- 商店安装成功就默认目标项目已经完全可用
- 只排查组件元数据,不排查安装后的资源同步
延伸阅读
- 商店基础:
reference/1-store-foundation.md - 发布与安装:
reference/2-release-install-extension.md - 涉及模板分发时:再看
pipeline-template-module - 涉及插件执行时:再看
pipeline-plugin-development