SuperAPI AI 工具集

repository-module-architecture

通用与其它

查看项目

更新于 10-16 06:52

技能介绍

用途:该技能面向 BK-CI 的 Repository 模块架构,核心不是执行 Git 操作,而是管理仓库资源、认证方式、Webhook 与平台接入语义。适用于接入或管理代码库、处理仓库认证(OAuth、SSH、Token)、配置或排查 Webhook、处理 PAC 代码库与提交记录,以及判断某种代码库类型应落在哪套服务实现。

主要能力与用法:先判断问题属于哪条主线。仓库基础与类型差异参考 reference/1-repository-foundation.md;Webhook、PAC、认证与排查参考 reference/2-webhook-pac-auth.md。若改动仓库类型、认证逻辑或 PAC 开关,需同时查看仓库明细表、认证方式和 Webhook 行为。PAC 问题若已进入 YAML 解析或模板展开层,应切换到 yaml-pipeline-transfer;涉及项目语义时参考 project-module-architecture。

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

限制与不适用场景:普通 Git 命令使用问题、仅涉及 PAC 的 YAML 转换而不涉及代码库接入、仅权限模型定义而不涉及仓库资源本身,均不适用。关键陷阱包括把代码库类型差异当成统一逻辑硬处理、只看主表不看各仓库类型明细表、把 Webhook 问题误判为仓库保存问题或反之、以及 PAC 开关开启就默认一切 YAML 与触发都能工作。具体实现细节与命令暂未提供。