RE

repository-module-architecture

Guides repository management tasks including webhook setup, SCM authentication, and module integration.

Install

mkdir -p .claude/skills/repository-module-architecture && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/3483" && unzip -o skill.zip -d .claude/skills/repository-module-architecture && rm skill.zip

Installs to .claude/skills/repository-module-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 代码库接入、代码库授权、Webhook、SCM 集成、PAC 开关与仓库类型差异时使用。当用户提到 Git/SVN/GitHub/TGit、Webhook、仓库认证、PAC 代码库或提交记录时优先使用。
110 charsno explicit “when” trigger
Intermediate

Key capabilities

  • Manage code repository access
  • Configure Webhook delivery
  • Handle repository authentication
  • Manage PAC (Pipeline as Code) switches

How it works

It acts as a central management layer for repository resources, handling the specific authentication, webhook, and integration semantics for different SCM types.

Inputs & outputs

You give it
Repository integration or configuration request
You get back
Repository management and configuration guidance

When to use repository-module-architecture

  • Configuring repository Webhooks
  • Setting up code repository authentication
  • Integrating SCM with BK-CI

About this skill

Repository 模块架构

适用场景

  • 接入或管理代码库
  • 处理仓库认证、OAuth、SSH、Token
  • 配置或排查 Webhook
  • 处理 PAC 代码库与提交记录
  • 判断某种代码库类型应该落在哪套服务实现

不适用场景

  • 只是普通 Git 命令使用问题
  • 只是 PAC 的 YAML 转换问题,不涉及代码库接入
  • 只是权限模型定义,不涉及仓库资源本身

快速指导

  1. 先判断问题属于哪条主线:
    • 仓库基础与类型差异:看 reference/1-repository-foundation.md
    • Webhook、PAC、认证与排查:看 reference/2-webhook-pac-auth.md
  2. Repository 模块的核心不是“执行 Git 操作”,而是“管理仓库资源、认证方式、Webhook 和平台接入语义”。
  3. 只要改仓库类型、认证逻辑或 PAC 开关,就要同时看仓库明细表、认证方式和 Webhook 行为。
  4. PAC 问题如果已经进入 YAML 解析或模板展开层,接下来切到 yaml-pipeline-transfer

高信号规则

  • Repository 负责仓库资源接入与管理,不负责流水线模型本身
  • 不同仓库类型在认证、字段和 API 能力上都不完全一致
  • PROJECT_ID 仍然要按项目英文标识理解
  • PAC 是仓库侧开关和上下文来源,不等于 YAML 转换实现本身

关键陷阱

  • 把代码库类型差异当成一套统一逻辑硬处理
  • 只看主表,不看各仓库类型的明细表
  • 把 Webhook 问题误判为仓库保存问题,或反过来
  • PAC 开关开了就默认一切 YAML / 触发都能工作

延伸阅读

  • 仓库基础:reference/1-repository-foundation.md
  • Webhook 与 PAC:reference/2-webhook-pac-auth.md
  • 涉及 YAML/PAC 转换时:再看 yaml-pipeline-transfer
  • 涉及项目语义时:再看 project-module-architecture

When not to use it

  • General Git command troubleshooting
  • YAML pipeline conversion logic

Limitations

  • Requires understanding of specific repository type differences
  • Does not handle pipeline model logic

How it compares

It focuses on the platform-level management of repository resources rather than the execution of individual Git commands.

Compared to similar skills

repository-module-architecture side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
repository-module-architecture (this skill)13moNo flagsIntermediate
glab63moReviewIntermediate
azure-devops-cli45moReviewBeginner
gitlab-ci-patterns103moNo flagsIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

More by TencentBlueKing

View all by TencentBlueKing

project-module-architecture

TencentBlueKing

Project 项目管理模块架构指南,涵盖项目 CRUD、成员管理、项目配置、标签管理、项目迁移。当用户开发项目管理功能、处理项目成员、配置项目属性或实现项目相关逻辑时使用。

612

artifactory-module-architecture

TencentBlueKing

Artifactory 制品库模块架构指南,涵盖制品上传下载、存储后端适配、制品元数据、清理策略、权限控制。当用户开发制品库功能、处理制品存储、配置清理策略或实现制品管理时使用。

419

microservice-infrastructure

TencentBlueKing

微服务基础设施指南,涵盖条件配置、事件驱动架构、服务间通信、国际化与日志等微服务架构的核心基础设施。当用户实现服务间调用、配置多环境、实现异步通信、处理国际化或规范日志输出时使用。

411

frontend-vue-development

TencentBlueKing

前端 Vue 开发规范,涵盖 Vue 2/3 组件开发、Vuex 状态管理、路由配置、组件通信、样式规范、国际化。当用户进行前端开发、编写 Vue 组件、处理状态管理或实现页面交互时使用。

38

unit-testing

TencentBlueKing

单元测试编写指南,涵盖 JUnit5/MockK 使用、测试命名规范、Mock 技巧、测试覆盖率要求、TDD 实践。当用户编写单元测试、Mock 依赖、提高测试覆盖率或进行测试驱动开发时使用。

319

worker-module-architecture

TencentBlueKing

Worker 构建执行器模块架构指南,涵盖插件执行引擎、任务分发、日志上报、制品上传、Worker 生命周期。当用户开发 Worker 功能、实现插件执行、处理任务分发或优化执行器性能时使用。

37

Search skills

Search the agent skills registry