Imported from TencentBlueKing/bk-ci (ai/skills/repository-module-architecture/SKILL.md). Install upstream with npx skills add TencentBlueKing/bk-ci --skill repository-module-architecture. Copyright stays with the author.

Repository 模块架构

Name: repository-module-architecture
Author: TencentBlueKing

适用场景

接入或管理代码库
处理仓库认证、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

# after Install: the listing is in your workspace's routing pool - a plan picks it for its slot curl -s -X POST https://api.opensmartroute.ai/api/v1/route -H 'Authorization: Bearer $OSR_API_KEY' -H 'Content-Type: application/json' -d '{"text": "...", "plan": true}'

{ "ocm": "1", "id": "tencentblueking-bk-ci-repository-module-architecture", "kind": "skill", "name": "repository-module-architecture", "description": "处理 BK-CI 代码库接入、代码库授权、Webhook、SCM 集成、PAC 开关与仓库类型差异时使用。当用户提到 Git/SVN/GitHub/TGit、Webhook、仓库认证、PAC 代码库或提交记录时优先使用。", "publisher": "TencentBlueKing", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "处理 BK-CI 代码库接入、代码库授权、Webhook、SCM 集成、PAC 开关与仓库类型差异时使用。当用户提到 Git/SVN/GitHub/TGit、Webhook、仓库认证、PAC 代码库或提交记录时优先使用。" ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/TencentBlueKing/bk-ci", "path": "ai/skills/repository-module-architecture/SKILL.md", "ref": "5ba84234587e0fc54678ba748d1d4176030ce6ce", "url": "https://github.com/TencentBlueKing/bk-ci/blob/5ba84234587e0fc54678ba748d1d4176030ce6ce/ai/skills/repository-module-architecture/SKILL.md", "key": "TencentBlueKing/bk-ci/ai/skills/repository-module-architecture/SKILL.md" } }, "instructions": "# Repository 模块架构\n\n## 适用场景\n\n- 接入或管理代码库\n- 处理仓库认证、OAuth、SSH、Token\n- 配置或排查 Webhook\n- 处理 PAC 代码库与提交记录\n- 判断某种代码库类型应该落在哪套服务实现\n\n## 不适用场景\n\n- 只是普通 Git 命令使用问题\n- 只是 PAC 的 YAML 转换问题，不涉及代码库接入\n- 只是权限模型定义，不涉及仓库资源本身\n\n## 快速指导\n\n1. 先判断问题属于哪条主线：\n - 仓库基础与类型差异：看 `reference/1-repository-foundation.md`\n - Webhook、PAC、认证与排查：看 `reference/2-webhook-pac-auth.md`\n2. Repository 模块的核心不是“执行 Git 操作”，而是“管理仓库资源、认证方式、Webhook 和平台接入语义”。\n3. 只要改仓库类型、认证逻辑或 PAC 开关，就要同时看仓库明细表、认证方式和 Webhook 行为。\n4. PAC 问题如果已经进入 YAML 解析或模板展开层，接下来切到 `yaml-pipeline-transfer`。\n\n## 高信号规则\n\n- `Repository` 负责仓库资源接入与管理，不负责流水线模型本身\n- 不同仓库类型在认证、字段和 API 能力上都不完全一致", "cost": { "context_tokens": 242 } }

repository-module-architecture

About

Repository 模块架构

适用场景

不适用场景

快速指导

高信号规则

关键陷阱

延伸阅读

Use it

Manifest

Reviews