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.zipInstalls 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 代码库或提交记录时优先使用。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
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 转换问题,不涉及代码库接入
- 只是权限模型定义,不涉及仓库资源本身
快速指导
- 先判断问题属于哪条主线:
- 仓库基础与类型差异:看
reference/1-repository-foundation.md - Webhook、PAC、认证与排查:看
reference/2-webhook-pac-auth.md
- 仓库基础与类型差异:看
- Repository 模块的核心不是“执行 Git 操作”,而是“管理仓库资源、认证方式、Webhook 和平台接入语义”。
- 只要改仓库类型、认证逻辑或 PAC 开关,就要同时看仓库明细表、认证方式和 Webhook 行为。
- 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.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| repository-module-architecture (this skill) | 1 | 3mo | No flags | Intermediate |
| glab | 6 | 3mo | Review | Intermediate |
| azure-devops-cli | 4 | 5mo | Review | Beginner |
| gitlab-ci-patterns | 10 | 3mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by TencentBlueKing
View all by TencentBlueKing →You might also like
glab
NikiforovAll
Expert guidance for using the GitLab CLI (glab) to manage GitLab issues, merge requests, CI/CD pipelines, repositories, and other GitLab operations from the command line. Use this skill when the user needs to interact with GitLab resources or perform GitLab workflows.
azure-devops-cli
github
Manage Azure DevOps resources via CLI including projects, repos, pipelines, builds, pull requests, work items, artifacts, and service endpoints. Use when working with Azure DevOps, az commands, devops automation, CI/CD, or when user mentions Azure DevOps CLI.
gitlab-ci-patterns
wshobson
Build GitLab CI/CD pipelines with multi-stage workflows, caching, and distributed runners for scalable automation. Use when implementing GitLab CI/CD, optimizing pipeline performance, or setting up automated testing and deployment.
update-go-version
grafana
Update Go version across the Tempo codebase (go.mod, tools/go.mod, Dockerfile, CI workflows, tools image tag)
agent-ops-cicd-github
ruvnet
Agent skill for ops-cicd-github - invoke with $agent-ops-cicd-github
aios-devops
automacoescomerciaisintegradas
GitHub Repository Manager & DevOps Specialist (Gage). Use for repository operations, version management, CI/CD, quality gates, and GitHub push operations. ONLY agent authorized...